← ブログ

ゲームサーバーなしで Godot のゲームをマルチプレイヤーに

· Hibira

Godot 4 向けに純粋な GDScript の Hibira アドオンを作りました。ルーム、チャット、プレイヤー位置の同期に対応し、Web エクスポートでも動きます。作った理由、仕組み、5 分で動くデモまで。

ある日、チームの誰かがこう聞きました。「Godot って Pusher プロトコルに対応してる?」

答えはノーでした。Godot 4 には WebSocket が組み込まれていて、高レベルのマルチプレイヤー API もひととおり揃っています。ただ、どちらも自分でゲームサーバーを動かすか、プレイヤーの一人をホストにすることが前提です。小さなチームにとって、マルチプレイヤーで一番つまずくのはまさにここです。ゲーム自体はできあがったのに、サーバーの立て方、ポートの開け方、NAT の扱いを覚え、何人遊ぶかもわからないマシンに毎月お金を払うことになります。

私たちが欲しかったのは別のやり方でした。ゲームにはクライアントだけを入れ、マネージドのリアルタイムサービスにつなぎ、ルームやオンライン一覧、プレイヤー間のメッセージはそのサービスに中継してもらう。そこで Hibira の Godot アドオンを作りました。純粋な GDScript でネイティブ拡張は不要なので、Web を含め Godot がエクスポートできるすべてのプラットフォームで動きます。

同じルームに、左は Godot のプレイヤー、右はブラウザのプレイヤー。
同じルームに、左は Godot のプレイヤー、右はブラウザのプレイヤー。

小さなマルチプレイヤーゲームに本当に必要なもの

マルチプレイヤーゲームがすべてシューティングというわけではありません。身の回りのインディーゲームやゲームジャムの作品を見ると、マルチプレイヤー部分はほとんどが次のようなものでした。

  • ロビーとルーム:ルームを作ってコードを受け取り、友だちに送り、全員が「準備完了」を押すのを待つ。
  • 誰がオンラインか:ルームに誰がいて、誰が入ってきて、誰が抜けて、誰がホストか。
  • チャット:「相手が入力中…」の表示も含めて。
  • 軽い同期:協力ゲームでのみんなの位置、パーティーゲームで誰が先に押したか、ターン制ゲームの次の一手。

共通点は、メッセージが小さく、求められるのが「人が感じる速さ」であって、シューティングのように 1 ミリ秒を争う速さではないことです。WebSocket 1 本と「チャンネル」のモデルでうまく扱えるもので、まさに Pusher プロトコルが得意とするところです。

なぜ Pusher プロトコルなのか

Pusher プロトコルは 10 年以上使われてきたもので、モデルはシンプルです。クライアントがチャンネルを購読し、サーバーや他のクライアントがそのチャンネルにイベントを送ります。ゲームで役立つのは presence チャンネルです。

  • 購読はあなたのバックエンドが署名するので、誰がどのルームに入れるかはあなたが決めます。
  • チャンネルは現在のメンバー一覧と、誰が入って誰が抜けたかを全員に伝えます。
  • プレイヤー同士は client イベントを直接送り合え、サーバーはそのすべてに送信者の user_id を付けます。

最後の点が肝心です。user_id はクライアントが自分で書き込むのではなくサーバーが付けるので、「プレイヤー A がここに移動した」というメッセージが届いたら、それは本当にプレイヤー A から来たものだとわかります。後で紹介する位置の同期は、この保証の上に成り立っています。

もう一つの利点は、プロトコルが同じなら Web とゲームがつながることです。Web 用のロビー SDK @hibira-io/lobby も同じイベントを使うので、上のスクリーンショットのように、Godot のプレイヤーとブラウザのプレイヤーが同じルームに入れます。

仕組み

Godot のゲームHibiraClient
署名リクエスト
あなたのバックエンドapp secret で presence チャンネルに署名
Godot のゲームHibiraClient
WebSocket
Hibiraルーム、メンバー一覧、イベントの中継
WebSocket
他のプレイヤーGodot またはブラウザ
ゲームがつなぐのは Hibira だけ。バックエンドは署名だけを担当

