如何搭建 tModLoader 服务器

tModLoader 是什么，以及版本上的坑

tModLoader 是在 PC 上玩模组版 Terraria 的标准方式：它是 Steam 上一款免费的独立应用，使用自己 Steam Workshop 中的模组来运行 Terraria。tModLoader 服务器就是在服务器端做同样的事——加载模组，而每位玩家也都用 tModLoader 连接。

有两点最容易让人踩坑：

• 就多人游戏而言，它是另一款游戏。 tModLoader 玩家无法加入原版服务器，原版玩家也无法加入 tModLoader 服务器。组里的每个人都要使用 tModLoader。
• 它运行的是较旧的 Terraria。 原版 Terraria 已经是 1.4.5（2026 年 1 月的“Bigger and Boulder”更新）。tModLoader 仍基于 1.4.4，目前还没有 1.4.5 版的 tModLoader。在 1.4.5 上玩过的世界无法在 tModLoader 中打开。反过来则可以：tModLoader 世界可以在原版 1.4.5 中打开，打开时会被升级。

所以如果你想玩模组档，请在 tModLoader 中新建世界。不要把原版 1.4.5 的世界拿过去。

在家搭建 tModLoader 服务器

快捷方式：在游戏内开房

从 Steam 安装 tModLoader（免费，但你必须在 Steam 上拥有 Terraria），启用模组，然后选择 Multiplayer > Host & Play。好友通过 Steam 加入。世界运行在你的 PC 上，退出游戏时就会停止。

在 Windows 或 macOS 上运行专用服务器

1. 先在游戏里整理好模组列表。 在 Workshop 订阅模组并在 tModLoader 中启用。然后进入 Workshop > Mod Packs，选择 Save Enabled as New Mod Pack 和 Open Mod Pack Folder。这样你就得到了 install.txt（Workshop ID）和 enabled.json（启用了哪些模组）。
2. 启动服务器。 在 tModLoader 安装文件夹中（在 Steam 里：右键 tModLoader > Manage > Browse local files），Windows 上运行 start-tModLoaderServer.bat，macOS 上运行 start-tModLoaderServer.sh。
3. 回答提示： 是否使用 Steam、选择哪个世界（或新建一个）、最大玩家数、端口（默认 7777）、端口转发以及密码。
4. 开放端口。 在路由器上把 TCP 7777 转发到这台 PC，好友通过 Join via IP 使用你的公网 IP 加入。

模组和世界位于 Documents/My Games/Terraria/tModLoader/——Mods/ 存放 .tmod 文件和 enabled.json，Worlds/ 中每个世界由一个 .wld 文件加一个保存模组数据的 .twld 文件组成。请让同一个世界的两个文件始终放在一起。

在 Linux 上

tModLoader 为此自带工具，名为 DedicatedServerUtils。其文档推荐在 Docker 中运行服务器；另一种方式是 manage-tModLoaderServer.sh，它会安装 tModLoader（install-tml --github），下载 install.txt 中列出的 Workshop 模组（install-mods），并启动服务器（start）。请先把 install.txt 和 enabled.json 放进 tModLoader/Mods/，把世界放进 tModLoader/Worlds/。

原版部分——控制台、serverconfig.txt、端口转发——请参阅如何搭建 Terraria 服务器；tModLoader 接受相同的设置。

在 HytHost 上托管 tModLoader 服务器

1. 下单时选择 tModLoader。 在 Terraria 主机页面选择套餐，并将 tModLoader 选为服务器软件。如果玩 Calamity 或 Thorium，建议从 Gold (6 GB) 起步。
2. 上传模组。 在 GamePanel 文件管理器中（或通过 sFTP），把 .tmod 文件放进 mods/ 文件夹。你可以在 PC 上的 steamapps/workshop/content/1281930/ 中找到它们，每个 Workshop 项目一个文件夹。
3. 上传 enabled.json 到同一文件夹。它只是一个模组名称列表，例如 ["CalamityMod","CalamityModMusic"]；所有想要启用的模组都必须写在里面。
4. 重启服务器 并查看控制台：它会在加载时逐个列出模组，如果有模组加载失败，也会指出是哪一个。
5. 加入。 好友打开 tModLoader，选择 Join via IP，输入面板中的地址和端口。缺少的模组会在进入时从服务器下载。

已经有模组世界了？把 .wld 及其 .twld 上传到服务器的世界文件夹，或者发给我们，我们免费为你迁移。除 tModLoader 本身外不预装任何东西，因此模组版本永远是你自己选的版本。

热门模组组合及所需 RAM

模组是决定 tModLoader 服务器内存占用的主要因素。内容模组会添加物品、敌人、Boss 和世界生成，无论是否有人在用，这些都常驻内存。tModLoader 和大型模组都没有公布官方的服务器配置数据，因此下表是我们的建议，并预留了一定余量：

另外两个因素也会增加内存：世界大小（在没人加入之前，大型世界占用的内存大约是小型世界的两倍）以及分散在地图各处的玩家。作为对比，原版服务器在小型世界上空闲时远低于 1 GB。

想查看哪些模组占用大，可在 tModLoader 设置中打开 Show Mod Memory Estimates。如果服务器因 OutOfMemoryException 崩溃，就需要更多 RAM 或减少大型模组——没有任何设置能解决这个问题。

好友如何获取模组

好友不需要手动收集模组列表。tModLoader 客户端加入时，会将自己的模组与服务器的模组进行比对——名称、版本和文件——并直接从服务器下载缺少或不同的模组，然后重新加载并连接。客户端有而服务器没有的模组会在本次会话中被禁用。标记为仅服务器端的模组永远不会被发送。

每位玩家需要：

• tModLoader 本体，从 Steam 安装，且与服务器的 tModLoader 版本相同。
• 在 tModLoader 设置中保持“Download Mods From Servers”开启。 它默认开启；如果关闭，客户端会拒绝连接并列出所需的模组。
• 信任该服务器。 tModLoader 会提醒，模组可能包含代码，只应从你信任的主机下载。在你自己的服务器上，这个主机就是你。

tModLoader 服务器常见错误

"You are not using the same version as this server"

tModLoader 版本不一致——必须完全相同。Steam 会自动更新玩家的 tModLoader，所以 tModLoader 发布新版后，也要更新服务器。如果你不小心连到了同一端口上的原版服务器，也会出现同样的消息。

模组缺失或加载失败

检查该模组是否以内部名称（而非显示名称）写在 enabled.json 中，它的依赖是否也已上传并启用，以及 .tmod 文件是否与好友的版本一致。服务器日志会指出加载失败的模组。

内存不足

日志中出现 OutOfMemoryException 表示服务器在加载或运行模组时 RAM 耗尽。移除一个大型模组、使用更小的世界，或升级到更大的套餐。

世界无法打开

通常是在原版 1.4.5 上玩过的世界——tModLoader 无法打开它。也可能是 .wld 旁边缺少 .twld 文件，或世界依赖的某个模组已不再启用。

安装“64 bit”模组后游戏无法启动

旧的 "tModLoader 64 bit" Workshop 项目已经过时——当前的 tModLoader 本身就是 64 位——安装它会导致游戏无法启动。请取消订阅。