Soulmask 服务器设置指南

本指南涵盖了在 Legion Hosting 上设置和配置 Soulmask 专用服务器所需的一切内容，包括首次启动、GPanel 启动变量、服务器配置、PvE 与 PvP 模式、地图和世界设置、连接服务器以及存档管理。有关管理员设置和游戏内命令，请参阅 Soulmask 管理员命令。

什么是 Soulmask

Soulmask 是一款开放世界生存制作游戏，玩家在苏醒时戴着一副神秘的古代面具，该面具赋予超自然能力。在一个郁郁葱葱的广阔世界中，玩家必须收集资源、制作工具和武器、建造定居点，以及招募和管理 NPC 部落。面具系统是游戏的核心——玩家可以附身和控制不同的部落成员，每个成员都有独特的技能和特性，以优化定居点和战斗效率。

专用服务器的主要特性包括：

单服务器最多支持 70 名并发玩家
PvE 和 PvP 游戏模式，规则可配置
通过 GameXishu.json 配置文件进行丰富的游戏调节
部落（公会）系统，可配置成员上限
支持 RCON 和 Telnet 远程服务器管理
自动备份和存档管理

编辑配置文件前请先停止服务器。在编辑配置文件之前，始终从 GPanel 的 Console 选项卡停止服务器。在服务器运行时所做的更改可能会被覆盖或导致损坏。

首次启动

当您首次从 Legion Hosting 收到 Soulmask 服务器时，它需要完成初始安装才能使用。

登录 GPanel 并从服务器列表中选择您的 Soulmask 服务器。
点击 Console 选项卡并按 Start。
服务器将通过 Steam 下载并安装 Soulmask 专用服务器文件。由于游戏需要大量磁盘空间，初始下载可能需要几分钟。
下载完成后，服务器将自动启动。首次启动比后续启动耗时更长，因为服务器需要生成初始世界数据库。
等待控制台输出显示服务器已就绪并正在监听连接。

RAM 要求。Soulmask 是一款内存密集型游戏。专用服务器至少需要 11 GB 的可用 RAM 才能启动。请确保您的托管方案为预期的玩家数量提供足够的内存。更多的玩家和更大的世界将使用更多 RAM。

GPanel 启动变量

核心服务器设置通过 GPanel 中的启动变量进行配置。这些值在服务器启动时作为命令行参数传递给服务器进程。

在 GPanel 中，选择您的 Soulmask 服务器。
点击 Startup 选项卡。
设置下面列出的变量。更改将在下次启动或重启服务器时生效。

变量	默认值	描述
`SERVER_NAME`	`My Soulmask Server`	在 Steam 服务器浏览器和游戏内服务器列表中显示的名称。请使用描述性名称，以便玩家轻松找到您的服务器。
`SERVER_PASSWORD`	（空）	玩家加入所需的密码（`-PSW` 参数）。留空表示公开服务器。设置密码可限制仅受邀玩家访问。
`ADMIN_PASSWORD`	（空）	GM 管理员密码（`-adminpsw` 参数）。访问游戏内管理面板和运行管理员命令所必需。请妥善保管。
`MAX_PLAYERS`	`60`	最大同时在线玩家数（`-MaxPlayers` 参数）。Soulmask 最多支持 70 名玩家，但更多玩家需要更多 RAM 和 CPU。
`GAME_MODE`	`pve`	服务器游戏模式。设置为 `pve` 表示 PvE 模式，设置为 `pvp` 表示 PvP 模式。请参阅下方的 PvE 与 PvP 部分。
`GAME_PORT`	`8777`	游戏连接的主要 UDP 端口（`-Port` 参数）。由托管方案自动配置。
`QUERY_PORT`	`27015`	Steam 服务器浏览器查询使用的 UDP 端口（`-QueryPort` 参数）。自动配置。

启动变量优先于配置文件。如果同一设置同时在启动变量和配置文件中进行了配置，启动变量优先。请使用启动变量设置核心身份设置，使用配置文件进行详细的游戏调节。

服务器配置（命令行参数）

Soulmask 使用丰富的命令行参数进行服务器配置。以下是所有可用参数的完整参考：

参数	默认值	描述
`-SteamServerName="Name"`	-	服务器在服务器浏览器中显示的名称。
`-MaxPlayers=N`	`60`	最大并发玩家连接数（最多 70）。
`-PSW="password"`	（无）	服务器加入密码。留空表示公开服务器。
`-adminpsw="password"`	（无）	游戏内管理员命令的管理员/GM 密码。
`-pve`	-	强制 PvE 模式。玩家之间不能互相伤害。
`-pvp`	-	强制 PvP 模式。玩家之间可以互相伤害。
`-Port=N`	`8777`	游戏连接端口（UDP）。
`-QueryPort=N`	`27015`	Steam 查询端口（UDP）。
`-EchoPort=N`	`18888`	Telnet 控制台端口（TCP，仅限本地）。用于本地远程管理。
`-saving=N`	-	世界状态保存到内存的间隔（秒）。
`-backup=N`	-	内存数据库备份到磁盘的间隔（秒）。
`-initbackup`	-	每次服务器启动时创建世界备份副本。
`-backupinterval=N`	-	自动备份创建间隔（分钟）。
`-GongHuiMaxMember=N`	-	每个部落（公会）的最大成员数。
`-MULTIHOME=IP`	-	将服务器绑定到特定的本地 IP 地址（仅限多宿主服务器）。
`-rconpsw="password"`	（无）	使用指定密码启用 RCON 远程控制台访问。
`-rconport=N`	`19000`	RCON 监听 TCP 端口。仅在启用 RCON 时相关。
`-rconaddr=IP`	-	RCON 监听 IP 绑定。使用 `0.0.0.0` 监听所有接口。
`-log`	-	启用控制台窗口和日志输出。
`-UTF8Output`	-	启用非拉丁字符的正确处理。