アドオンの主な部品は四つです。

  • HibiraClient:Godot 組み込みの WebSocketPeer の上に作った Pusher プロトコル v7 のクライアント。接続、購読、ping/pong、切断後の自動再接続と再購読を受け持ちます。
  • HibiraChannel:一つのチャンネル。bind() でイベントを受け取り、trigger() で client イベントを送ります。presence チャンネルではメンバー一覧と、参加・退出の signal が加わります。
  • HibiraRoom:presence チャンネルをゲームのルームにします。席、ホスト、準備状態、ルーム設定、キック、ゲーム開始、そして入力中表示つきのチャット。
  • HibiraSync:0.2.0 の新しいノード。キャラクターの下に置くと、その位置が他のプレイヤーの画面に表示されます。

app secret がゲームに入ることは一切ありません。エクスポートしたゲームは誰でも中身を取り出せるので、署名は必ずバックエンドで行います。pusher-js や Laravel Echo とまったく同じやり方です。すでに Web 版があるなら、その認証エンドポイントがそのまま使えます。

HibiraSync:置くだけで同期

協力ゲームで一番よくある要望は「自分がどこにいるかを他の人に見せたい」です。それをノード一つで済ませたいと考えました。player.tscn の CharacterBody2D の子に HibiraSync を置き、チャンネル名を presence-match-1、同期するプロパティを position と rotation にして、各プレイヤーを次のように生成します。

func spawn(user_id: String) -> void:
	var p := PLAYER.instantiate()
	p.name = user_id
	p.get_node("HibiraSync").owner_id = user_id # 誰が操作するか
	add_child(p)

裏側ではいくつかのことが起きています。

  • 動かせるのはオーナーだけ。 各ノードには owner_id があり、オーナー以外から届いた値は捨てられます。サーバーが user_id を付けてくれるからこそできることです。
  • シーン全体で 1 メッセージ。 同じチャンネルで同期するノードは、tick ごとに一つの client イベントにまとめて送られます。デフォルトは毎秒 8 回です。Hibira の client イベントの上限は 1 接続あたり毎秒 10 件なので、シーンで同期するノードがいくつあっても上限を超えません。
  • 送るのは変わった値だけ。 キャラクターが止まっていれば何も送りません。誰かがルームに入ってきたら、その人のために全部を送り直します。
  • 受け取った値へはなめらかに移動。 毎秒 8 回の更新をそのまま当てはめると、キャラクターがカクカク跳びます。そこで受け取った値を目標にして、キャラクターを毎フレーム少しずつ近づけます。角度とクォータニオンにも対応した補間があります。
プレイヤー A のゲームHibiraプレイヤー B のゲームclient-hibira-sync{"s": {"A/Player": {"position": [...]}}}同じイベントuser_id: "A" を付けてプレイヤー B は user_id がノードのオーナーであることを確かめてから、キャラクターをなめらかに動かす
1 tick のあいだに起きること
Playground:同じルームに二つのブラウザウィンドウ。それぞれが一つの点を動かし、もう一方の点がなめらかに追いつきます。

はっきりさせておくと、HibiraSync が向いているのはパーティーゲーム、協力ゲーム、ボードゲームのような「友だち同士で遊ぶ」ゲームです。各プレイヤーは自分のキャラクターを完全にコントロールします。サーバー権威型のネットコードではないので、チート対策が必要な対戦ゲームでは、やはりサーバー側での判定が必要です。

5 分で動かす

  1. GitHub から addons/hibira をダウンロードしてプロジェクトの addons/ フォルダに置き、プロジェクト → プロジェクト設定 → プラグイン で Hibira Realtime を有効にします。
  2. addons/hibira/demo/playground.tscn を開いて F6 を押します。設定なしで公開デモ用の app につながり、4 文字のコードのルームを作ります。
  3. デバッグ → 実行インスタンスのカスタマイズ でインスタンス数を 2 にしてもう一度実行すると、同じルームで二つの点が動くのが見られます。

