diff --git a/README.md b/README.md
index 05c3cc8..ee63268 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,32 @@
 # mc-modpack
-Packwiz modpack for Bennett's Modded Minecraft Server (Fabric 1.20.4)
+
+Packwiz modpack for **Bennett's Modded Minecraft Server** (Fabric 1.20.4).
+
+## Server-Side Auto-Sync
+
+The `minecraft-modded` Docker container auto-syncs mods from this repo at startup via the `PACKWIZ_URL` environment variable pointing to `pack.toml` on the `main` branch.
+
+## Client-Side Setup
+
+Players should install:
+
+1. **Fabric Loader** for Minecraft 1.20.4
+2. **packwiz-installer-bootstrap** as a pre-launch command in their launcher (MultiMC/Prism)
+3. Point it at: `https://gitea.bennettdavid.com/bee8333/mc-modpack/raw/branch/main/pack.toml`
+
+This will auto-download all required client mods to match the server.
+
+## Included Mods
+
+| Mod | Version | Side | Source |
+|-----|---------|------|--------|
+| Fabric API | 0.97.3+1.20.4 | Both | [Modrinth](https://modrinth.com/mod/fabric-api) |
+| WebStreamer | 1.5.0 | Both | [Modrinth](https://modrinth.com/mod/webstreamer) |
+
+## Adding Mods
+
+To add a mod, create a `.pw.toml` file in the `mods/` directory with the appropriate Modrinth metadata, then update `index.toml` and `pack.toml` hashes accordingly. If you have `packwiz` installed locally, use `packwiz modrinth install <mod-slug>` instead.
+
+## Mod Approval
+
+Only admins can push to `main`. Contributors can submit mod requests as issues or pull requests.
diff --git a/index.toml b/index.toml
new file mode 100644
index 0000000..9c0b71a
--- /dev/null
+++ b/index.toml
@@ -0,0 +1,11 @@
+hash-format = "sha256"
+
+[[files]]
+file = "mods/fabric-api.pw.toml"
+hash = "8435fe34f180c963234295c6bf8de293b3450d74f2ab74389ac9bdf198d84612"
+metafile = true
+
+[[files]]
+file = "mods/webstreamer.pw.toml"
+hash = "978cc314d07347dc2bcd23e56f93992d79ee5b89a3947d74221b758e8f685e17"
+metafile = true
diff --git a/mods/fabric-api.pw.toml b/mods/fabric-api.pw.toml
new file mode 100644
index 0000000..a3e931f
--- /dev/null
+++ b/mods/fabric-api.pw.toml
@@ -0,0 +1,13 @@
+name = "Fabric API"
+filename = "fabric-api-0.97.3+1.20.4.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/P7dR8mSH/versions/BPX6fK06/fabric-api-0.97.3%2B1.20.4.jar"
+hash-format = "sha512"
+hash = "ea1e47672a1e0fef7fa3fd7f7b396b5a8fb2c46e6ce33dbc4cc2b8d320bc7b775a0de42a478302419c8063c47fbc18bb2ad7551772f54af8059132ac2cb4f108"
+
+[update]
+[update.modrinth]
+mod-id = "P7dR8mSH"
+version = "BPX6fK06"
diff --git a/mods/webstreamer.pw.toml b/mods/webstreamer.pw.toml
new file mode 100644
index 0000000..ed29d12
--- /dev/null
+++ b/mods/webstreamer.pw.toml
@@ -0,0 +1,13 @@
+name = "WebStreamer"
+filename = "webstreamer-1.5.0.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/IdNyYbFO/versions/ondpQ8lg/webstreamer-1.5.0.jar"
+hash-format = "sha512"
+hash = "05d94aeae2e9f1beebfde98d69ab9f5732654437181a3666a142a89ca40dfbaa22a61c0e1d6605c086449ddf5eb580566876cc84fe370f98f6a60c95ae75155a"
+
+[update]
+[update.modrinth]
+mod-id = "IdNyYbFO"
+version = "ondpQ8lg"
diff --git a/pack.toml b/pack.toml
new file mode 100644
index 0000000..da03e33
--- /dev/null
+++ b/pack.toml
@@ -0,0 +1,14 @@
+[pack]
+name = "Bennett's Modded Server"
+author = "bee8333"
+version = "1.0.0"
+pack-format = "packwiz:1.1.0"
+
+[index]
+file = "index.toml"
+hash-format = "sha256"
+hash = "059360286df607e6a5ff35b8d719c0a8b5b753623f2d3dab3fb12f082c09f5cf"
+
+[versions]
+minecraft = "1.20.4"
+fabric = "0.15.11"