本指南涵盖了使用 tModLoader 在您的 Terraria 服务器上安装和管理 Mod，包括切换到 tModLoader、上传 .tmod 文件以及配置 Mod 列表。有关基本服务器配置和连接方法，请参阅 Terraria 服务器设置指南。
什么是 tModLoader？
tModLoader 是一个 Mod 平台，作为独立的可执行文件与原版 Terraria 并行运行（或替代运行）。Legion Hosting 支持将 tModLoader 作为可选择的服务器版本。当 tModLoader 激活后，您可以从 mods/ 目录安装和运行 Mod。
切换到 tModLoader
- 登录 GPanel。
- 停止您的服务器。
- 导航到 Startup 或 Configuration 部分。
- 将服务器版本或可执行文件更改为 tModLoader。
- 保存设置并重启服务器。
.wld），但 tModLoader 世界可能包含嵌入的 Mod 内容。在原版 Terraria 中加载 tModLoader 世界（或反之）可能导致数据丢失或损坏。请为每个版本保留单独的世界文件。
切换回原版
要切换回原版 Terraria，请重复上述步骤并选择标准 Terraria 服务器版本。切换过程中不会删除任何世界文件，但请确保 serverconfig.txt 指向兼容原版的世界。
安装 Mod
tModLoader 的 Mod 使用 .tmod 文件格式，放置在服务器的 mods/ 目录中。服务器必须运行 tModLoader 才能加载 Mod。
方法 1：直接上传 .tmod 文件
- 从 Steam Workshop 或 tModLoader 浏览器下载 Mod 的
.tmod文件。 - 通过 SFTP 连接到您的服务器 — 请参阅 如何通过 SFTP 上传文件。
- 将
.tmod文件上传到mods/目录。 - 重启服务器。tModLoader 将在启动时加载
mods/目录中找到的所有.tmod文件。
方法 2：Workshop Mod（enabled.json）
tModLoader 还支持在 mods/ 目录中使用 enabled.json 文件来列出应激活的 Mod。使用 tModLoader 的游戏内 Mod 浏览器时，此文件会自动管理，但您也可以手动编辑它。
{
"EnabledMods": [
"ModName1",
"ModName2"
]
}
enabled.json 中使用的 Mod 名称是内部 Mod 名称，而非显示名称。请查看 Mod 页面或 .tmod 文件名以获取准确的内部名称。
验证 Mod 是否已加载
重启后，在 GPanel 中查看服务器的控制台日志。tModLoader 会在启动期间列出每个已加载的 Mod。如果某个 Mod 加载失败，日志中会出现错误消息，指明原因（版本不匹配、缺少依赖项等）。
移除或禁用 Mod
要完全移除一个 Mod，请通过 SFTP 或 GPanel 文件管理器从 mods/ 目录中删除其 .tmod 文件，然后重启服务器。
要禁用一个 Mod 而不删除它，请编辑 mods/enabled.json 并从 EnabledMods 数组中移除该 Mod 的内部名称。.tmod 文件将保留在磁盘上，但在下次重启时不会被加载。
文件参考
| 路径 | 内容 |
|---|---|
mods/ |
tModLoader Mod 文件（.tmod 格式） |
mods/enabled.json |
已启用 Mod 的内部名称列表 |
相关文章
- Terraria 服务器设置指南 — 服务器配置、世界设置和连接方法
- Terraria 故障排除 — 常见问题和解决方法
- 如何通过 SFTP 上传文件
