一緒に遊ぶ

PlayDrop のリアルタイムゲームサーバー：Colyseus と MongoDB

MongoDB データベース付きのホスト型 Colyseus 0.17 サーバーでゲームを動かし、ブラウザから SDK で接続し、2人のプレイヤーでテストする方法と制限を説明します。

PlayDrop は、ゲームのサーバー側をホストできます。専用の MongoDB データベースを備えた標準の Colyseus サーバーで、プレイヤーは検証済み、運用するインフラはありません。リアルタイムの対戦、ターン制のゲーム、共有ワールド、そしてプレイヤーに不正をされては困るあらゆるものに使えます。サーバーは任意です。自分でホストしているサーバーをゲームから呼び出すこともできます。

サーバーを書く

1つの ES モジュールから rooms マップをエクスポートします。サーバーの起動は PlayDrop が行います。PlayDrop が onJoin の前に各プレイヤーを検証するため、listen() を呼び出したり onAuth を定義したりしないでください。

import { Room, defineRoom } from "colyseus";
import { MongoClient } from "mongodb";

class GameRoom extends Room {
  maxClients = 8;
  async onCreate() {
    this.mongo = new MongoClient(process.env.PLAYDROP_MONGO_URL);
    await this.mongo.connect();
    this.onMessage("move", (client, move) => this.applyMove(client.auth.userId, move));
  }
  onJoin(client) {
    // client.auth is the verified PlayDrop player: userId, username, appRole, isTestPlayer…
  }
  async onDispose() { await this.mongo?.close(); }
}

export const rooms = { game: defineRoom(GameRoom) };

MongoDB への接続は、モジュールのトップレベルではなく、必ずルームのライフサイクルの中で行ってください。PLAYDROP_MONGO_URL は実行時にしか存在しません。クエリに合わせてインデックスを作成しましょう。

サーバーを宣言する

サーバーを1つのファイルにバンドルし、カタログでそのファイルを指定します。

json

{ "server": { "entry": "server/index.mjs", "rooms": ["game"] } }

パッケージでアップロードしてください。シンプルな HTML の方法ではサーバーを含められません。

ホスト型ランタイムのルール

Node.js 24.22.1 上の Colyseus 0.17（colyseus 0.17.10、@colyseus/schema 4.0.30）と MongoDB ドライバー 7.5。
最大 2 MiB の自己完結した ES モジュール1つ。インポートできるのは colyseus、@colyseus/core、@colyseus/schema、mongodb、@playdrop/server だけです。それ以外はすべてバンドルしてください。
ルームの種類は最大2つ、1ルームあたり最大8人、1ルームあたり最大4時間、プレイヤー1人あたり毎秒30メッセージまで、1メッセージあたり最大 512 KiB。
インターネットにはアクセスできません。接続できるのは MongoDB と PlayDrop のサービスだけです。
プレイヤーはサインインしている必要があります。
データベースはゲームごとに1つで、バージョンをまたいで保持され、クリエイターのストレージにカウントされます。そのアドレスや認証情報をブラウザに送るのは絶対にやめてください。

ブラウザから接続する

const sdk = await playdrop.init();
const room = await sdk.multiplayer.join("game");
room.onStateChange((state) => render(state));
room.send("move", { x: 1 });

join は PlayDrop のパーティーの席とサインインを処理します。オンラインパーティーをご覧ください。より細かく制御したい場合は、sdk.multiplayer.getConnection() が、sdk.libs.colyseus.load() で読み込む公式 Colyseus クライアント用の { endpoint, token, expiresAt } を返します。

サーバー SDK

@playdrop/server は、信頼できるプラットフォームの呼び出しを追加します。フレンドとゲームカード（playdrop.social）、購入の検証（playdrop.shop）、クリエイターが費用を負担する AI 生成（playdrop.ai）、ルーム音声（playdrop.multiplayer.forRoom）です。これらはアップロード済みのゲームでのみ動作します。サーバー SDK リファレンスをご覧ください。

テスト

開発中は、Colyseus 0.17 と MongoDB をローカルで動かし、ローカルのクライアントをローカルのサーバーに接続します。ホスト型サーバーをテストするには、非公開バージョンをアップロードして https://www.playdrop.ai/create/games/<slug>/test?v=<version>&player=1 を開き、2つ目のウィンドウで player=2 にした同じリンクを開きます。それぞれのウィンドウは、あなたの別々のテストプレイヤーとして遊びます。うまく動いたら、テスト済みのバージョンを publish_game_version で公開してください。

切断に備えた設計にしましょう。Colyseus の再接続機能は短い間だけ席を確保します。戻ってきたプレイヤーが続きから遊べるよう、ルームの状態を設計してください。