Barotrauma 模组安装指南
本指南介绍如何在 Legion Hosting 托管的 Barotrauma 专用服务器上安装、管理和更新 Steam 创意工坊模组。模组可以为您的服务器添加自定义潜艇、生物、物品和游戏玩法更改。
需要基本服务器设置?请参阅 Barotrauma 专用服务器设置指南了解服务器设置、潜艇选择、战役存档和连接说明。
目录
模组在专用服务器上的工作原理
Barotrauma 支持 Steam 创意工坊模组,可用于自定义内容,包括潜艇、生物、物品和游戏玩法大修。在专用服务器上,模组不会从创意工坊自动下载。您必须手动将模组文件传输到服务器。
重要:服务器必须安装与连接客户端相同的模组。如果存在版本不匹配或缺少模组,玩家将无法加入。
安装创意工坊模组
在托管服务器上安装模组的推荐方法是先在本地电脑上下载模组,然后将文件上传到服务器。
分步安装说明
- 在您自己的电脑上,在 Steam 创意工坊中订阅该模组,并启动一次 Barotrauma 以下载它。
- 在您的电脑上找到下载的模组文件夹。创意工坊模组通常存储在:
Steam\steamapps\workshop\content\602960\<ModID>\<ModID>是模组创意工坊 URL 中的数字 ID。 - 通过 SFTP 连接到您的服务器,或在 GPanel 中打开文件管理器。
- 导航到 Barotrauma 服务器文件夹中的
LocalMods/目录。如果该目录不存在,请创建它。 - 将整个模组文件夹(以模组数字 ID 命名的文件夹)上传到
LocalMods/中。 - 按照下一节中的说明在
serversettings.xml中配置模组。 - 重启服务器使更改生效。
提示:每个模组文件夹应包含一个标识该模组的
filelist.xml 文件。如果缺少此文件,服务器将无法检测到该模组。
在 serversettings.xml 中配置模组
上传模组文件后,您需要在服务器配置中注册它们。打开 serversettings.xml 并将模组添加到已安装内容包列表中。
重要:在编辑
serversettings.xml 之前请务必停止服务器。服务器在关闭时会覆盖此文件,因此在服务器运行时所做的更改将会丢失。
请参阅模组的 filelist.xml 获取正确的内部名称。确切的配置格式取决于您的 Barotrauma 版本,但通常模组会出现在 serversettings.xml 中的 ContentPackage 条目中。
验证模组加载
在配置模组后重启服务器:
- 在 GPanel 中打开服务器控制台。
- 查找引用模组名称或 ID 的日志行。成功加载的模组将在启动过程中出现。
- 如果您看到引用该模组的
[ERROR]行,请检查所有文件是否已正确上传以及模组是否与您的服务器版本兼容。
保持模组更新
服务器不会自动拉取创意工坊更新。当模组作者推送更新时,您必须手动重新下载并重新上传更新的文件。
更新流程
- 在本地电脑上,确保您的 Steam 客户端已下载模组的最新版本(如有需要,取消订阅并重新订阅以强制重新下载)。
- 通过 SFTP 连接到您的服务器。
- 从 GPanel 停止服务器。
- 导航到
LocalMods/<ModID>/并用新下载的文件替换内容。 - 启动服务器。
告知您的玩家:所有玩家在加入之前也必须在他们的客户端上更新相同的模组。版本不匹配将阻止连接。
模组兼容性
模组冲突是服务器问题最常见的原因之一。请牢记以下准则:
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 服务器启动时崩溃 | 两个模组修改了相同的游戏内容(物品、生物等) | 禁用所有模组,然后逐一重新启用以找到冲突 |
| 玩家加入时断开连接 | 客户端-服务器模组版本不匹配 | 确保所有玩家和服务器拥有相同的模组版本 |
| 服务器日志中出现内容错误 | 缺少依赖项或模组过时 | 查看模组的创意工坊页面了解所需依赖项并进行更新 |
| 模组在单人游戏中有效但在服务器上无效 | 仅客户端模组 | 查看模组的创意工坊描述;某些模组仅限客户端,不应安装在服务器上 |
一般原则:运行的模组越少,服务器就越稳定。请逐步添加模组,并在每次添加后进行测试,而不是一次安装多个。
移除模组
- 从 GPanel 停止服务器。
- 打开
serversettings.xml并删除模组的内容包条目。 - 通过 SFTP 或 GPanel 文件管理器从
LocalMods/中删除模组文件夹。 - 启动服务器。
战役存档:如果您移除了一个在活动战役中添加了物品或内容的模组,存档可能会损坏或产生错误。在移除模组之前请备份您的战役存档。备份说明请参阅主设置指南。
相关文章
需要帮助?请在 legionhosting.net/submitticket.php 提交支持工单,并附上您的服务器名称、模组名称/ID 以及 GPanel 控制台中的任何错误信息。