GPanel 自动处理大部分设置。在 Legion Hosting 上，基本参数通过 GPanel 的 Startup 选项卡配置。高级参数（如 RCON 设置或部落限制）可以通过 GPanel 的附加启动参数字段添加（如果可用），或联系支持。

PvE 与 PvP 模式

Soulmask 支持两种主要的游戏模式，它们从根本上改变了多人游戏体验：

PvE 模式（`-pve`）

玩家之间不能直接互相伤害。
建筑和基地受到保护，不会被其他玩家破坏。
专注于合作生存、建造和探索。
玩家仍然可以互动、交易和组建部落。
推荐用于合作社区和休闲服务器。

PvP 模式（`-pvp`）

玩家可以互相攻击和击杀。
基地和建筑可以被其他玩家突袭和摧毁。
部落战争和领地控制成为核心游戏元素。
PvP 伤害比率可以在 GameXishu.json 配置文件中进行微调。
推荐用于竞技服务器和有经验的玩家。

不重置无法更改模式。在世界创建后切换 PvE 和 PvP 可能会导致游戏不一致。建议在首次启动前决定模式。如果需要在现有世界上更改模式，请考虑重新开始。

地图和世界设置（GameXishu.json）

详细的世界和游戏设置通过 GameXishu.json 配置文件控制。该文件包含丰富的选项，用于调节资源倍率、战斗、入侵、建造、动物等。

文件位置

配置文件位于：

WS/Saved/GameplaySettings/GameXishu.json

通过 GPanel 的 Files 选项卡或 SFTP 访问此文件。

关键设置参考

以下是最常调整的设置。参数名称保留原始格式（中文拼音）。每个参数均提供英文描述。

经验和成长

设置	英文名称	描述
`ExpRatio`	Experience Ratio	通用经验获取倍率。值越高升级越快。
`ChengZhangExpRatio`	Growth Experience Ratio	角色成长经验获取倍率。
`ShaGuaiExpRatio`	Monster Kill Experience Ratio	击杀怪物获得经验的倍率。

战斗和伤害

设置	英文名称	描述
`DongWuDamageRatio`	Animal Damage Ratio	野生动物和生物造成伤害的倍率。
`BeDamageByYeShengRatio`	Damage Taken from Wildlife	受到野生生物伤害的倍率。
`ShengMingHuiFuRatio`	Health Recovery Ratio	自然生命恢复速度倍率。
`QiXiHuiFuRatio`	Stamina Recovery Ratio	体力恢复速度倍率。
`TiLiHuiFuRatio`	Energy Recovery Ratio	精力/耐力恢复速度倍率。
`PVP_ShangHaiRatio_JinZhan`	PvP Melee Damage Ratio	PvP 近战伤害倍率（默认：`0.4`）。

资源和消耗

设置	英文名称	描述
`ShiWuXiaoHaoRatio`	Food Consumption Ratio	食物消耗速度倍率。值越低消耗越慢。
`ShuiXiaoHaoRatio`	Water Consumption Ratio	水的消耗速度倍率。
`RanLiaoXiaoHaoRatio`	Fuel Consumption Ratio	制作台和火堆的燃料消耗速度倍率。

动物和农牧

设置	英文名称	描述
`DongWuShengZhangRatio`	Animal Growth Ratio	动物生长速度倍率。值越高动物成熟越快。
`FanZhiJianGeRatio`	Breeding Interval Ratio	动物繁殖周期之间的时间倍率。
`DongWuChanChuRatio`	Animal Production Ratio	动物产出倍率（蛋、奶等）。
`DongWuPinZhiRatio`	Animal Quality Ratio	驯养动物属性品质倍率。
`ZuoWuShengZhangRatio`	Crop Growth Ratio	作物生长速度倍率。
`ZuoWuFeiLiaoXiaoHaoRatio`	Crop Fertilizer Consumption	肥料消耗速度倍率。

建筑和建造

设置	英文名称	描述
`JianZhuFuLanKaiGuan`	Building Decay Toggle	启用或禁用建筑随时间腐朽。设置为 `0` 可禁用。
`JianZhuFuLanMul`	Building Decay Multiplier	建筑腐朽速率。值越低腐朽越慢。
`JianZhuXiuLiMul`	Building Repair Multiplier	建筑修复费用和速度倍率。
`JianZhuZiYuanJinShuaBanJing`	Building Resource Exclusion Radius	建筑周围自然资源不会重新生成的半径。