すぐにブラウザで試すなら、オンラインの playground を開いてください。同じシーンを Web 向けにエクスポートしたものです。ルームコードつきのリンクを友だちに送れば、相手は同じルームに入ります。playground はウィンドウごとに新しいプレイヤーになります。自分のゲームでは、同じユーザーでログインした二つのウィンドウはルームで一人のメンバーとして数えられるので、二つのアカウントで試してください。たとえば別のブラウザやプライベートウィンドウを使います。

自分の app を使うときは、まず Hibira の管理画面で準備します。app の Overview → Credentials から key をコピーし(secret は app を作ったときに一度だけ表示され、バックエンドにだけ置きます)、Settings → Allow client events をオンにします。Web にエクスポートするなら、ページのオリジン(たとえば https://yourname.itch.io)を Settings → Allowed origins に追加します。無料プランでは * は使えず、オリジンを追加しないとブラウザから接続できません。認証エンドポイントは、Pusher 互換のどのバックエンドでも presence- チャンネルに署名できます。Node なら @hibira-io/lobby の authorizeRoom() がそのまま使えます。

続いてプロジェクト設定の Hibira セクションに app key と認証エンドポイントを入れるだけです。アドオンが Hibira という autoload を追加し、ゲーム起動時に自動で接続するので、どのスクリプトからでも使えます。

func _ready() -> void:
	var lobby := HibiraRoom.join(Hibira, "presence-room-ABCD", {"capacity": 4})
	lobby.message_received.connect(func(m): print(m.info.name, ": ", m.text))
	lobby.started.connect(func(data, _by): start_game(data))

完全な例:反射神経ゲーム

部品を組み合わせて本当にゲームになるかを確かめるため、4 人で遊ぶ反射神経ゲームを作りました。ルーム一覧、4 つの席、ホスト、準備、キック、ルームチャット、そして 5 ラウンドの「GO! が出たら先に押す」です。

ルーム一覧:ルームを作るか、コードで友だちのルームに入ります。
ルーム一覧:ルームを作るか、コードで友だちのルームに入ります。
ゲーム画面:ホストが開始すると、タップのたびにルームチャンネルへ client イベントが一つ送られます。
ゲーム画面:ホストが開始すると、タップのたびにルームチャンネルへ client イベントが一つ送られます。

Web 版のロビーのサンプルと同じイベントを使うので、Godot のプレイヤーとブラウザのプレイヤーが一緒に遊べます。ソースコードは examples/godot-lobby にあります。

料金と制限

  • client イベントは、何人が受け取っても 1 件のメッセージとして数えます。4 人で 5 ラウンド遊んでも数十件程度です。無料プランは 1 日 20 万件あるので、プロトタイプや小さなテストには十分です。
  • HibiraSync はデフォルトで毎秒最大 8 件(プロジェクト設定で変更でき、上限は 10)で、変化があったときだけ送ります。4 人がずっと動き続けても 1 時間で最大約 11 万件、止まっているあいだは数えません。
  • 無料プランでは、1 件のイベントのデータは最大 4 KB です(有料プランではもっと大きくなります)。HibiraSync はバッチをこの大きさより小さく分けて送ります。長い文字列のような単独の値は小さく保ってください。
  • presence チャンネルのメンバーは最大 100 人で、ルームには十分です。数千人のロビーのような大きな空間には、通常のチャンネルとサーバーからのブロードキャストを組み合わせてください。

これから

アドオンは GitHub からダウンロードでき、Godot Asset Library への掲載も申請済みです。次はエンドツーエンド暗号化チャンネルとユーザーのサインイン(pusher:signin)に取り組む予定です。

Godot でマルチプレイヤーゲームを作っているなら、ぜひ試してみてください。あなたのゲームに何が必要か、ぜひ聞かせてください。