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

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

Source: https://hibira.io/ja/blog/godot-multiplayer-without-a-server
Updated: 2026-11-17

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

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

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

![同じルームに、左は Godot のプレイヤー、右はブラウザのプレイヤー。](https://hibira.io/portal/articles/godot-lobby-crossplay-ja.webp)

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

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

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

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

## なぜ Pusher プロトコルなのか

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

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

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

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

## 仕組み

```text
flow: ゲームがつなぐのは Hibira だけ。バックエンドは署名だけを担当
Godot のゲーム|HibiraClient --署名リクエスト--> あなたのバックエンド|app secret で presence チャンネルに署名
Godot のゲーム|HibiraClient --WebSocket--> *Hibira|ルーム、メンバー一覧、イベントの中継 --WebSocket--> 他のプレイヤー|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` にして、各プレイヤーを次のように生成します。

```gdscript
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 回の更新をそのまま当てはめると、キャラクターがカクカク跳びます。そこで受け取った値を目標にして、キャラクターを毎フレーム少しずつ近づけます。角度とクォータニオンにも対応した補間があります。

```text
sequence: 1 tick のあいだに起きること
プレイヤー A のゲーム | *Hibira | プレイヤー B のゲーム
1 > 2: client-hibira-sync | {"s": {"A/Player": {"position": [...]}}}
2 > 3: 同じイベント | user_id: "A" を付けて
note: プレイヤー B は user_id がノードのオーナーであることを確かめてから、キャラクターをなめらかに動かす
```

![Playground：同じルームに二つのブラウザウィンドウ。それぞれが一つの点を動かし、もう一方の点がなめらかに追いつきます。](https://hibira.io/portal/articles/godot-playground-ja.mp4)

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

## 5 分で動かす

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

すぐにブラウザで試すなら、[オンラインの playground](https://demos.hibira.io/godot/) を開いてください。同じシーンを 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 を追加し、ゲーム起動時に自動で接続するので、どのスクリプトからでも使えます。

```gdscript
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! が出たら先に押す」です。

![ルーム一覧：ルームを作るか、コードで友だちのルームに入ります。](https://hibira.io/portal/articles/godot-lobby-rooms-ja.webp)

![ゲーム画面：ホストが開始すると、タップのたびにルームチャンネルへ client イベントが一つ送られます。](https://hibira.io/portal/articles/godot-lobby-game-ja.webp)

Web 版のロビーのサンプルと同じイベントを使うので、Godot のプレイヤーとブラウザのプレイヤーが一緒に遊べます。ソースコードは [examples/godot-lobby](https://github.com/hibira-io/examples/tree/main/godot-lobby) にあります。

## 料金と制限

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

## これから

アドオンは [GitHub](https://github.com/hibira-io/godot/releases) からダウンロードでき、Godot Asset Library への掲載も申請済みです。次はエンドツーエンド暗号化チャンネルとユーザーのサインイン（`pusher:signin`）に取り組む予定です。

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