Vintage Story 模组安装
本指南涵盖了如何在您的 Vintage Story 专用服务器上安装、管理和删除模组。有关初始服务器设置和配置，请参阅 Vintage Story 服务器设置指南。有关管理员命令和权限，请参阅 Vintage Story 管理员命令。
服务器面板：所有服务器管理都通过 GPanel 完成：gpanel.legionhosting.net。使用文件管理器或 SFTP 上传模组文件。
下载模组
Vintage Story 拥有活跃的模组社区。模组以 .zip 或 .cs 文件形式分发。
- 浏览官方模组数据库：mods.vintagestory.at。
- 找到您想要的模组，确认它与您服务器的 Vintage Story 版本兼容，并且支持服务器端使用。
- 下载模组文件（通常为
.zip文件）。
安装模组
- 从 GPanel Console 选项卡停止服务器。
- 在 GPanel 中打开 Files 选项卡，导航到服务器根目录下的
Mods/目录。 - 将模组
.zip文件直接上传到Mods/目录中。不要解压 zip 文件——Vintage Story 直接从 zip 压缩包中读取模组。 - 启动服务器。控制台输出将显示已加载的模组。检查是否有与新添加模组相关的错误。
需要客户端模组：许多 Vintage Story 模组要求玩家在客户端也安装相同的模组。如果模组添加了新的方块、物品或机制，没有安装该模组的玩家将无法加入或会遇到问题。请在玩家连接之前告知他们所需的模组。
安装前请检查版本兼容性。为某个版本的 Vintage Story 构建的模组可能在其他版本上无法工作。请始终确认模组版本与您服务器的游戏版本匹配。安装不兼容的模组可能会导致服务器无法启动。
删除模组
- 停止服务器。
- 在 GPanel 文件管理器中导航到
Mods/目录。 - 删除您要移除的模组文件。
- 启动服务器。请注意，删除添加了方块或物品的模组可能会导致世界中的这些对象消失或被替换为错误占位符。
模组服务器的版本锁定
如果您正在运行模组，强烈建议将服务器锁定到特定游戏版本，以防止自动更新破坏模组兼容性。在 GPanel 中将 RELEASE_VERSION 启动变量设置为您想要的确切版本号（例如 1.19.8），而不是 latest。有关版本管理的详细信息，请参阅 Vintage Story 服务器设置指南。
相关文章
需要帮助？
如果您遇到本指南未涵盖的问题，请提交支持工单，并附上您的服务器 IP 地址、问题描述以及 GPanel 中的相关控制台输出。
