SyncCurseCraft

模组

· 作者 El_this_boy

通过 Minecraft 的正常端口,保持你的模组文件夹与服务器列表同步。

0 本站下载 0 关注 更新于 3 个月前

最新 0.1.2 · 1.21.1 · NeoForge

一键开服(送7天)

SyncCurseCraft

你的玩家的模组文件夹,始终与服务器保持一致。无需额外端口、无需 Web 服务器、无需启动器。

你在服务器上添加了一个模组。你的朋友连接后被踢出,因为版本不匹配,于是你在聊天框中粘贴了下载链接,但有人还是安装了错误的版本。SyncCurseCraft 消除了这一整套流程:服务器发布其模组列表,客户端将其与 /mods/ 进行比较,一个按钮即可修复差异。


为什么它在其他工具失效的地方能起作用

所有内容都通过正常的 Minecraft 端口传输。没有第二个 HTTP 服务器,也不需要打开第二个端口。

如果你租用服务器,这一点很重要。BisectHosting、Aternos 或 Shockbyte 等主机只提供 25565 端口,没有其他端口,这排除了所有期望通过 HTTP 提供文件的同步工具。SyncCurseCraft 借助于 Server List Ping(服务器列表响应)——也就是你的客户端已经读取以显示 MOTD 和玩家数量的相同响应。你的玩家在连接前就能看到模组列表,无需加入服务器,也无需登录。

.jar 文件本身直接来自 Modrinth 或 CurseForge CDN。你的服务器从不上传任何模组文件,因此一个 400 MB 的整合包对它来说完全不消耗带宽。


对于玩家

  1. 启动游戏。在主菜单和服务列表的左上角有一个 Sync mods(同步模组) 按钮。绿色圆点表示服务器的列表已更改。
  2. 输入服务器地址,按 Check server(检查服务器)。
  3. 选择你的配置:
    • Low PC(低配电脑) — 仅包含服务器所需的模组。
    • High PC(高配电脑) — 所需模组加上客户端附加模组:光影、小地图、环境音效等,由管理员放置在此处。
  4. 点击 Sync now(立即同步),然后 Quit to apply(退出以应用)。
  5. 重新启动游戏。完成。

在任何操作发生之前,你总是能看到将要安装和移除的完整列表,如果列表过长,它会滚动显示。

对于管理员

服务器会在 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源