diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e510ea7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# 服务器客户端整合包
+
+本仓库提供两种下载方式：
+
+## 方式一：Modrinth Launcher（推荐）
+
+1. 下载 `modpack/modrinth.index.json`
+2. 在 Modrinth Launcher 中选择 "导入" → 选择该文件
+3. 自动下载所有 mod
+
+## 方式二：直接下载文件夹
+
+1. 下载 `truemods/` 文件夹内的所有文件
+2. 下载 `truegunpacks/` 文件夹内的所有文件
+3. 将下载的文件复制到 `.minecraft/mods/` 目录
+
+## 版本
+
+当前版本：`0.0.12`
+
+---
+
+## 目录说明
+
+| 文件夹 | 说明 |
+|--------|------|
+| `truemods/` | 服务器必需 mod（66个） |
+| `truegunpacks/` | TACZ 枪包（6个） |
+| `modpack/modrinth.index.json` | Modrinth 索引文件 |
+
+## 已知排除的客户端 mod
+
+以下 mod 已从同步列表中移除（服务器不需要）：
+- Xaero 小地图 / 世界地图
+- 苹果皮 (AppleSkin)
+- 自然音效 (Ambient Sounds)
+- 一键背包整理 (Inventory Profiles)
+- 创世神 (WorldEdit)
+- Chunky 地图渲染
+- 帕秋莉手册 (Patchouli)
+- Spark 性能分析
+- 万用皮肤补丁 (CustomSkinLoader)
+- 击杀图标 (KD-Icons)
+
+## 反馈问题
+
+如遇 mod 版本不匹配导致无法进入服务器，请联系管理员更新。