本指南涵盖无头控制台命令、会话管理、模组加载器设置以及 Resonite 服务器的故障排除。有关初始设置，请参阅 Resonite 无头服务器设置指南。

1. 无头控制台命令

Resonite 无头服务器通过 GPanel 控制台接受命令。服务器响应 shutdown 命令以进行优雅关闭。

2. 访问级别

使用 accessLevel 设置控制谁可以加入您的世界会话：

3. 用户角色

分配角色以控制用户在您的世界中可以执行的操作：

在 Config.json 中使用 defaultUserRoles 设置默认角色，或使用 role 控制台命令为每个用户分配角色。

4. 多世界

无头服务器可以同时托管多个世界。在 Headless/Config/Config.json 的 startWorlds 数组中添加额外条目：

"startWorlds": [
  {
    "isEnabled": true,
    "sessionName": "World 1",
    "maxUsers": 16,
    "accessLevel": "Anyone",
    "loadWorldPresetName": "SpaceWorld"
  },
  {
    "isEnabled": true,
    "sessionName": "World 2",
    "maxUsers": 8,
    "accessLevel": "Contacts",
    "loadWorldPresetName": "Grid"
  }
]

在控制台中使用 focus 0 和 focus 1 在世界之间切换。

5. 模组加载器

Resonite 通过 ResoniteModLoader 支持模组。启用方法：

1. 在 Startup 选项卡中将 ENABLE_MODLOADER 设为 true。
2. 重新安装或重启服务器 -- 模组加载器 DLL 文件将自动下载。
3. 通过 SFTP 将模组 DLL 文件放入 rml_mods/ 目录。
4. 重启服务器以加载模组。

模组加载器文件：

• Libraries/ResoniteModLoader.dll -- 主模组加载器。
• rml_libs/0Harmony.dll -- 必需的依赖项。
• rml_mods/ -- 将您的模组 DLL 文件放在这里。

6. 故障排除

• 服务器无法启动： 验证 Config.json 中的登录凭据是否正确。无头服务器必须使用有效的 Resonite 账户进行身份验证。
• 世界未在浏览器中显示： 检查 hideFromPublicListing 是否未设为 true。确保 accessLevel 允许搜索的用户访问。
• 未显示 "World running..."： 检查控制台中的错误信息。世界预设名称可能不正确。
• 模组未加载： 验证 ENABLE_MODLOADER 设为 true 且模组 DLL 文件在 rml_mods/ 中。检查控制台中的模组加载器错误。
• 资源使用过高： 降低 Config.json 中的 tickRate 或减少 maxConcurrentAssetTransfers。用户创建的复杂内容可能会消耗大量资源。

相关文章

• Resonite 无头服务器设置指南
• 如何查找您的服务器 IP 和端口
• 如何通过 SFTP 上传文件

需要帮助？

如果您需要进一步的帮助，请 提交支持工单，并附上您的服务器详细信息和 GPanel 控制台中的任何错误信息。