本指南涵盖了 NeosVR 专用服务器的无头控制台命令、世界管理、用户角色、NeosModLoader 以及故障排除。NeosVR 是一个拥有强大创作工具的社交 VR 元宇宙。有关初始设置、Config.json 配置和连接说明，请参阅 NeosVR 服务器设置指南。
1. 访问控制台
通过 GPanel 中的 Console 标签页管理您的 NeosVR 无头服务器。所有命令直接在控制台中输入。
2. 无头控制台命令
世界管理
| 命令 | 描述 |
|---|---|
worlds | 列出所有正在运行的世界及其索引。 |
focus <world_index> | 按索引切换焦点到指定世界。 |
startWorldURL <record_url> | 从 Neos 记录 URL 启动新世界。 |
startWorldTemplate <template> | 从内置模板启动世界（例如 SpaceWorld）。 |
save | 保存当前聚焦的世界。 |
close | 关闭当前聚焦的世界。 |
restart | 重启当前聚焦的世界。 |
会话管理
| 命令 | 描述 |
|---|---|
sessionURL | 显示当前聚焦世界的会话 URL。 |
sessionID | 显示当前聚焦世界的会话 ID。 |
name <new_name> | 更改当前聚焦世界的会话名称。 |
accessLevel <level> | 更改访问级别：Anyone、RegisteredUsers、ContactsPlus、Contacts、Private。 |
maxUsers <count> | 设置会话的最大用户数。 |
hideFromListing <true/false> | 切换在公共会话浏览器中的可见性。 |
description <text> | 设置会话描述。 |
用户管理
| 命令 | 描述 |
|---|---|
users | 列出当前聚焦世界中的所有用户。 |
kick <username> | 将用户踢出世界。 |
ban <username> | 封禁用户，禁止其进入世界。 |
silence <username> | 禁言用户（静音其语音）。 |
unsilence <username> | 解除之前被禁言用户的静音。 |
respawn <username> | 将用户重生到世界的出生点。 |
role <username> <role> | 为用户分配角色（参见第 3 节）。 |
服务器控制
| 命令 | 描述 |
|---|---|
status | 显示服务器状态和资源使用情况。 |
shutdown | 优雅地关闭无头服务器。 |
gc | 强制垃圾回收以释放内存。 |
tickRate <rate> | 在运行时更改服务器刻率。 |
3. 用户角色
NeosVR 使用角色层级来管理世界权限：
| 角色 | 描述 |
|---|---|
Admin | 完全的世界控制权。可以修改任何内容、管理用户和更改世界设置。 |
Builder | 可以在世界中创建和编辑对象。 |
Moderator | 可以踢出/封禁用户并管理会话设置。 |
Guest | 基本访问权限。可以与现有对象互动但不能建造。 |
Spectator | 仅限观看。无法与世界互动。 |
通过控制台分配角色：role <username> Admin
您也可以在 Config.json 中使用 defaultUserRoles 设置来配置默认角色。
4. NeosModLoader
NeosModLoader 允许将社区制作的模组加载到无头服务器中。
- 在 GPanel Startup 变量中将 ENABLE_MODLOADER 设置为
true。 - 从 NeosModLoader GitHub 下载模组。
- 通过 SFTP 将模组
.dll文件上传到nml_mods/目录。 - 重启服务器以加载模组。
模组兼容性： 并非所有模组都与无头客户端兼容。安装前请查看每个模组的文档以确认其是否支持无头运行。
5. 故障排除
服务器无法启动
- 验证您的 STEAM_USER 和 STEAM_PASS 是否正确。
- 确保 SRCDS_BETAPASS（无头测试版密码）是从 Neos Patreon Discord 获取的最新密码。
- 如果使用 Steam Guard 2FA，请在 STEAM_AUTH 中提供验证码并及时重启。
世界无法加载
- 检查
Config.json是否为有效的 JSON（没有尾随逗号，括号正确）。 - 验证
Config/Config.json中的loginCredential和loginPassword是否设置正确。 - 确保世界 URL 或预设名称有效。
用户无法加入
- 检查
accessLevel是否未被设置为Private（除非有意为之）。 - 验证
maxUsers是否尚未达到上限。 - 确保无头服务器已登录（在控制台输出中查看登录确认信息）。
相关文章
需要帮助？
如果您在使用 NeosVR 服务器时遇到本文未涵盖的问题，请 提交工单，并附上您的服务器 IP、问题描述以及 GPanel 控制台中的相关错误信息。
