メインコンテンツまでスキップ

MCE オンラインセットアップ

MCE Online は Nakama をバックエンドとして使用し、Monster Capture Engine に完全な MMORPG レイヤーを追加します。このガイドでは、サーバーのセットアップ、クライアントの設定、接続テストの手順を説明します。

Online ティア以上で利用可能。

Nakama とは？​

Nakama はオープンソースのゲームサーバーで、以下を提供します：

  • ユーザー認証（メール、デバイス、SSO）。
  • リアルタイムマルチプレイヤー（WebSocket）。
  • サーバー権威型ゲームロジック（RPC）。
  • ELOベースのマッチメイキング。
  • リーダーボード、実績、ライブイベント。
  • クラウドセーブとストレージ。
  • チャット、フレンド、ギルド。

MCE Online は Nakama をモンスター捕獲ジャンル向けの18の専門サービスでラップしています。

前提条件​

  • MCE Core がインストールされ動作していること。
  • Docker Desktop（ローカル開発用）またはホストされた Nakama インスタンス。
  • MCE Online アドオンがプロジェクトにインポートされていること。

ステップ 1：Nakama サーバーの起動​

ローカル開発（Docker）​

MCE にはローカル Nakama 用の docker-compose 設定が含まれています。プロジェクトルートから起動してください。

Nakama 管理コンソールへのアクセス：ポート7351

本番環境について

デフォルトの Docker 設定は開発専用です。本番環境では、ホストされた Nakama インスタンスを使用してください。

ステップ 2：Unity クライアントの設定​

OnlineConfig アセット​

MCE Online は接続設定に OnlineConfig ScriptableObject を使用します。以下のフィールドを設定します：

フィールド説明ローカルデフォルト
Server HostNakama サーバーのホスト名localhost
Server PortHTTP ポート7350
Server KeyAPIキー（Nakama コンソールから）defaultkey
Use SSLHTTPS/WSS を有効化false（ローカル）、true（本番）

MCE_ONLINE 定義の有効化​

MCE Online にはスクリプティング定義シンボルが必要です：

  1. Edit > Project Settings > Player > Other Settings > Scripting Define Symbols に移動。
  2. リストに定義を追加。
  3. Apply をクリック。

ステップ 3：サーバーサイドコードのデプロイ​

MCE Online には Nakama 用の TypeScript サーバーモジュールが含まれています。サーバーモジュールをビルドし、Nakama のモジュールディレクトリにコピーしてから、Nakama を再起動してモジュールをロードしてください。

ステップ 4：NakamaManager​

NakamaManager は接続を管理するシングルトンです：

  • ランタイムで自動作成。
  • 18のサービス（Auth、Battle、Economy、Social など）を管理。
  • 指数バックオフによる再接続を処理。
  • メインスレッドキューを通じてすべての Nakama 通信をルーティング（スレッドセーフ）。

接続状態​

状態説明
Disconnected接続なし、試行していない
Connecting接続または再接続を試行中
Connectedアクティブな接続、すべてのサービスが利用可能
Offline接続に失敗、オフラインモードで動作

ステップ 5：接続テスト​

  1. Nakama を起動（Docker またはホスト）。
  2. Unity プロジェクトを開く。
  3. プレイモードに入る。
  4. Console で接続メッセージを確認。

オンラインサービス概要​

MCE Online は18のサービスを提供します：

サービス説明
AuthServiceメール、デバイス、SSO認証
SessionManagerトークンの永続化とリフレッシュ
WorldSyncServiceリアルタイムプレイヤー移動、AOIフィルタリング
BattleServicesサーバー権威型PvP、マッチメイキング
EconomyServicesグローバルトレードリンク、ウォレット、ショップ
SocialServicesチャット、ギルド、フレンド、トレード
HousingServiceプレイヤーハウジングCRUD
PersistenceAndSystemsクラウドセーブ、バックアップ
AntiCheatManager速度バリデーション、インベントリ監査
EventServiceライブイベント
LeaderboardServiceランキングとスコア
AchievementService実績追跡

各サービスはこのセクションの個別ガイドで文書化されています。

トラブルシューティング​

問題解決方法
接続拒否Nakama が実行中か確認してください
サーバーキー無効OnlineConfig のサーバーキーが Nakama の設定と一致しているか確認
定義シンボルエラースクリプティング定義シンボルが設定されているか確認
接続タイムアウトファイアウォール設定を確認、サーバーホスト/ポートを確認
モジュール未検出RPCエラーサーバーサイド TypeScript モジュールをデプロイして Nakama を再起動

次のステップ​

  • 認証 -- ユーザーアカウントとログインフローの設定。
  • ワールド同期 -- リアルタイムマルチプレイヤーワールドの有効化。
  • PvPバトル -- サーバー権威型オンラインバトル。
  • 経済 -- トレード、ショップ、通貨。