模组联机报错排查：版本不匹配与缺模组的对症解法

模组联机的故障九成出在「不一致」三个字上。这页按你看到的现象逐条对症，动手前先确认基本盘：所有人的 tModLoader 与模组清单是否真的完全一致（对齐方法见 模组联机入门）。

现象一：握手失败 / 直接被拒绝

典型原因：版本不匹配。 服务器和客户端的 tModLoader 版本或模组版本对不上。排查顺序：

1. 核对所有人的 tModLoader 版本号——Steam 玩家注意测试分支是否一致（见 测试分支）；
2. 核对模组列表逐项版本号，包括前置与音乐包（见 模组依赖与前置）；
3. 有任何人手动手装过模组的，替换文件版本最可能漂移，重新对齐（见 手动装模组）。

现象二：提示缺少某个模组

客户端缺装某个模组或前置。按报错给出的模组名去工坊补装即可。批量缺装时，直接用 Mods 文件夹打包互传或 模组包 一键还原，比逐个补快得多。

现象三：进服后掉线或世界加载卡死

常见于大型模组包：世界数据同步时内存或带宽吃紧。分两步：

1. 先单人复现：同一份模组清单单人开新世界，稳定则问题在联机链路，不稳定则回到模组本身排查（见 报错速查）；
2. 减模组再看：逐个禁用最近新增的模组（见 管理模组），直到定位肇事者。

现象四：服务器端崩溃

服务端崩了看服务端日志——启动脚本同目录或存档目录下的日志文件会记录最后一条异常（读法见 读崩溃日志）。模组问题导致的启动循环，用 崩溃循环自救 的 enabled.json 方法摘除坏模组。

现象五：原版朋友想进模组服

没有捷径：让他装 tModLoader 并对齐模组清单。官方明确原版与模组环境不能互通（见 模组联机入门），从安装教起即可，路线选 Steam 安装 或 手动安装。

一劳永逸的习惯

• 每次联机前群里发一遍版本号与模组数量，三十秒省一小时；
• 服务器模组清单冻结成 模组包，更新时全员同步换包；
• 世界定期备份（见 存档位置），联机世界的沉没成本最高。