Sync Client Server (SCS)
Sync Client Server (SCS) 是一款旨在使客户端模组和配置与服务器提供的整合包保持同步的模组,从而减少版本不匹配并简化手动模组管理。
通过多人服务器列表中直接的 游戏内更新按钮,玩家可以以简单可靠的方式下载服务器所需的模组和配置文件。
? 预览

? 目标
SCS 致力于简化服务器管理并提升玩家体验,使模组包更新变得 清晰、可预测且用户友好,无需依赖外部启动器或手动文件管理。
✨ SCS 的功能
- 多人服务器列表中的游戏内 更新按钮
- 带有更新摘要和 清除缓存 选项的确认界面
- 基于 modId 的同步,防止重复或过时的模组
- 可选的
/config 与 /mods 同步
- 可选的
/mods 和 /config 镜像模式
- 服务器强制移除特定客户端模组
- 按服务器隔离的缓存
- 内置轻量级文件服务器用于托管
mods.zip 和 config.zip
⚠️ 重要提示:
- 模组更新需要重启游戏才能生效
- 配置更新不需要重启,将立即应用
? 客户端使用方法(简单且自动)
客户端的工作流程被设计得尽可能精简。
1️⃣ 添加服务器
- 在 多人游戏 屏幕中正常添加服务器
- 下载 URL 字段会自动使用服务器地址和端口进行填充
- 如有需要,您可以手动覆盖它
示例:
http://myserver.com:25566
2️⃣ 更新客户端
- 在列表中选中服务器
- 点击 更新
- 查看摘要并确认
就这样。
仅当模组更新时才需要重启游戏。
? 清除缓存
如果出现以下情况,请使用确认界面中的 清除缓存:
- 下载失败
- 客户端不同步
- ZIP 内容已更改但未触发更新
- 其他意外行为
缓存按服务器隔离,清除是安全的。
?️ 服务器使用方法(管理员指南)
1️⃣ 安装并启动
- 在服务器上安装 SCS
- 启动服务器一次以生成配置文件
2️⃣ 常见配置
配置文件:
config/scs-common.toml
默认值:
fileServerPort = 25566
updateConfig = true
mirrorMods = false
mirrorConfig = false
说明:
fileServerPort
内置文件服务器使用的端口(默认:25566)
updateConfig
启用客户端配置更新(默认启用)
mirrorMods / mirrorConfig
默认禁用。启用后,客户端文件夹将被强制与 ZIP 文件完全匹配
由于 updateConfig 默认启用,服务器管理员可以向客户端推送新的配置更改,例如启用或禁用镜像选项。
3️⃣ 创建更新包
选项 A:使用游戏内命令
在服务器上运行:
/scs save-mods
/scs save-config
这将生成:
选项 B:手动创建 ZIP(高级 / 推荐用于控制)
管理员可以 手动创建或编辑:
这允许:
两种方法均得到完全支持。
4️⃣ 移除客户端模组(服务器强制执行)
若要强制移除特定的客户端模组:
- 创建一个名为:
modsToRemoveFromTheClient.json
- 将其放置在
mods.zip 内部
- 列出要删除的
.jar 文件名
示例:
[
"examplemod1.jar",
"examplemod2.jar"
]
这些模组将在更新期间从客户端删除。
5️⃣ 内置文件服务器
当服务器运行时,SCS 会自动托管:
地址为:
<server-ip>:fileServerPort
默认值:
<server-ip>:25566
无需外部 Web 服务器。
? 整合包使用说明
欢迎将此模组包含在您的整合包中——我们会感谢署名,但并非必须。
❤️ 致谢与分支说明
本项目是 Place-Boy 开发的模组 MMMMM 的一个 分支。
原始项目:
原始概念和基础的全部功劳归于原作者。
Sync Client Server (SCS)
Sync Client Server (SCS) is a mod designed to keep client mods and configurations synchronized with a server-provided modpack, reducing version mismatches and manual mod management.
With a single in-game Update button directly in the multiplayer server list, players can download the mods and configs required by the server in a simple and reliable way.
? Preview

? Goal
SCS aims to simplify server administration and improve player experience by making modpack updates clear, predictable, and user-friendly, without requiring external launchers or manual file management.
✨ What SCS Can Do
- In-game Update button in the multiplayer server list
- Confirmation screen with update summary and Clear cache option
- modId-based synchronization to prevent duplicated or outdated mods
- Optional synchronization of
/config alongside /mods
- Optional mirror mode for
/mods and /config
- Server-enforced removal of specific client mods
- Per-server isolated cache
- Built-in lightweight file server to host
mods.zip and config.zip
⚠️ Important:
- Mod updates require a game restart to take effect
- Config updates do NOT require a restart and are applied immediately
? Client Usage (Simple & Automatic)
The client workflow is intentionally minimal.
1️⃣ Add the server
- Add the server normally in the Multiplayer screen
- The Download URL field is automatically filled using the server address and port
- You may override it manually if needed
Example:
http://myserver.com:25566
2️⃣ Update the client
- Select the server in the list
- Click Update
- Review the summary and confirm
That’s it.
Restart the game only if mods were updated.
? Clear Cache
Use Clear cache from the confirmation screen if:
- A download fails
- The client becomes out of sync
- ZIP contents changed but no update is triggered
- Other unexpected behaviors
Cache is isolated per server and safe to clear.
?️ Server Usage (Admin Guide)
1️⃣ Install and start
- Install SCS on the server
- Start the server once to generate the config file
2️⃣ Common Configuration
Config file:
config/scs-common.toml
Default values:
fileServerPort = 25566
updateConfig = true
mirrorMods = false
mirrorConfig = false
Explanation:
fileServerPort
Port used by the built-in file server (default: 25566)
updateConfig
Enables client config updates (enabled by default)
mirrorMods / mirrorConfig
Disabled by default. When enabled, client folders are forced to exactly match the ZIP files
Because updateConfig is enabled by default, server admins can push new configuration changes to clients, such as enabling or disabling mirror options.
3️⃣ Creating the update packages
Option A: Using in-game commands
On the server, run:
/scs save-mods
/scs save-config
This generates:
Option B: Manual ZIP creation (advanced / recommended for control)
Admins may manually create or edit:
This allows:
- Shipping only specific mods or configs
- Full control over update contents
Both methods are fully supported.
4️⃣ Removing client mods (server-enforced)
To force the removal of specific client mods:
- Create a file named:
modsToRemoveFromTheClient.json
- Place it inside
mods.zip
- List the
.jar filenames to remove
Example:
[
"examplemod1.jar",
"examplemod2.jar"
]
These mods will be deleted from the client during the update.
5️⃣ Built-in File Server
When the server is running, SCS automatically hosts:
On:
<server-ip>:fileServerPort
Default:
<server-ip>:25566
No external web server is required.
? Modpack Usage
Feel free to include this mod in your modpack — credits are appreciated but not required.
❤️ Credits & Fork Notice
This project is a fork of the mod MMMMM by Place-Boy.
Original project:
All credit for the original concept and foundation goes to the original author.
评论 0
登录后参与评分
还没有评论,来抢沙发吧