如何搭建 Vintage Story 专用服务器

下载服务器并安装 .NET

1. 下载服务器：登录你在 account.vintagestory.at 的账户下载——Linux 服务器是单独的压缩包；在 Windows 上，游戏文件夹中已包含 VintagestoryServer.exe。
2. 安装正确的 .NET 运行时。Vintage Story 1.22 需要 .NET 10；1.21 使用的是 .NET 8。版本不对时服务器无法启动。
3. 先启动一次。在 Linux 上，在服务器文件夹中运行 ./server.sh start；在 Windows 上，运行 VintagestoryServer.exe。首次启动会创建数据文件夹和一个新世界。

请与玩家使用相同的版本：1.22 客户端无法加入 1.21 服务器。

serverconfig.json：重要设置

设置文件是数据文件夹中的 serverconfig.json（Windows 上为 %AppData%\VintagestoryData，Linux 上为 ~/.config/VintagestoryData）。修改在重启后生效。

运行服务器的完整命令列表见 Vintage Story 服务器命令。

1.22 中的白名单与公开列表

从 1.22 开始，新服务器默认仅限邀请：开启白名单，且不会出现在公开服务器列表中。有两种做法：

• 给朋友用的私人服务器：保留白名单，并用 /player Name whitelist on 添加每位玩家。立即生效，无需重启。
• 公开服务器：运行 /serverconfig advertise on 将其列出，运行 /serverconfig whitelistmode off 允许任何人加入——然后设置密码或留意加入的玩家。

端口与玩家加入方式

在路由器和防火墙上为 TCP 和 UDP 转发端口 42420——从 1.20 起就需要 UDP。玩家在游戏的多人游戏菜单中使用你的公网 IP 添加服务器（如果改过端口，请加上 :port）。

在家托管意味着只要有人想玩，你的电脑就必须开着，而且你的家庭 IP 对每个加入的人都可见。

添加模组

1. 查找模组：在官方数据库 mods.vintagestory.at 上查找，并确认每个模组都支持你的游戏版本。
2. 安装模组：在服务器停止时，将 zip 文件放入数据文件夹内的 Mods 文件夹——不是服务器自身的 Mods 文件夹，那个是留给基础游戏的。也可以在控制台运行 /moddb install modid。
3. 重启服务器。

玩家加入时，游戏会提示下载服务器的模组。只有标记为 server-side 或 universal 的模组会自动下载；client-side 模组需要每位玩家自行安装。

Vintage Story 服务器需要多少 RAM

官方建议为 1 GB 加每位玩家约 300 MB，推荐四个 CPU 线程。模组和远离出生点的探索会增加占用：

在 HytHost 托管 Vintage Story 服务器

1. 下单并选择版本。在 Vintage Story 托管页面选择套餐和游戏版本——最新版，或最早到 1.18.15 的任意稳定版。合适的 .NET 运行时会自动为你配置好。
2. 使用 Startup 标签页。其中包含服务器名称、名额、密码、种子、游戏风格和白名单开关。面板会在每次启动时将这些写入 serverconfig.json，所以请在这里修改，而不要用 /serverconfig——那样的修改会在下次重启时被还原。用 /player Name whitelist on 添加玩家照常有效。
3. 添加模组：将 zip 上传到 data/Mods，或在 Startup 标签页中列出 ModDB 模组 ID；这些模组会在下次重装时安装。
4. 加入：使用面板中显示的地址和端口。

你的文件位于 data 文件夹。迁移现有世界的方法见 将世界上传到游戏服务器。