? VTs Auto Mod Sync
永远告别“不匹配的模组频道列表”错误。
VTs Auto Mod Sync 是一款适用于 Forge 1.16.5 的服务器实用工具模组,允许客户端在加入服务器之前直接从服务器自动下载缺失或过时的模组。无论你运行的是小型 SMP 还是大型整合包服务器,此模组都能确保你的玩家始终保持最新版本,无需手动分发 zip 文件。
✨ 主要功能
自动同步:检测缺失的模组、版本不匹配以及文件损坏。
支持大型整合包:已在包含 360+ 模组的整合包(如 ATM6)中经过实战测试。
智能下载管理器:
resilient(坚韧):自动重试失败的下载(3 次尝试)。
intelligent(智能):能区分 ProjectRed-Core 和 ProjectRed-Transmission(不会意外删除相关模块)。
clean(整洁):自动移除旧版模组以防止重复。
子文件夹支持:完全支持将模组组织到子文件夹中的服务器。
防崩溃:在握手失败后拦截连接,防止游戏崩溃并提供清晰、用户友好的下载图形界面。
进度追踪:显示实时进度条和状态更新。
?️ 工作原理
加入:玩家尝试加入服务器。
检测:如果玩家缺少模组,Forge 通常会将其踢出。VTs Auto Mod Sync 会拦截这个踢出操作。
同步:出现一个列出所有缺失内容的图形界面。
下载:玩家点击“下载缺失模组”。文件直接从服务器的内部 HTTP 主机拉取。
游玩:完成后,玩家点击“关闭游戏”,重新启动并成功加入!
? 安装与设置
对于服务器所有者
将 .jar 文件放入 /mods/ 文件夹。
启动服务器。它将自动在端口 8000(默认)上启动轻量级文件服务器。
关键:你必须对 TCP 端口 8000(或在配置中选择的其他端口)进行端口转发,以便外部玩家可以访问文件服务器。
对于客户端(玩家)
将 .jar 文件放入 /mods/ 文件夹。
加入服务器!
⚙️ 配置
配置文件位于 config/vtsautomodsync-common.toml。
代码
Toml
[general]
# 用于 HTTP 文件服务器的 TCP 端口。
# 客户端和服务器必须具有相同的端口设置。
# 默认值:8000
serverPort = 8000
注意:如果你在服务器上更改了端口,则必须在整合包中包含此配置文件,以便客户端知道连接到哪个端口。
❓ 常见问题解答
问:这适用于大型整合包吗?
答:是的!它已在 360+ 模组中经过测试。它包括一个强大的重试系统,以处理大规模下载期间的网络小故障。
问:为什么下载时显示“连接被拒绝”?
答:这通常意味着服务器所有者未在路由器/防火墙上为文件服务器端口(默认:8000)进行端口转发。
问:它会删除我的其他模组吗?
答:它仅删除它正在更新的特定模组的旧版本。它使用智能身份系统来确保它永远不会删除不相关的模组(例如,mcw-bridges 绝不会删除 mcw-doors)。
问:这安全吗?
答:是的。它不会修改核心 Forge 握手代码(这会导致不稳定)。它在断开连接屏幕之上作为一个安全层来处理。
发现了一个错误?请在问题跟踪器中报告!
? VTs Auto Mod Sync
Say goodbye to "Mismatched Mod Channel List" errors forever.
VTs Auto Mod Sync is a server utility mod for Forge 1.16.5 that allows clients to automatically download missing or outdated mods directly from the server before joining. Whether you run a small SMP or a massive modpack server, this mod ensures your players are always up to date without needing to manually distribute zip files.
✨ Key Features
Automatic Synchronization: Detects missing mods, version mismatches, and file corruption.
Large Modpack Support: Battle-tested on packs with 360+ mods (e.g., ATM6).
Smart Download Manager:
Resilient: Retries failed downloads automatically (3 attempts).
Intelligent: Knows the difference between ProjectRed-Core and ProjectRed-Transmission (won't accidentally delete related modules).
Clean: Removes old versions of mods automatically to prevent duplicates.
Subfolder Support: Fully supports servers that organize mods into subfolders.
Crash-Proof: Intercepts the connection after the handshake fails, preventing game crashes and providing a clean, user-friendly download GUI.
Progress Tracking: Shows real-time progress bars and status updates.
?️ How It Works
Join: The player attempts to join the server.
Detect: If the player is missing mods, Forge usually kicks them. VTs Auto Mod Sync intercepts this kick.
Sync: A GUI appears listing exactly what is missing.
Download: The player clicks "Download Missing Mods". The files are pulled directly from the server's internal HTTP host.
Play: Once finished, the player clicks "Close Game", restarts, and joins successfully!
? Installation & Setup
For the Server Owner
Drop the .jar into your /mods/ folder.
Start the server. It will automatically start a lightweight file server on Port 8000 (default).
CRITICAL: You must Port Forward TCP Port 8000 (or whichever port you choose in the config) so external players can reach the file server.
For the Client (Player)
Drop the .jar into your /mods/ folder.
Join the server!
⚙️ Configuration
The config file can be found at config/vtsautomodsync-common.toml.
code
Toml
[general]
# The TCP Port used for the HTTP File Server.
# Client and Server must have the same port setting.
# Default: 8000
serverPort = 8000
Note: If you change the port on the server, you must include this config file in your modpack so clients know which port to connect to.
❓ FAQ
Q: Does this work with huge modpacks?
A: Yes! It has been tested with 360+ mods. It includes a robust retry system to handle network hiccups during mass downloads.
Q: Why does it say "Connection Refused" when downloading?
A: This usually means the server owner has not port-forwarded the file server port (Default: 8000) on their router/firewall.
Q: Does it delete my other mods?
A: It only deletes old versions of the specific mods it is updating. It uses a smart identity system to ensure it never deletes unrelated mods (e.g., mcw-bridges will never delete mcw-doors).
Q: Is this safe?
A: Yes. It does not modify the core Forge handshake code (which causes instability). It sits on top as a safe layer to handle the disconnect screen.
Found a bug? Please report it on the issue tracker!
评论 0
登录后参与评分
还没有评论,来抢沙发吧