このガイドでは、Legion Hosting でホストされている Resonite ヘッドレスサーバーのセットアップと設定方法について説明します。Resonite は、ユーザーが作成したワールド内で構築、創造、交流できるソーシャル VR プラットフォームです。セッション管理と管理者コマンドについては、Resonite サーバー管理者ガイドを参照してください。
1. サーバーへのアクセス
- GPanel にログインします。
- サーバー一覧から Resonite サーバーを選択します。
- サーバーは GPanel のコンソールタブと Resonite ヘッドレス設定を通じて管理されます。
注意: プライベート IP をお持ちでない限り、ポートはランダムに割り当てられます。Resonite ヘッドレスサーバーは接続に主に JSON 設定ファイルとセッションブラウザを使用しますが、割り当てられたポートはネットワーク通信に依然として使用されます。
2. 起動変数
これらの設定は GPanel の起動タブから構成します:
| 変数 | 環境変数名 | デフォルト | 説明 |
|---|---|---|---|
| Mod ローダーを有効化 | ENABLE_MODLOADER |
false | カスタム mod 用の ResoniteModLoader を有効にします（true/false）。 |
| 自動更新 | AUTO_UPDATE |
1 | 起動時にサーバーを自動的に更新します（1=はい、0=いいえ）。 |
重要: Resonite ヘッドレスには、ヘッドレスアクセス付きの Patreon サブスクリプションが必要です。インストールにはベータパスワード（ゲーム内で
/headlessCode を使って Resonite ボットにメッセージを送ることで取得）が必要です。これはホスティングプロバイダーによって設定されます。
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 | AFK ユーザーがキックされるまでの分数（-1 = 無効）。 |
idleRestartInterval | -1.0 | 空の状態がこの秒数続いた後にワールドを再起動します（-1 = 無効）。 |
forcedRestartInterval | -1.0 | ユーザーに関係なくこの秒数後に強制的に再起動します（-1 = 無効）。 |
6. サーバーへの接続
- PC または VR ヘッドセットで Resonite を起動します。
- セッションブラウザ（Dash メニュー > Worlds）を開きます。
- セッション名でサーバーを検索します。
- Join をクリックしてワールドに入ります。
プライベートセッションの場合、ヘッドレスアカウントがユーザーを招待するか、設定で autoInviteUsernames を使用する必要があります。
7. 初回セットアップのチェックリスト
Headless/Config/Config.jsonを編集して、Resonite アカウントのloginCredentialとloginPasswordを設定します。- ワールドの
sessionNameを設定します。 loadWorldPresetNameを選択するか、カスタムワールド用のloadWorldURLを指定します。- 参加できるユーザーを制御するために
accessLevelを設定します。 - サーバーを起動し、コンソールに
World running...と表示されることを確認します。
関連記事
サポートが必要ですか？
Resonite サーバーで問題が発生した場合は、サポートチケットを開いて、サーバーの詳細、問題の説明、GPanel コンソールのエラーメッセージを記載してください。
