AutoModSync 使用教程
安装模组 · 建立仓库
AutoModSync 让整合包的更新对玩家透明：作者维护一个仓库，玩家启动游戏时自动对齐到仓库的最新状态。 本教程包含两部分 —— 安装模组、建立仓库。
01安装
1.1下载
在模组下载页下载 AutoModSync 的模组文件。一共有两个：
| 文件 | 必装 | 作用 |
|---|---|---|
| automodsync | 必装 | 模组本体。设置界面、同步界面与 /automodsync 命令。 |
| automodsync-bootstrap | 选装 | 引导器。在 Forge 扫描 mods 文件夹之前完成同步，使新下载的模组在本次启动即可加载。 |
不装引导器也能正常使用。区别在于同步会推迟到进入游戏之后执行，新下载的模组需要重启游戏才会加载。
模组将自身列入保护名单（automodsync-*.jar），改名后可能在同步时被当作多余文件删除。
另外，引导器在游戏运行期间被 Java 锁定，升级时需要手动替换。
1.2放入 mods 文件夹
将下载到的 jar 直接放入游戏目录下的 mods 文件夹，不需要解压，也不需要放进子文件夹。
官方启动器的默认路径为 %appdata%\.minecraft\mods。
1.3验证安装
启动游戏，在「模组」列表中确认存在 AutoModSync。
此时不会同步任何内容，也不会有提示。地址尚未配置，这是预期行为。
在游戏中按 T 打开聊天栏，输入 /automodsync status。返回「尚未配置 sourceUrl，跳过模组同步」即表示模组工作正常。
1.4配置地址
把仓库地址填进游戏即可完成配置。
在「模组」列表中找到 AutoModSync，点击 Config。
保存后立即执行一次同步，不需要重启游戏。
地址支持以下几种写法：
| 写法 | 说明 |
|---|---|
https://github.com/作者/仓库 |
同步整个仓库（GitHub） |
https://gitee.com/作者/仓库 |
同步整个仓库（Gitee） |
作者/仓库 |
简写，按 GitHub 处理 |
https://github.com/作者/仓库/tree/main/mods |
只同步仓库中的 mods 文件夹。浏览器地址栏的链接可直接粘贴 |
| 留空 | 不做任何同步 |
Gitee 不允许匿名下载公开仓库中大于 10MB 的文件。默认配置下模组会改用仓库压缩包获取，代价是首次同步较慢； 也可以在配置文件中填写 Gitee 私人令牌，使其像普通文件一样直接下载。
试运行只比对、不下载也不删除，会列出本次计划执行的操作。确认待下载与待删除的模组无误后再关闭。
02建立仓库
2.1创建仓库
以下三种方式都可以，选择其一即可：
| 方式 | 说明 |
|---|---|
| GitHub | 创建公开仓库即可。国内访问可能不稳定。 |
| Gitee | 创建公开仓库即可。国内访问更稳定，但限制大文件的匿名下载（见 1.4）。 |
| 自己的服务器 |
把模组文件放进网站目录，并让服务器列出该目录的文件列表
（nginx 用 autoindex on;，Apache 用 Options +Indexes）。
这种模式没有哈希校验，只能按字节数判断文件是否变更，能力弱于仓库，但不需要依赖第三方平台。
|
使用 GitHub 或 Gitee 时，有两点需要注意：
在 GitHub 或 Gitee 上新建一个仓库，名称任意，例如 my-modpack。
私有仓库的接口需要登录，模组无法读取，只会返回 404。
2.2上传模组
将需要分发的 .jar 上传到仓库。推荐全部放在仓库根目录：
.jar 都会被同步到玩家本地；pack.json 只用于显示信息也可以把所有 jar 放进子文件夹（例如 mods/），同步时会一并扫描，效果完全相同。
仓库中所有的 .jar 都会被同步到玩家侧，包括子文件夹中的文件。
测试用的、服务端专用的、旧版本的文件都会一并发出，不需要的应从仓库中移除。
模组判断本地文件是否为最新依据的是字节数。原地覆盖同名文件、且新旧大小相同时，客户端无法察觉变更。
2.3同步规则
AutoModSync 不读取清单文件。配置仓库地址后，仓库中所有 .jar 即被视为应当存在的模组：
| 情况 | 处理 |
|---|---|
| 仓库中有、玩家本地没有 | 下载到本地 |
| 玩家本地有、仓库中没有 | 删除本地文件（默认开启，可在设置中关闭） |
| 两边都有、但内容不一致 | 重新下载 |
因此需要维护的只有仓库本身：增加模组就上传文件，移除模组就删除文件。玩家不需要任何通知，下次启动会自动同步。
2.4版本说明文件
仓库中可以放一份说明文件，用于在同步界面和 /automodsync status 中显示整合包的名称、版本与更新内容。
它不参与同步判断，加不加都不影响模组能否下载。
文件名默认为 pack.json，需要与模组放在同一个目录里。
下面是一份可以直接使用的模板，点右上角下载，改好里面的内容后放进仓库即可：
五个字段的含义如下：
| 字段 | 示例 | 说明 |
|---|---|---|
name |
我的整合包 | 整合包名称 |
version |
1.2.0 | 版本号，显示在名称之后 |
minecraft |
1.20.1 | 对应的游戏版本 |
updatedAt |
2026-09-14 | 更新日期 |
changelog |
新增机械动力… | 更新日志，用 \n 表示换行 |
五个字段均可省略，格式错误也不会导致同步失败，只是对应的信息不会显示。
仓库建好后，回到1.4 配置地址把地址填进游戏，即完成全部配置。