メインコンテンツへスキップ
見出し画像

【手順解説】Resoniteヘッドレスサーバの建て方!

    留意事項

    (2024/1/12追記)公式Wikiがオープンしました。
    ヘッドレスクライアントのページもございますので、基本的にはそちらを参照頂き、当記事はその補足としてお読みください。
    https://wiki.resonite.com/Headless_Client
    (2024/12/27追記) .NET9ランタイムが必要になったので追記しました
    (2025/05/26追記).NET10ランタイムになったのでさらに修正

    この記事の大部分はリリース直後の2023/10/7に執筆され、2024/12/27に最終更新が行われました。
    今後のアップデートで変更になる可能性が大いにあります。
    まずは最新の情報を探してください。

    ヘッドレスサーバとは?

    Resoniteが他の多くのVRSNSと異なる点として、通信方式にP2Pを採用している点があります。
    Resoniteとは?→Steamページ
    これは遅延の少なさなどのメリットがある代わりに、ユーザがResoniteクライアントを終了すると、そのユーザのセッションに居た他のユーザもセッションから蹴り出されてしまうというデメリットがあります。
    このため、ユーザの代わりに別のPCから常時セッションを立て続ける手段をResoniteは持っており、これを「ヘッドレスサーバ(Headless server)」と呼んでいます。
    3D表示などの負荷となる部分を削り、最小限の動作要件で動くため、少し古めのノートPCなどでも動作させることが可能です。
    参考までに、著者がかつてヘッドレス用PCとして使用していたマシンとしては、i3 6100Tと24GB RAMの超省スぺ―スPCで、30人規模のイベントを8時間ほど落ちることなく維持させた実績があります。→桜逢祭2023 NeosVRフロア

    前提条件

    この記事の手順通りにヘッドレスサーバを立ち上げる場合、以下の条件を満たしている必要があります。

    • ResoniteのPatreonを10$以上支援していること

    • ヘッドレス用Resoniteアカウントを所有していること

    • ヘッドレス用Steamアカウントを所有していること

    • ヘッドレス用のWindows PCを持っており、SteamでResoniteのインストールが済んでいること

    • ※重要 ヘッドレス用のWindowsPCで一度Resoniteを起動していること。初回起動時に生成されるファイルが必要なため

    • ※重要 .NET9のランタイムパッケージをインストール済であること。
      Resonite、コマンドプロンプトの最低限必要な操作が分かること

    .NET10のランタイムパッケージを入手する

    ヘッドレスクライアントでは、.NET 10.0ランタイムというパッケージの導入が必須になりました!
    以下のリンクから.NET10.0ランタイムをダウンロードし、必ずインストールしておいてください。

    https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_version=9.0.0&arch=x64&rid=win-x64&os=win10

    ダウンロードする箇所が非常にわかりづらいですが、Windowsの場合は以下の画像の箇所の「x64」を押してください。

    画像

    ダウンロード後、インストールウィザードに従ってインストールが完了したら、準備完了です。

    Steamヘッドレスクライアントを取得

    Resoniteを起動し、ダッシュメニュー>フレンドタブからユーザ「Resonite」へ以下のコマンドを入力します。
    /headlesscode
    するとコードが返ってくるのでメモります。

    画像

    ヘッドレス用マシンのSteamで、Resoniteのプロパティを開いてください。

    画像

    「ベータ」タブに移動し、「プライベートベータ」のテキストボックス内にコードを入力し、「コードを確認」を押します。

    画像

    コードが通ると、「ベータの参加」のプルダウンメニュー内にヘッドレスサーバ用クライアントが追加されるので、選択します。

    画像

    クライアントがダウンロードされ、Resoniteインストールフォルダ配下に「Headless」フォルダが作成されます。

    画像

    Configファイルを書く

    C:\Program Files (x86)\Steam\steamapps\common\Resonite\Headless\Config
    内にある「DefaultConfig.json」をコピーして、VSCodeなどのエディタで編集したのち「Config.json」として保存します。
    (C:\Program Files (x86)\Steam\steamapps\common\Resonite\Headless\Config\Config.json)にする

    最低限いじる箇所

    ヘッドレスアカウントログイン情報を以下で指定
    "loginCredential": <ヘッドレスユーザID>,
    "loginPassword": <ヘッドレスユーザパスワード>
    そして
    "loadWorldURL" : <ここに開きたいワールドのレコードURL>
    あるいは
    "loadWorldPresetName": <新規作成ワールドのテンプレ3つのうちどれか>,

    ※レコードURLとはワールド詳細画面の「レコードURLをコピー」からコピーできます。
    ※※「ワールドURL」ではないです!!!https://から始まる文字列ではありません。ご注意を!

    画像

    例えばJPチュートリアルワールドResoniteだったら、
    resrec:///G-Neos-East-Japan/R-95d04d7b-322f-47ea-a18e-0fc1f473d41e
    がレコードURLです。


    Config例

    設定解説:
    「16人制限」でかつ「誰でも(Anyone)」入れる設定で、「JPチュートリアルワールドResonite」を起動、「1時間誰もセッションに居なければワールドをリセット」する。

    {
      "$schema": "https://raw.githubusercontent.com/Yellow-Dog-Man/JSONSchemas/main/schemas/HeadlessConfig.schema.json",
      "universeId": null,
      "tickRate": 60.0,
      "maxConcurrentAssetTransfers": 80,
      "usernameOverride": null,
      "loginCredential": "akiRAM-Headless",
      "loginPassword": "*****",
      "startWorlds": [
        {
          "isEnabled": true,
          "sessionName": null,
          "customSessionId": null,
          "description": null,
          "maxUsers": 16,
          "accessLevel": "Anyone",
          "loadWorldURL": "resrec:///G-Neos-East-Japan/R-95d04d7b-322f-47ea-a18e-0fc1f473d41e",
          "loadWorldPresetName": "Grid",
          "idleRestartInterval": 3600,
          "autoSleep": true
        }
      ]
    }

    ちなみに普段の私のヘッドレスのコンフィグはだいたい以下のような感じです。
    設定解説:
    defaultUserRolesでakiRAMとMotoMaidへAdmin権限を付与している点と、ログイン後に自動でセッション参加する機能のためにcustomSessionIDでセッションIDを固定しています。

    {
      "$schema": "https://raw.githubusercontent.com/Yellow-Dog-Man/JSONSchemas/main/schemas/HeadlessConfig.schema.json",
        "loginCredential": "akiRAM-Headless",
        "loginPassword": "****",
        "tickRate": 60.0,
        "maxConcurrentAssetTransfers": 40,
        "startWorlds": [
          {
            "sessionName": "居酒屋",
            "accessLevel": "FriendsOfFriends",
            "loadWorldURL": "resrec:///U-akiRAM/R-73557ade-75f1-4d51-8fbb-c7d722da62e6",
            "customSessionId": "S-U-akiRAMHeadless:Tavern1",
            "defaultUserRoles": {
              "akiRAM": "Admin",
              "MotoMaid": "Admin"
            },
            "awayKickMinutes": 5,
            "idleRestartInterval": 64800,
            "autoSleep": true
          }
        ]
      }

    ヘッドレスの起動

    C:\Program Files (x86)\Steam\steamapps\common\Resonite\Headless
    内にある「Resonite.exe」をコマンドプロンプトから叩きます。

    画像

    起動したらこのような画面が表示されます。
    コマンドラインの最後に、薄黄色の文字でワールド名が表示されていればOKです!

    画像

    あとは、「Invite <あなたのユーザ名>」などで招待し、セッションに入れるか確認しましょう!

    コマンドリファレンスは公式Wikiを参照

    Configファイルの記法等はこちらのページ

    小ネタ・Tips

    Publishしていないワールドを立てる方法

    Publishしていないワールドは通常自分しか開くことができないですが、ワールドのメタデータから開けるアカウントを「誰でも」に設定することで、
    ヘッドレスアカウントから開くことができます。(この操作により、ヘッドレスアカウント以外のユーザからも開けるようになるため、意図せず開かれては困るワールドについてはレコードURLの取り扱いに注意しましょう)
    以下、メタデータの設定手順です。

    画像
    1. ワールドオーブを出す。
    画像
    2. オーブをクリックし、「メタデータを編集」を押す。
    画像
    3. 下のラジオボタンを「誰でも(パブリック)」に設定し、「保存」を押す。

    RHCCのススメ

    ヘッドレスを黒い画面上で、コマンドで操作するのが大変な方は、ボタンのポチポチで済む日本語のツールをいもっちさんが開発されています。
    コマンド操作に自信の無い方や、より簡単に操作したいWindowsユーザーの方は以下のツールを使うとよいかもしれません。

    MarkN Resonite Headless Controllerのご紹介

    ResoniteのヘッドレスサーバーをWebブラウザの画面から操作するためのツールもあるそうです!

    現在分かっている問題点


    今時点で判明しているバグ、あるいはバグのような挙動を以下に紹介します。

    Private状態でInviteするとヘッドレスクライアントが落ちる

    (2025/5/27追記)
    以下の事象はなんか治ったっぽいです。やったー。

    (2024/1/7追記)
    AccessLevelをPrivateに設定したのち、inviteコマンドを実行するとクライアントごと落ちる事があります。再現しない場合もあり、謎です。
    イベントの準備等で一旦Privateでセッションを立てて設営準備するなどの時に不便なのですが、
    ワークアラウンドとしてConfigにセッション起動時の自動招待のコマンドAutoinviteUsernameを設定すると正常に招待が動くため、そちらを使うか、
    あるいは、Config内で"hideFromPublicListing"をtrueにすることで、プライベートじゃないが、非公開セッションを立てるなどがあります。

    画像
    落ちている様子

    関連リンク集

    litalitaさんのヘッドレス導入記録。こちらも合わせて読んでみてね!

    RHCC(黒い画面を見なくても済むヘッドレスかんたん管理アプリ)

    MarkN Resonite Headless Controller(ブラウザから管理できるやつ)

    Resonite便利リンク集

    おわり


    この記事が参加している募集

     
     

    akiRAM

     
     
    あきらむと呼ばれる事が多いです。主にVRでモデリングしたり、ワールド作ったり、イベント主催したり、寝落ちたりしています

    あなたへのおすすめ