本指南涵盖 CryoFall 专用服务器的管理员设置、控制台命令、模组支持、玩家管理、服务器重置和故障排除。CryoFall 是一款设定在危险外星星球上的科幻殖民生存游戏，具有科技树、农业、制作和 PvP/PvE 玩法。有关初始服务器设置、配置和连接说明，请参阅 CryoFall 服务器设置指南。
1. 管理员设置
CryoFall 使用服务器操作员模型，通过配置文件而非游戏内命令授予管理员权限。
添加服务器操作员
要授予服务器上的玩家管理员访问权限：
- 从 GPanel 停止服务器。
- 通过 Files 选项卡或 SFTP 打开
Data/目录中的操作员列表文件。 - 将玩家的 CryoFall 账户名称或 ID 添加到操作员列表中。
- 保存文件并重启服务器。
服务器操作员可以使用管理员工具，包括在游戏中踢出、封禁和管理世界的能力。
提示： 仅向受信任的玩家授予操作员访问权限。操作员对服务器世界拥有完全控制权，可以进行不可逆的更改。
2. 控制台命令
CryoFall 提供可通过 GPanel 控制台和游戏内（操作员）访问的控制台命令。以下是服务器管理的关键命令。
| 命令 | 描述 |
|---|---|
/player.kick <name> |
将玩家踢出服务器。 |
/player.ban <name> |
永久封禁玩家。 |
/player.unban <name> |
将玩家从封禁列表中移除。 |
/player.list |
列出所有当前连接的玩家。 |
/world.save |
触发立即世界存档。 |
/server.shutdown |
启动带存档的优雅服务器关闭。 |
/admin.add <name> |
授予玩家操作员（管理员）状态。 |
/admin.remove <name> |
撤销玩家的操作员状态。 |
/admin.list |
列出所有当前服务器操作员。 |
命令区分大小写。 请严格按照所示格式输入命令。某些命令可能仅在 GPanel 控制台中有效，而非游戏内。
3. 模组支持 (ModsConfig.xml)
CryoFall 支持服务器端模组，可以修改玩法、添加内容或改变服务器行为。
安装模组
- 从 GPanel 停止服务器。
- 从 CryoFall 模组社区或 Steam Workshop 下载所需的模组。
- 通过 SFTP 将模组文件上传到服务器的
Mods/目录。请参阅 如何通过 SFTP 上传文件 获取说明。 - 编辑
Data/目录中的ModsConfig.xml文件以注册模组。 - 启动服务器。检查控制台确认模组已成功加载。
ModsConfig.xml 格式
<ModsConfig>
<Mods>
<Mod>ModFolderName1</Mod>
<Mod>ModFolderName2</Mod>
</Mods>
</ModsConfig>每个 <Mod> 条目对应 Mods/ 目录中的一个文件夹名称。加载顺序遵循 XML 文件中的列出顺序。
模组兼容性： 并非所有模组都与每个 CryoFall 版本兼容。游戏更新后，请检查您的模组是否已更新以匹配。不兼容的模组可能导致崩溃或世界损坏。添加或更新模组前请务必备份您的
Data/ 目录。
4. 玩家管理
踢出和封禁
- 使用
/player.kick <name>立即移除破坏性玩家。 - 使用
/player.ban <name>永久阻止玩家重新连接。 - 使用
/player.unban <name>解除封禁。 - 封禁列表在服务器重启后持续有效。
密码保护
对于私人服务器，在 ServerSettings.yml 中启用密码保护：
IsPasswordProtected: true
ServerPassword: "YourSecretPassword"仅与受信任的玩家分享密码。更改密码设置后重启服务器。
5. 服务器重置
PvP 服务器通常受益于定期重置，以重置经济并给所有玩家一个全新的起点。
执行完全重置
- 从 GPanel 停止服务器。
- 通过 SFTP 备份
Data/目录（以备日后恢复）。 - 从
Data/目录中删除世界存档文件。如果要保留设置，请保留ServerSettings.yml和ModsConfig.xml等配置文件。 - 启动服务器。将使用您现有的配置生成新世界。
重置是不可逆的。 所有玩家进度、建筑、领地声明和资源都将丢失。重置前请务必下载备份以备需要恢复。
计划性重置
对于定期重置，建立时间表并告知您的玩家：
- 常见的时间表为每周一次（竞技 PvP）或每两周一次（平衡型）。
- 在服务器描述或社区 Discord 中公告重置日期。
- 在低活跃时段执行重置以最小化中断。
6. 故障排除
服务器启动时崩溃
- 检查 GPanel 控制台的错误信息。常见原因包括 YAML 语法格式错误（缩进不正确、缺少冒号或使用制表符而非空格）。
- 如果最近添加了模组，尝试从
ModsConfig.xml中移除它们以确定是否是模组导致的崩溃。 - 删除
ServerSettings.yml并重启以使用默认值重新生成配置。 - 如果崩溃持续，提交工单，附上您的服务器 IP 和完整的控制台输出。
玩家无法连接
- 在 GPanel 中验证服务器正在运行，并检查控制台是否有错误。
- 确认玩家使用的是 GPanel Network 选项卡中正确的 IP 和端口。
- 如果启用了密码保护，检查服务器密码是否正确。
- 确保服务器和客户端运行的 CryoFall 版本相同。
- 如果运行了模组，确认玩家已安装所需的客户端模组。
模组相关崩溃
- 逐一移除最近添加的模组以识别有问题的模组。
- 检查模组与当前 CryoFall 版本的兼容性。
- 确保
ModsConfig.xml文件具有有效的 XML 语法，模组文件夹名称无拼写错误。 - 如果世界损坏，从安装模组前的备份恢复。
性能问题
- 如果服务器在多名玩家同时在线时出现困难，请减少
MaxPlayers。 - 大量的玩家建筑和领地声明会随时间影响性能。计划性重置有助于解决此问题。
- 检查已安装的模组是否存在已知的性能问题。
- 如果性能仍然不佳，联系支持了解升级服务器方案。
相关文章
需要帮助？
如果您遇到本文未涵盖的 CryoFall 服务器问题，请 提交工单，附上您的服务器 IP、问题描述以及 GPanel 控制台中的相关错误信息。
