このガイドでは、NeosVR 専用サーバーのヘッドレスコンソールコマンド、ワールド管理、ユーザーロール、NeosModLoader、トラブルシューティングについて説明します。NeosVR は強力な制作ツールを備えたソーシャル VR メタバースです。初期セットアップ、Config.json の設定、接続手順については、NeosVR サーバーセットアップガイドを参照してください。
1. コンソールへのアクセス
NeosVR ヘッドレスサーバーは、GPanel の Console タブから管理します。すべてのコマンドはコンソールに直接入力します。
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> | ワールドからユーザーを BAN します。 |
silence <username> | ユーザーをサイレンスします（音声をミュート）。 |
unsilence <username> | 以前にミュートしたユーザーのサイレンスを解除します。 |
respawn <username> | ワールドのスポーン地点でユーザーをリスポーンさせます。 |
role <username> <role> | ユーザーにロールを割り当てます（セクション3を参照）。 |
サーバー制御
| コマンド | 説明 |
|---|---|
status | サーバーステータスとリソース使用状況を表示します。 |
shutdown | ヘッドレスサーバーを正常にシャットダウンします。 |
gc | ガベージコレクションを強制実行してメモリを解放します。 |
tickRate <rate> | 実行時にサーバーのティックレートを変更します。 |
3. ユーザーロール
NeosVR はワールド権限のためにロール階層を使用します:
| ロール | 説明 |
|---|---|
Admin | 完全なワールド制御。あらゆるものを変更し、ユーザーを管理し、ワールド設定を変更できます。 |
Builder | ワールド内のオブジェクトを作成および編集できます。 |
Moderator | ユーザーのキック/BAN とセッション設定の管理ができます。 |
Guest | 基本的なアクセス。既存のオブジェクトと対話できますが、ビルドはできません。 |
Spectator | 閲覧のみのアクセス。ワールドと対話できません。 |
コンソール経由でロールを割り当てます: role <username> Admin
defaultUserRoles 設定を使用して、Config.json でデフォルトのロールを設定することもできます。
4. NeosModLoader
NeosModLoader を使用すると、コミュニティ製の MOD をヘッドレスサーバーに読み込むことができます。
- GPanel の Startup 変数で ENABLE_MODLOADER を
trueに設定します。 - NeosModLoader GitHub から MOD をダウンロードします。
- SFTP 経由で MOD の
.dllファイルをnml_mods/ディレクトリにアップロードします。 - サーバーを再起動して MOD を読み込みます。
MOD の互換性: すべての MOD がヘッドレスクライアントと互換性があるわけではありません。インストールする前に、各 MOD のドキュメントでヘッドレスサポートを確認してください。
5. トラブルシューティング
サーバーが起動しない
- STEAM_USER と STEAM_PASS が正しいことを確認します。
- SRCDS_BETAPASS（ヘッドレスベータパスワード）が Neos Patreon Discord から取得した最新のものであることを確認します。
- Steam Guard の2要素認証を使用している場合は、STEAM_AUTH にコードを入力し、速やかに再起動してください。
ワールドが読み込まれない
Config.jsonが有効な JSON であることを確認します（末尾のカンマがなく、ブラケットが適切）。Config/Config.jsonでloginCredentialとloginPasswordが正しく設定されていることを確認します。- ワールド URL またはプリセット名が有効であることを確認します。
ユーザーが参加できない
- 意図的でない限り、
accessLevelがPrivateに設定されていないことを確認します。 maxUsersに達していないことを確認します。- ヘッドレスがログインしていることを確認します（ログイン確認のコンソール出力を確認）。
関連記事
サポートが必要ですか？
ここに記載されていない NeosVR サーバーの問題が発生した場合は、サポートチケットを開いて、サーバー IP、問題の説明、および GPanel コンソールからの関連するエラーメッセージを含めてください。
