SyncCurseCraft
你的玩家的模组文件夹,始终与服务器保持一致。无需额外端口、无需 Web 服务器、无需启动器。
你在服务器上添加了一个模组。你的朋友连接后被踢出,因为版本不匹配,于是你在聊天框中粘贴了下载链接,但有人还是安装了错误的版本。SyncCurseCraft 消除了这一整套流程:服务器发布其模组列表,客户端将其与 /mods/ 进行比较,一个按钮即可修复差异。
为什么它在其他工具失效的地方能起作用
所有内容都通过正常的 Minecraft 端口传输。没有第二个 HTTP 服务器,也不需要打开第二个端口。
如果你租用服务器,这一点很重要。BisectHosting、Aternos 或 Shockbyte 等主机只提供 25565 端口,没有其他端口,这排除了所有期望通过 HTTP 提供文件的同步工具。SyncCurseCraft 借助于 Server List Ping(服务器列表响应)——也就是你的客户端已经读取以显示 MOTD 和玩家数量的相同响应。你的玩家在连接前就能看到模组列表,无需加入服务器,也无需登录。
.jar 文件本身直接来自 Modrinth 或 CurseForge CDN。你的服务器从不上传任何模组文件,因此一个 400 MB 的整合包对它来说完全不消耗带宽。
对于玩家
- 启动游戏。在主菜单和服务列表的左上角有一个 Sync mods(同步模组) 按钮。绿色圆点表示服务器的列表已更改。
- 输入服务器地址,按 Check server(检查服务器)。
- 选择你的配置:
- Low PC(低配电脑) — 仅包含服务器所需的模组。
- High PC(高配电脑) — 所需模组加上客户端附加模组:光影、小地图、环境音效等,由管理员放置在此处。
- 点击 Sync now(立即同步),然后 Quit to apply(退出以应用)。
- 重新启动游戏。完成。
在任何操作发生之前,你总是能看到将要安装和移除的完整列表,如果列表过长,它会滚动显示。
对于管理员
服务器会在 config/synccursecraft/packs/ 下创建两个文件夹:
LowPC/ 必需模组,每个玩家都会获得这些
HighPC/ 完整的 High PC 配置;此处存在而 LowPC 中没有的内容
将成为可选的客户端模组
将你的 .jar 文件放入其中并重启,或者运行 /scc generate。每个文件都通过指纹在 CurseForge 上进行标识,并且会自动生成清单,包含模组 ID、哈希值、大小和下载 URL。你的文件永远不会被移动或删除 —— 这些文件夹归你所有。
/scc generate 从打包文件夹重建清单
/scc reload 重新加载清单而无需重启
/scc status 显示正在公告的内容以及任何警告
它还会为你验证打包内容。如果一个模组需要依赖项而你忘记了,控制台会在生成时指出,而不是让你的玩家通过崩溃来发现。
它绝不会触碰的内容
这是整个模组围绕构建的规则,且不可协商:
仅限 /mods/ 内的 .jar 文件,且仅限它自己安装的。
你的 config/ 文件夹、options.txt、键位绑定、光影包、资源包、存档以及你自己安装的任何模组都完全不受影响。只有一个例外,且在发生前会显示在屏幕上:如果你拥有服务器所要求模组的不同版本,该版本将被移除 —— 游戏不会在加载两个相同模组的不同版本的情况下启动。
安全性
- 下载仅限于硬编码的白名单:Modrinth 或
.forgecdn.net。无论清单声称什么,无法访问任何其他主机。
- 在安装之前,每个文件都通过 SHA-1 和字节大小进行验证。如果不匹配,则丢弃该文件,不留痕迹。
- 文件名针对路径遍历进行了验证。
- 下载首先存放在暂存文件夹中,仅在下次重启时才移入
/mods/,因此半完成的同步永远不会导致游戏损坏。
- 你的 CurseForge API 密钥保留在服务器上。它故意不存储在 NeoForge 服务器配置中,因为这些配置会同步到每个连接的客户端。
性能
每次下载、哈希计算和磁盘写入都在渲染线程之外运行。游戏在同步过程中不会冻结。
安装
客户端 — 两个 jar 文件放入 .minecraft/mods:
| 文件 |
说明 |
synccursecraft-<version>.jar |
模组本体 |
synccursecraft-bootstrap-<version>.jar |
早期引导服务 |
你需要两者。它们分开分发是因为 NeoForge 不允许一个 jar 文件同时作为早期引导服务和模组 —— 如果服务在主 jar 内部,模组根本无法加载。如果你通过 CurseForge 应用程序安装,第二个文件会作为依赖项自动附带。
如果没有 bootstrap jar,模组仍然可以运行,但它只能_添加_模组,而不能更新或移除已加载的模组。如果缺少该文件,同步屏幕会发出警告。
服务器 — 仅将 synccursecraft-<version>.jar 放入服务器的 mods 文件夹。
要求
Minecraft 1.21.1 · NeoForge 21.1.x · Java 21
无需其他模组。无需外部库,未嵌入任何代码。
已知限制
某些模组需要另一个模组,但未在任何地方声明 —— 既不在其元数据中,也不在 Modrinth API 中。Iris 和 Sodium 是已知的情况:如果你的打包使用 Iris,请手动将 Sodium 添加到你的打包文件夹中。没有任何自动检查能捕捉到这种情况。
SyncCurseCraft 无法更新自身。出于安全原因,拒绝将其自身的 jar 文件放入打包文件夹中,并在控制台中发出警告。当新版本发布时,告诉你的玩家替换这两个 jar 文件。
许可证:CC BY-NC-SA 4.0 · by el_this_boy
SyncCurseCraft
Your players' mods folder, always matching the server's. No extra ports, no web server, no launcher.
You add a mod to your server. Your friends connect and get kicked for a mismatch, so you paste a download link in the chat, and someone installs the wrong version anyway. SyncCurseCraft removes that whole conversation: the server publishes its mod list, the client compares it against /mods/, and one button fixes the difference.
Why it works where other tools don't
Everything travels over the normal Minecraft port. There is no second HTTP server and no second port to open.
That matters if you rent a server. Hosts like BisectHosting, Aternos or Shockbyte give you port 25565 and nothing else, which rules out every sync tool that expects to serve files over HTTP. SyncCurseCraft rides along with the Server List Ping — the same response your client already reads to show the MOTD and the player count. Your players see the mod list before connecting, without joining and without a login.
The .jar files themselves come straight from the Moddrinth or CurseForge CDNs. Your server never uploads a single mod file, so a 400 MB pack costs it no bandwidth at all.
For players
- Start the game. There is a Sync mods button at the top left of the main menu and the server list. A green dot means the server's list changed.
- Type the server address, press Check server.
- Pick your profile:
- Low PC — only the mods the server requires.
- High PC — the required mods plus the client-side extras: shaders, minimap, ambient sound, whatever your admin put there.
- Sync now, then Quit to apply.
- Open the game again. Done.
You always see the full list of what will be installed and what will be removed before anything happens, and the list scrolls if it is long.
For admins
The server creates config/synccursecraft/packs/ with two folders:
LowPC/ required mods, every player gets them
HighPC/ the full High PC profile; anything here and not in LowPC
becomes an optional client-side mod
Drop your .jar files in and restart, or run /scc generate. Each file is identified on CurseForge by fingerprint, and the manifest is written for you with mod id, hash, size and download URL. Your files are never moved or deleted — those folders are yours.
/scc generate rebuild the manifest from the pack folders
/scc reload reload the manifest without restarting
/scc status show what is being announced, plus any warnings
It also validates the pack for you. If a mod needs a dependency you forgot, the console says so at generation time instead of your players finding out by crashing.
What it will never touch
This is the rule the whole mod is built around, and it is not negotiable:
Only .jar files inside /mods/, and only the ones it installed itself.
Your config/ folder, options.txt, keybinds, shader packs, resource packs, saves and any mod you installed yourself are all left completely alone. There is exactly one exception, and it is shown on screen before it happens: if you have a different version of a mod the server requires, that one is removed — the game will not start with two versions of the same mod loaded.
Security
- Downloads are restricted to a hard-coded allowlist: Moddrinth or
.forgecdn.net and No other host is reachable, whatever a manifest claims.
- Every file is verified by SHA-1 and byte size before it is installed. A mismatch and it is discarded, leaving nothing behind.
- File names are validated against path traversal.
- Downloads land in a staging folder and are only moved into
/mods/ on the next restart, so a half-finished sync can never leave you with a broken game.
- Your CurseForge API key stays on the server. It is deliberately not stored in a NeoForge server config, because those get synced to every client that connects.
Performance
Every download, hash and disk write runs off the render thread. The game does not freeze while it syncs.
Installation
Client — both jars in .minecraft/mods:
| File |
What it is |
synccursecraft-<version>.jar |
the mod |
synccursecraft-bootstrap-<version>.jar |
the early boot service |
You need both. They ship separately because NeoForge will not let one jar be an early boot service and a mod at the same time — with the service inside the main jar, the mod does not load at all. If you install through the CurseForge app the second one comes along automatically as a dependency.
Without the bootstrap jar the mod still runs, but it can only add mods, never update or remove ones already loaded. The sync screen warns you if it is missing.
Server — only synccursecraft-<version>.jar in the server's mods folder.
Requirements
Minecraft 1.21.1 · NeoForge 21.1.x · Java 21
No other mods required. No external libraries, nothing shaded in.
Known limits
Some mods need another mod without declaring it anywhere — not in their metadata, not in the Moddrinth API. Iris and Sodium are the known case: if your pack uses Iris, add Sodium to your pack folders by hand. No automatic check can catch that one.
SyncCurseCraft cannot update itself. Putting its own jars in the pack folders is refused on purpose, with a warning in the console. When a new version comes out, tell your players to replace both jars.
Licence: CC BY-NC-SA 4.0 · by el_this_boy
评论 0
登录后参与评分
还没有评论,来抢沙发吧