入侵系统

设置	英文名称	默认值	描述
`RuQinGuaiCountMax`	Max Invasion Monsters	`128`	入侵波次中怪物的最大数量。
`RuQinQiangDuXiShu`	Invasion Intensity	-	控制总体入侵难度和怪物强度。
`RuQinBeginHour`	Invasion Start Hour	-	入侵可以开始的游戏内时间。
`RuQinEndHour`	Invasion End Hour	-	入侵停止的游戏内时间。
`RuQinPerBoGuaiMax`	Max Monsters Per Wave	`16`	每波生成的最大怪物数量。

编辑 GameXishu.json 前请先停止服务器。在服务器运行时编辑该文件会导致您的更改在服务器保存时被覆盖。请先停止服务器，进行更改，然后重新启动。

如何连接

玩家可以通过游戏内服务器浏览器或直接连接方式连接到您的 Soulmask 服务器。

通过游戏内服务器浏览器

启动 Soulmask。
从主菜单选择 Multiplayer，然后选择 Server Browser。
按服务器名称搜索（您在 SERVER_NAME 启动变量中设置的名称）。
点击您的服务器并按 Join。如果设置了密码，请输入密码。

通过 Steam 服务器浏览器

在 Steam 中，转到 View > Game Servers（或 Servers）。
点击 Favorites 选项卡，然后点击 Add a Server。
输入您的服务器 IP 和查询端口（默认 27015），格式为 IP:PORT。
服务器出现后，双击它即可通过 Soulmask 连接。

通过直接连接

从 GPanel 的 Console 选项卡查找您的服务器 IP 和游戏端口。如需帮助，请参阅如何查找您的服务器 IP 和端口。
在 Soulmask 中，找到多人游戏菜单中的 Direct Connect 选项。
输入您的服务器 IP 和游戏端口（默认 8777），格式为 IP:PORT。
按 Connect 并在需要时输入服务器密码。

服务器未显示？如果您的服务器未出现在浏览器中，请确保它已完全启动并完成加载。新服务器可能需要 2-5 分钟才能出现在 Steam 主服务器列表中。您始终可以使用 IP 和游戏端口进行直接连接。除非您拥有私有 IP，否则端口是随机分配的。

存档管理

Soulmask 使用基于数据库的存档系统。了解存档的工作方式对于避免数据丢失至关重要。

存档位置

主要世界存档文件位于：

WS/Saved/Worlds/Dedicated/Level01_Main/world.db

此 SQLite 数据库包含所有世界数据，包括地形修改、建筑、NPC 状态和玩家数据。

存档过程

Soulmask 使用两阶段存档过程：

内存保存（-saving）：世界状态按 -saving 参数指定的间隔（秒）定期写入内存数据库。
磁盘备份（-backup）：内存数据库按 -backup 参数指定的间隔（秒）刷新到磁盘。

请务必正确关闭服务器。使用 GPanel 的 Stop 按钮、游戏内的 gm exit 命令或 RCON 的 shutdown 命令来正确关闭服务器至关重要。强制终止服务器进程可能导致内存数据库未写入磁盘，从而回滚到上次的磁盘存档。

自动备份

使用以下启动参数配置自动备份：

-initbackup -- 每次服务器启动时创建备份副本。
-backupinterval=N -- 运行时每 N 分钟创建滚动备份。

手动备份

要创建手动备份：

从 GPanel 停止服务器。
通过 GPanel 的 Files 选项卡或 SFTP 导航到 WS/Saved/。
下载以下文件：
- Worlds/Dedicated/Level01_Main/world.db -- 世界存档数据库
- GameplaySettings/GameXishu.json -- 您的游戏配置
将这些文件安全存储在您的本地计算机上。

恢复备份

停止服务器。
将备份的 world.db 文件上传到 WS/Saved/Worlds/Dedicated/Level01_Main/。
如果您还想恢复设置，请将备份的 GameXishu.json 上传到 WS/Saved/GameplaySettings/。
启动服务器。

开始新世界

要清除世界并重新开始：

停止服务器。
重命名或删除 WS/Saved/Worlds/Dedicated/Level01_Main/ 中的 world.db 文件。
启动服务器。它将从零开始生成新的世界数据库。

重置前请先备份。在删除世界数据之前，请下载 world.db 的副本作为备份，以便日后需要时恢复。

端口参考

Soulmask 使用以下端口。这些端口由您在 Legion Hosting 上的托管方案自动配置。

端口	协议	默认值	用途
Game Port	UDP	`8777`	主要游戏连接。玩家连接到此端口。
Query Port	UDP	`27015`	Steam 服务器浏览器查询。
Echo Port (Telnet)	TCP	`18888`	本地 Telnet 管理（仅限本地连接）。
RCON Port	TCP	`19000`	远程控制台（RCON）访问。仅在设置了 `-rconpsw` 时激活。

需要帮助？

如果您的 Soulmask 服务器仍然存在问题，请提交工单，我们的团队将竭诚为您服务。

Soulmask 服务器设置指南 - 知識庫

技术支持

分类