Vintage Story 服务器设置指南

本指南介绍如何设置和配置由 Legion Hosting 托管的 Vintage Story 专用服务器，包括首次启动、GPanel 变量、版本管理、服务器配置、世界设置、玩家连接和存档管理。有关模组安装，请参阅 Vintage Story 模组安装。有关管理员设置和命令，请参阅 Vintage Story 管理员命令。

开始之前：请确保您已在 GPanel 中创建了服务器。如果您需要帮助查找服务器的 IP 地址和端口，请参阅如何查找您的服务器 IP 和端口。

首次启动

当您首次从 GPanel 启动 Vintage Story 服务器时，服务器将自动从官方 Vintage Story API 下载游戏文件并生成默认世界。此初始启动可能需要几分钟时间来下载和解压文件。

登录 GPanel 并选择您的 Vintage Story 服务器。
在启动之前，查看 Startup 选项卡以确认您首选的版本分支（stable、unstable 或 pre-release）。
在 Console 选项卡上点击 Start。观察控制台输出中的进度消息，了解服务器下载和安装游戏文件的情况。
当您看到表示服务器正在监听连接的消息时，服务器即已就绪。系统会自动生成默认的 serverconfig.json 文件。

首次启动时间较长。服务器必须先下载完整的 Vintage Story 服务器软件包才能启动。后续启动将会快得多，除非您更改了版本或分支。

GPanel 启动变量

核心服务器设置通过 GPanel 中的 Startup 选项卡进行控制。在启动服务器之前，请查看并调整这些设置。

变量	默认值	描述
`SERVER_PORT`	（已分配）	玩家用于连接的游戏端口。此端口由 GPanel 自动分配——请在 Network 选项卡中查看您分配的端口。
`MAX_CLIENTS`	`16`	同时在线的最大玩家数量。最多可设置为 256。应与您的托管方案资源相匹配。
`FILES_BRANCH`	`stable`	使用哪个发布分支。选项：`stable`、`unstable` 或 `pre`。详情请参阅下方的版本管理部分。
`RELEASE_VERSION`	`latest`	要安装的特定版本。设置为 `latest` 以始终使用所选分支上的最新版本，或输入特定版本号（例如 `1.19.8`）以锁定该版本。
`OPTIONS`	（空）	启动时传递给服务器进程的附加命令行参数。除非需要特定的启动标志，否则请留空。
`SQLITE_TMPDIR`	（自动）	SQLite 用于数据库操作的临时目录。通常不需要更改。

更新启动变量后，请从 GPanel 重新启动服务器以使更改生效。

版本管理

Vintage Story 提供三个发布分支。您选择的分支通过 GPanel 中的 FILES_BRANCH 启动变量设置。

分支	值	描述
Stable	`stable`	大多数服务器推荐使用的分支。这些版本经过了全面测试，对于长期存档的世界最为可靠。
Unstable	`unstable`	包含仍在测试中的新功能和更改的测试版。可能包含错误。如果您想提前体验新内容并接受一定的不稳定性，请使用此分支。
Pre-release	`pre`	早期开发构建版本。这些是测试最少的版本，可能存在重大问题。仅推荐用于测试目的——不适用于生产服务器。

锁定特定版本

默认情况下，RELEASE_VERSION 设置为 latest，这意味着每次服务器启动时（如果有更新版本可用），将下载并安装您所选分支上的最新版本。要防止自动更新并将服务器锁定到特定版本：

前往 GPanel 中的 Startup 选项卡。
将 RELEASE_VERSION 从 latest 更改为您想要的确切版本号（例如 1.19.8）。
重新启动服务器。无论是否有更新版本发布，服务器都将仅使用锁定的版本。

模组兼容性：如果您正在运行模组，建议锁定特定版本。游戏更新可能会破坏模组兼容性，在游戏中途更新可能会导致问题。在更新之前，请检查您的模组是否支持目标版本。详情请参阅 Vintage Story 模组安装。

切换分支可能需要重置世界。在 stable 和 unstable 分支之间切换可能会引入世界格式更改。在更改分支之前，请始终备份您的世界。如果新版本与您现有的世界不兼容，您可能需要创建一个新世界。

serverconfig.json

主要的服务器配置文件是 serverconfig.json，位于服务器根目录。此文件在首次启动时自动生成。编辑前请停止服务器，编辑后重新启动以使更改生效。

从 GPanel Console 选项卡停止服务器。
打开 Files 选项卡，点击 serverconfig.json 进行编辑。
修改您需要的设置（请参阅下表）。
保存文件并启动服务器。

关键设置

