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

ある日、チームの誰かがこう聞きました。「Godot って Pusher プロトコルに対応してる?」
答えはノーでした。Godot 4 には WebSocket が組み込まれていて、高レベルのマルチプレイヤー API もひととおり揃っています。ただ、どちらも自分でゲームサーバーを動かすか、プレイヤーの一人をホストにすることが前提です。小さなチームにとって、マルチプレイヤーで一番つまずくのはまさにここです。ゲーム自体はできあがったのに、サーバーの立て方、ポートの開け方、NAT の扱いを覚え、何人遊ぶかもわからないマシンに毎月お金を払うことになります。
私たちが欲しかったのは別のやり方でした。ゲームにはクライアントだけを入れ、マネージドのリアルタイムサービスにつなぎ、ルームやオンライン一覧、プレイヤー間のメッセージはそのサービスに中継してもらう。そこで Hibira の Godot アドオンを作りました。純粋な GDScript でネイティブ拡張は不要なので、Web を含め Godot がエクスポートできるすべてのプラットフォームで動きます。

小さなマルチプレイヤーゲームに本当に必要なもの
マルチプレイヤーゲームがすべてシューティングというわけではありません。身の回りのインディーゲームやゲームジャムの作品を見ると、マルチプレイヤー部分はほとんどが次のようなものでした。
- ロビーとルーム:ルームを作ってコードを受け取り、友だちに送り、全員が「準備完了」を押すのを待つ。
- 誰がオンラインか:ルームに誰がいて、誰が入ってきて、誰が抜けて、誰がホストか。
- チャット:「相手が入力中…」の表示も含めて。
- 軽い同期:協力ゲームでのみんなの位置、パーティーゲームで誰が先に押したか、ターン制ゲームの次の一手。
共通点は、メッセージが小さく、求められるのが「人が感じる速さ」であって、シューティングのように 1 ミリ秒を争う速さではないことです。WebSocket 1 本と「チャンネル」のモデルでうまく扱えるもので、まさに Pusher プロトコルが得意とするところです。
なぜ Pusher プロトコルなのか
Pusher プロトコルは 10 年以上使われてきたもので、モデルはシンプルです。クライアントがチャンネルを購読し、サーバーや他のクライアントがそのチャンネルにイベントを送ります。ゲームで役立つのは presence チャンネルです。
- 購読はあなたのバックエンドが署名するので、誰がどのルームに入れるかはあなたが決めます。
- チャンネルは現在のメンバー一覧と、誰が入って誰が抜けたかを全員に伝えます。
- プレイヤー同士は client イベントを直接送り合え、サーバーはそのすべてに送信者の
user_idを付けます。
最後の点が肝心です。user_id はクライアントが自分で書き込むのではなくサーバーが付けるので、「プレイヤー A がここに移動した」というメッセージが届いたら、それは本当にプレイヤー A から来たものだとわかります。後で紹介する位置の同期は、この保証の上に成り立っています。
もう一つの利点は、プロトコルが同じなら Web とゲームがつながることです。Web 用のロビー SDK @hibira-io/lobby も同じイベントを使うので、上のスクリーンショットのように、Godot のプレイヤーとブラウザのプレイヤーが同じルームに入れます。
仕組み
アドオンの主な部品は四つです。
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 回の更新をそのまま当てはめると、キャラクターがカクカク跳びます。そこで受け取った値を目標にして、キャラクターを毎フレーム少しずつ近づけます。角度とクォータニオンにも対応した補間があります。
はっきりさせておくと、HibiraSync が向いているのはパーティーゲーム、協力ゲーム、ボードゲームのような「友だち同士で遊ぶ」ゲームです。各プレイヤーは自分のキャラクターを完全にコントロールします。サーバー権威型のネットコードではないので、チート対策が必要な対戦ゲームでは、やはりサーバー側での判定が必要です。
5 分で動かす
- GitHub から
addons/hibiraをダウンロードしてプロジェクトのaddons/フォルダに置き、プロジェクト → プロジェクト設定 → プラグイン で Hibira Realtime を有効にします。 addons/hibira/demo/playground.tscnを開いて F6 を押します。設定なしで公開デモ用の app につながり、4 文字のコードのルームを作ります。- デバッグ → 実行インスタンスのカスタマイズ でインスタンス数を 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! が出たら先に押す」です。


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