本指南涵盖了您在 Legion Hosting 上的 Soulmask 专用服务器的管理员设置、游戏内管理员命令、RCON 配置和服务器管理命令。有关服务器设置和配置，请参阅 Soulmask 服务器设置指南。
服务器面板：所有服务器管理均通过 GPanel 完成，地址为 gpanel.legionhosting.net。使用文件管理器或 SFTP 编辑配置文件。
设置管理员权限
Soulmask 使用基于密码的管理员系统。要成为管理员，您需要在服务器启动配置中设置管理员密码，然后在游戏内进行身份验证。
步骤 1：设置管理员密码
- 在 GPanel 中，选择您的 Soulmask 服务器。
- 点击 Startup 选项卡。
- 将
ADMIN_PASSWORD变量设置为一个强且唯一的密码。此变量对应-adminpsw命令行参数。 - 重启服务器以使更改生效。
请妥善保管您的管理员密码。任何知道管理员密码的人都可以在您的服务器上获得完整的 GM 权限。仅与可信任的共同管理员分享。
步骤 2：在游戏内进行身份验证
- 以玩家身份加入您的 Soulmask 服务器。
- 按 `（反引号/波浪号）键或 Numpad -（小键盘减号）打开游戏内控制台。
- 输入以下命令并按回车键：
gm key YOUR_ADMIN_PASSWORD - 如果密码正确，您将看到确认消息并获得 GM（游戏管理员）管理员权限。
- 您也可以点击 GM 面板界面中出现的 "Become the admin" 按钮。
基于会话的身份验证。每次加入服务器时都必须重新进行身份验证。管理员状态不会在会话之间保存——您每次登录都需要运行
gm key。
游戏内管理员命令
以管理员身份验证后，打开控制台（` 或 Numpad -）并输入命令。所有管理员命令以 gm 前缀开头。
玩家管理
| 命令 | 描述 |
|---|---|
gm AddExp [value] |
为您的角色添加通用经验值。 |
gm Addmjexp [value] |
为您的角色添加面具经验（提升面具等级）。 |
gm Addshoulieexp [value] |
为您的角色添加狩猎经验。 |
gm XiDian |
重置您角色的所有技能点，允许重新分配。 |
gm FuHuo |
复活您的角色（死亡时使用）。 |
gm ZiSha 1 |
杀死您自己的角色（自杀命令）。 |
gm shanhao |
从服务器删除您的账户/角色。请极其谨慎使用——此操作不可逆。 |
gm ShowInfo 1 |
显示您自己角色的详细信息（属性、ID、位置）。 |
gm ShowInfo 0 |
显示当前选中的角色或 NPC 的详细信息。 |
gm ChongZhiRenWu |
重置您角色的所有教程和引导任务。 |
导航和可见性
| 命令 | 描述 |
|---|---|
gm Go [x] [y] [z] |
传送到指定的世界坐标。先使用 GPS 查找您当前的坐标。 |
GPS |
显示您当前的世界坐标（X、Y、Z）。可用于确定传送目标。 |
gm SetAttr YinShen 1 |
启用隐身。怪物和 NPC 无法发现您。 |
gm SetAttr YinShen 0 |
关闭隐身。恢复正常可见状态。 |
gm ShowMap |
揭示整个地图，解锁您角色的所有战争迷雾。 |
NPC 和世界控制
| 命令 | 描述 |
|---|---|
gm ZhaoMu |
立即将目标 NPC 招募到您的部落。 |
gm ClearAllNpc |
移除服务器上所有非玩家 NPC。请谨慎使用——此操作影响全服所有 NPC。 |
gm ClearSelect |
移除当前选中/目标的实体（NPC、生物或物体）。 |
gm ShuaXinZhiBei |
刷新并重新生长附近所有植被和可采集植物。 |
gm KeJiShu |
解锁您角色的所有科技树节点。 |
入侵和热度管理
| 命令 | 描述 |
|---|---|
gm ShowReDu |
显示当前入侵热度图表，展示不同区域的威胁等级。 |
gm ClearAllReDu |
清除地图上所有入侵热度，将威胁等级重置为零。 |
gm AddReDu [value] |
手动增加指定数量的入侵热度。热度越高，吸引的入侵越多。 |
服务器和调试
| 命令 | 描述 |
|---|---|
gm exit |
安全关闭服务器并保存。这是从游戏内停止服务器最安全的方式。 |
Debuginfo 1 |
启用服务器性能监控叠加层，显示 tick 速率、实体数量和资源使用情况。 |
Debuginfo 0 |
关闭服务器性能监控叠加层。 |
请谨慎使用命令。管理员命令可能会严重影响服务器稳定性和玩家体验。大量生成实体、全服清除 NPC 或快速修改世界数据可能导致卡顿或崩溃。请先在低人数时段测试命令。
服务器管理命令
这些命令用于全服管理，可以在游戏内（通过控制台）和远程（通过 RCON/Telnet）执行。
服务器控制
| 命令 | 描述 |
|---|---|
SaveWorld |
强制立即将世界保存到内存（并可选保存到磁盘）。在执行高风险操作前使用。 |
SaveAndExit [seconds] |
保存世界并在指定秒数后关闭服务器。玩家将收到倒计时警告。 |
StopCloseServer |
取消由 SaveAndExit 发起的待执行关闭。 |
shutdown [seconds] |
以指定的倒计时秒数启动安全关闭服务器。 |
broadcast [message] |
向所有已连接的玩家发送全局消息。适用于公告和警告。 |
玩家管理（远程）
| 命令 | 描述 |
|---|---|
List_AllPlayers |
列出服务器上所有已注册的玩家账户（在线和离线）。 |
List_OnlinePlayers |
列出当前所有已连接的玩家及其 Steam ID 和角色名。 |
List_Guilds |
列出服务器上所有部落（公会）及其成员数量。 |
kick [PlayerName] |
通过角色名踢出玩家。 |
ban [PlayerName] |
封禁玩家。被封禁的玩家将无法重新连接。 |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
通过 Steam ID 直接向指定玩家的背包添加物品。 |
GotoPosition [SteamID] [x] [y] [z] |
将指定玩家传送到世界坐标。 |
FlyMode [SteamID] [0/1] |
为玩家启用（1）或禁用（0）幽灵/飞行模式。 |
服务器信息
| 命令 | 描述 |
|---|---|
ServerFPS |
显示当前服务器 tick 速率（FPS）。健康的服务器应保持 30+ FPS。 |
Show_Coefficient_Settings |
列出 GameXishu.json 中所有当前的游戏系数设置。 |
Set_Coefficient [key] [value] |
在运行时修改游戏系数，无需编辑文件。更改立即生效。 |
List_AllTalent [level] |
查看指定等级可用的所有天赋（天资）。 |
调试和高级功能
| 命令 | 描述 |
|---|---|
Dump_AllActorPositions |
将所有 Actor 位置导出到数据文件，用于调试世界状态。 |
DrawActorImage |
在地图上生成 Actor 位置的可视化图像。 |
ExecScriptCommands [filename] |
运行命令批处理文件。适用于一次执行多个命令。 |
RCON 访问
RCON（远程控制台）允许您在不连接游戏的情况下远程执行服务器命令。Soulmask 支持 RCON 和 Telnet 进行远程管理。
启用 RCON
RCON 默认禁用，必须通过启动参数启用：
- 在 GPanel 中，转到 Startup 选项卡。
- 添加以下参数（通过附加启动参数或 联系支持 请求添加）：
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - 重启服务器。
RCON 安全性。Soulmask 的 RCON 实现使用 IP 白名单进行安全控制。只有白名单中的 IP 地址才能连接到 RCON 服务。如需添加您的 IP，请查看服务器文档或配置文件中的白名单位置。
通过 RCON 连接
启用 RCON 后，您可以使用任何标准 RCON 客户端进行连接：
- 下载 RCON 客户端，例如 rcon-cli 或 GUI 工具如 mcrcon。
- 使用以下信息连接到您的服务器：
- 主机：您的服务器 IP 地址
- 端口：RCON 端口（默认
19000） - 密码：您通过
-rconpsw设置的 RCON 密码
- 连接后，输入
help查看可用命令列表。
Telnet 访问
Soulmask 还支持通过 Echo Port（默认 18888）进行基于 Telnet 的管理。Telnet 默认仅限本地连接，不需要额外的端口转发。这主要用于服务器机器上的脚本化管理。
RCON 会话示例
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServer正确关闭服务器
有几种安全的方法可以关闭 Soulmask 服务器。请始终使用以下方法之一以防止数据丢失：
- GPanel Stop 按钮：最简单的方法。在 GPanel 的 Console 选项卡中点击 Stop。
- 游戏内命令：以管理员身份验证后运行
gm exit保存并关闭。 - RCON/Telnet：运行
shutdown [seconds]或SaveAndExit [seconds]进行倒计时关闭，给玩家准备时间。
避免强制终止服务器。使用 GPanel 的 Kill 按钮或强制终止进程将跳过保存步骤。自上次自动磁盘备份以来的所有进度都将丢失。仅在服务器完全无响应时才使用 Kill 作为最后手段。
服务器管理员提示
- 设置自动备份。使用
-initbackup和-backupinterval=30创建定期备份快照。 - 监控服务器 FPS。定期使用
ServerFPS命令。如果 tick 速率低于 15-20 FPS，说明服务器运行吃力，可能需要优化或重启。 - 使用
Set_Coefficient进行实时调整。您可以在运行时调整游戏设置而无需重启服务器。先运行Show_Coefficient_Settings查看当前值。 - 安排定期重启。每天重启服务器以清除内存泄漏并应用任何待处理的更新。
- 维护前进行广播。在服务器重启或维护窗口之前，始终使用
broadcast命令警告玩家。 - 在高风险操作前使用
SaveWorld。在进行清除 NPC 或修改系数等重大更改之前强制保存。
相关文章
需要帮助？
如果您需要有关 Soulmask 管理员命令或服务器管理的进一步帮助，请 提交工单，我们的团队将竭诚为您服务。