设置	示例值	描述
`ServerName`	`"My Legion VS Server"`	在游戏内服务器浏览器中显示的名称。请设置一个有描述性的名称，以便玩家能找到您的服务器。
`WelcomeMessage`	`"Welcome to the server!"`	玩家加入时显示的消息。支持基本格式化。
`MaxClients`	`16`	同时在线的最大玩家数量。应与 `MAX_CLIENTS` 启动变量一致。
`Password`	`"mysecretpass"`	加入服务器所需的密码。留空字符串（`""`）表示公开服务器。
`AllowPvP`	`true`	设置为 `true` 启用玩家对战，或设置为 `false` 仅允许 PvE。
`SpawnRadius`	`50`	世界出生点周围的半径（以方块为单位），新玩家可在此范围内出生。较大的值会使玩家加入时分布更分散。
`MapSizeX`	`1024000`	世界宽度（以方块为单位）。默认值会创建一个非常大的世界。减小此值会限制玩家在东西方向上的移动距离。
`MapSizeZ`	`1024000`	世界深度（以方块为单位）。默认值会创建一个非常大的世界。减小此值会限制玩家在南北方向上的移动距离。
`WorldSeed`	`"myseed123"`	用于世界生成的种子。相同的种子会生成相同的世界。留空字符串表示使用随机种子。

serverconfig.json 中关键设置的最小示例：

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

文件必须是有效的 JSON。确保所有字符串用双引号括起来，布尔值为小写（true/false），并且对象或数组的最后一项后面没有尾随逗号。如果服务器在编辑后无法启动，请检查 JSON 语法错误。

世界配置

Vintage Story 根据 serverconfig.json 中的设置生成世界。世界生成仅在使用给定世界首次启动时发生——在世界创建后更改生成设置不会追溯更改现有地形。

世界生成设置

WorldSeed：决定地形布局、生物群落分布和资源分配。设置特定种子可与他人共享相同的世界布局，或留空以随机生成世界。
MapSizeX / MapSizeZ：控制最大可游玩区域。较小的值会创建更紧凑的世界，并可减少资源使用。到达地图边缘的玩家将无法继续向该方向移动。
WorldConfig：serverconfig.json 中的 WorldConfig 对象允许您微调世界生成参数，例如地形规模、气候模式和地质特征。这些是高级设置——默认值适用于大多数服务器。

世界生成设置在创建后即被锁定。诸如 WorldSeed、MapSizeX 和 MapSizeZ 之类的设置仅在世界首次生成时生效。要应用新的生成设置，您必须创建新世界（请参阅下方的存档管理）。

选择种子

种子可以是任何文本字符串或数字。Vintage Story 社区中的玩家会分享有趣世界布局的种子。如果您想要特定类型的地形或出生位置，可以在 Vintage Story 论坛或社区网站上搜索推荐的种子。

如何连接

玩家通过游戏内的多人游戏菜单连接到您的 Vintage Story 服务器。

直接连接

启动 Vintage Story 并从主菜单点击 Multiplayer。
点击 Direct Connect。
按以下格式输入您服务器的 IP 地址和游戏端口：
```
your.server.ip:port
```
在 GPanel 的 Network 选项卡中查看您分配的 IP 和端口。
点击 Connect。如果服务器有密码，请在提示时输入。

服务器浏览器

启动 Vintage Story 并从主菜单点击 Multiplayer。
服务器浏览器将加载公共服务器列表。使用搜索栏按名称搜索您的服务器（serverconfig.json 中的 ServerName 值）。
在列表中点击您的服务器，然后点击 Join。

服务器未出现在浏览器中？服务器浏览器可能需要几分钟才能索引新启动的服务器。请使用直接连接方式立即访问。同时确认您没有设置密码——设置了密码的服务器根据服务器设置可能不会出现在公共浏览器中。

存档管理

Vintage Story 世界数据存储在您的服务器上，并在游戏过程中自动保存。

世界数据位置

世界存档文件存储在服务器的 data/ 目录中。确切路径取决于您的世界名称。您可以通过 GPanel 的 Files 选项卡或 SFTP 访问这些文件。

备份您的世界

停止服务器以确保干净的备份（没有文件正在写入中）。
通过 SFTP 连接到您的服务器。请参阅如何通过 SFTP 上传文件获取连接说明。
将整个 data/ 目录下载到本地计算机。
将备份存储在安全的位置。建议保留多个带日期的备份，以便在需要时回滚到特定时间点。

强烈建议定期备份。世界损坏、意外破坏或模组更新失败都可能导致数据丢失。在进行任何重大更改（如更新游戏版本、添加或删除模组、更改世界设置）之前，请备份您的世界。

重置世界

要开始一个全新的世界：

从 GPanel Console 选项卡停止服务器。
如果您想保留现有世界数据，请先备份（见上文）。
在 GPanel 文件管理器中导航到 data/ 目录并删除世界存档文件。
可选择在 serverconfig.json 中更新 WorldSeed 以生成不同的世界布局。
启动服务器。系统将使用您当前的配置设置从头生成新世界。

删除世界文件是永久性的。一旦删除，除非您有备份，否则世界无法恢复。在执行世界重置之前，请务必下载备份。

需要帮助？

如果您遇到本指南未涵盖的问题，请提交支持工单，并附上您服务器的 IP 地址、问题描述以及 GPanel 中的相关控制台输出。

Vintage Story 服务器设置指南 - 知識庫

技术支持

分类

Vintage Story 服务器设置指南