このガイドでは、Resonite サーバーのヘッドレスコンソールコマンド、セッション管理、mod ローダーのセットアップ、トラブルシューティングについて説明します。初期セットアップについては、Resonite ヘッドレスサーバーセットアップガイドを参照してください。
1. ヘッドレスコンソールコマンド
Resonite ヘッドレスサーバーは GPanel コンソール経由でコマンドを受け付けます。サーバーは正常なシャットダウンのために shutdown コマンドに応答します。
| コマンド | 説明 |
|---|---|
worlds |
すべてのアクティブなワールドセッションを一覧表示します。 |
focus <world_index> |
コマンドの対象として特定のワールドにフォーカスします。 |
status |
フォーカスしているワールドのステータスを表示します。 |
users |
フォーカスしているワールドのユーザーを一覧表示します。 |
kick <username> |
フォーカスしているワールドからユーザーをキックします。 |
ban <username> |
フォーカスしているワールドからユーザーを BAN します。 |
silence <username> |
フォーカスしているワールドでユーザーをミュートします。 |
unsilence <username> |
ユーザーのミュートを解除します。 |
respawn <username> |
ユーザーをワールドの原点にリスポーンさせます。 |
role <username> <role> |
ユーザーのロールを設定します（Admin、Builder、Moderator、Guest、Spectator）。 |
name <session_name> |
フォーカスしているセッションの名前を変更します。 |
accessLevel <level> |
参加可能なユーザーを変更します（Anyone、RegisteredUsers、Contacts、ContactsPlus、Private）。 |
maxUsers <count> |
フォーカスしているワールドの最大ユーザー数を変更します。 |
save |
フォーカスしているワールドを保存します。 |
close |
フォーカスしているワールドを閉じます。 |
restart |
フォーカスしているワールドを再起動します。 |
invite <username> |
フォーカスしているワールドにユーザーを招待します。 |
message <text> |
フォーカスしているワールドにメッセージを送信します。 |
shutdown |
ヘッドレスサーバー全体を正常にシャットダウンします。 |
2. アクセスレベル
accessLevel 設定でワールドセッションに参加できるユーザーを制御します:
| レベル | 説明 |
|---|---|
| Anyone | すべての Resonite ユーザーに公開。 |
| RegisteredUsers | 登録済みの Resonite アカウントのみ。 |
| Contacts | ヘッドレスアカウントの連絡先リストのユーザーのみ。 |
| ContactsPlus | 連絡先および連絡先の連絡先。 |
| Private | 招待のみ。 |
3. ユーザーロール
ワールド内でユーザーができることを制御するためにロールを割り当てます:
| ロール | 説明 |
|---|---|
| Admin | ワールドの完全な制御。 |
| Builder | オブジェクトの構築と変更が可能。 |
| Moderator | ユーザーのキック/BAN とチャットのモデレートが可能。 |
| Guest | 標準的なユーザーアクセス。 |
| Spectator | 観察は可能だが操作は不可。 |
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. Mod ローダー
Resonite は ResoniteModLoader を通じて mod をサポートしています。有効にするには:
- 起動タブで
ENABLE_MODLOADERをtrueに設定します。 - サーバーを再インストールまたは再起動します -- mod ローダーの DLL が自動的にダウンロードされます。
- SFTP 経由で
rml_mods/ディレクトリに mod の DLL を配置します。 - サーバーを再起動して mod を読み込みます。
Mod ローダーのファイル:
Libraries/ResoniteModLoader.dll-- メインの mod ローダー。rml_libs/0Harmony.dll-- 必須の依存ファイル。rml_mods/-- ここに mod の DLL を配置します。
6. トラブルシューティング
- サーバーが起動しない:
Config.jsonのログイン認証情報が正しいことを確認してください。ヘッドレスは有効な Resonite アカウントで認証する必要があります。 - ワールドがブラウザに表示されない:
hideFromPublicListingがtrueに設定されていないか確認してください。accessLevelが検索しているユーザーを許可していることを確認してください。 - 「World running...」が表示されない: コンソールでエラーを確認してください。ワールドプリセット名が正しくない可能性があります。
- Mod が読み込まれない:
ENABLE_MODLOADERがtrueであり、mod の DLL がrml_mods/にあることを確認してください。コンソールで mod ローダーのエラーを確認してください。 - リソース使用率が高い:
Config.jsonのtickRateを下げるか、maxConcurrentAssetTransfersを下げてください。複雑なユーザー作成コンテンツはリソースを大量に消費する可能性があります。
関連記事
サポートが必要ですか？
さらにサポートが必要な場合は、サポートチケットを開いて、サーバーの詳細と GPanel コンソールのエラーメッセージを記載してください。
