本指南涵盖如何设置和配置由 Legion Hosting 托管的 Resonite 无头服务器。Resonite 是一个社交 VR 平台，用户可以在用户生成的世界中建造、创作和社交。有关会话管理和管理员命令，请参阅 Resonite 服务器管理员指南。
1. 访问您的服务器
- 登录 GPanel。
- 从服务器列表中选择您的 Resonite 服务器。
- 您的服务器通过 GPanel 中的 Console 选项卡和 Resonite 无头配置进行管理。
注意： 除非您拥有私有 IP，否则端口是随机分配的。Resonite 无头服务器主要使用 JSON 配置文件和会话浏览器进行连接，但分配的端口仍用于网络通信。
2. 启动变量
从 GPanel 的 Startup 选项卡配置以下设置：
| 变量 | 环境变量名 | 默认值 | 描述 |
|---|---|---|---|
| 启用模组加载器 | ENABLE_MODLOADER |
false | 启用 ResoniteModLoader 以使用自定义模组（true/false）。 |
| 自动更新 | AUTO_UPDATE |
1 | 启动时自动更新服务器（1=是，0=否）。 |
重要： Resonite 无头服务器需要具有无头访问权限的 Patreon 订阅。安装需要一个测试密码（通过在游戏内向 Resonite 机器人发送
/headlessCode 获取）。此项由托管提供商配置。
3. 配置文件
主配置文件为 Headless/Config/Config.json。通过 SFTP 编辑。关键设置：
{
"tickRate": 60.0,
"maxConcurrentAssetTransfers": 4,
"loginCredential": "your_username",
"loginPassword": "your_password",
"startWorlds": [
{
"isEnabled": true,
"sessionName": "My World",
"maxUsers": 32,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld",
"autoRecover": true,
"autoSleep": true,
"saveOnExit": false
}
]
}4. Config.json 设置参考
| 设置 | 默认值 | 描述 |
|---|---|---|
tickRate | 60.0 | 服务器模拟刷新率。 |
maxConcurrentAssetTransfers | 4 | 最大同时资源下载数。 |
loginCredential | （空） | 无头服务器的 Resonite 账户用户名。 |
loginPassword | （空） | Resonite 账户密码。 |
5. 世界配置
startWorlds 数组中的每个条目定义一个世界会话。关键世界设置：
| 设置 | 默认值 | 描述 |
|---|---|---|
isEnabled | true | 此世界是否应该启动。 |
sessionName | null | 会话的显示名称。 |
maxUsers | 32 | 世界中的最大用户数。 |
accessLevel | Anyone | 谁可以加入：Anyone、RegisteredUsers、Contacts、ContactsPlus、Private。 |
loadWorldPresetName | SpaceWorld | 要加载的预设世界（例如 SpaceWorld、Grid、BasicEmpty）。 |
loadWorldURL | null | 要加载的自定义世界 URL（替代预设）。 |
autoRecover | true | 崩溃后自动恢复世界。 |
autoSleep | true | 无用户时将世界置于休眠状态。 |
saveOnExit | false | 服务器关闭时保存世界状态。 |
autosaveInterval | -1.0 | 自动保存间隔（秒）（-1 = 禁用）。 |
hideFromPublicListing | null | 从公共列表中隐藏此会话。 |
awayKickMinutes | -1.0 | 挂机用户被踢出前的分钟数（-1 = 禁用）。 |
idleRestartInterval | -1.0 | 世界为空后在此秒数后重启（-1 = 禁用）。 |
forcedRestartInterval | -1.0 | 无论是否有用户，在此秒数后强制重启（-1 = 禁用）。 |
6. 连接到您的服务器
- 在您的 PC 或 VR 头显上启动 Resonite。
- 打开 会话浏览器（Dash 菜单 > Worlds）。
- 按会话名称搜索您的服务器。
- 点击 加入 进入世界。
对于私人会话，无头账户必须邀请用户或在配置中使用 autoInviteUsernames。
7. 首次设置检查清单
- 编辑
Headless/Config/Config.json，为您的 Resonite 账户设置loginCredential和loginPassword。 - 为您的世界设置
sessionName。 - 选择
loadWorldPresetName或提供loadWorldURL以使用自定义世界。 - 设置
accessLevel以控制谁可以加入。 - 启动服务器并验证控制台显示
World running...。
相关文章
需要帮助？
如果您的 Resonite 服务器遇到问题，请 提交支持工单，并附上您的服务器详细信息、问题描述以及 GPanel 控制台中的任何错误信息。
