Minecraftプラグイン floodgate

🔌 Floodgateについて

Floodgateは、Geyser 用の Minecraft 連携プラグインで、Bedrock Edition のプレイヤーが Java Edition サーバーに Java アカウントなしで参加できるようにします。Bedrock クライアントが online-mode の Java サーバー上で有効なプレイヤーとして表示されるために必要な、認証とアカウント連携の機能を提供します。

🎯 目的

Floodgate の主な目的は、Bedrock と Java 版の認証の違いをつなぐことです。Bedrock (Xbox/Microsoft) の ID を検証し、Java 互換のプレイヤーエントリにマッピングし、ローカルおよびグローバルなアカウント連携をサポートすることで、Floodgate を使用しているサーバー間で Bedrock プレイヤーの ID を一貫して認識できるようにします。 ()

⚙️ 機能

• Bedrock アカウントの認証と Java プレイヤーアカウントへのマッピング。 ()
• プレイヤー向けのローカルなアカウント連携・解除コマンド。 ()
• Java の whitelist とは別に Floodgate (Bedrock) プレイヤーを管理するための whitelist コマンド。 ()
• 他のプラグインが Floodgate 管理の Bedrock プレイヤーを検出し、やり取りするために使えるプラグイン API。 ()

🧩 対象ユーザー

Floodgate は、Bedrock プレイヤーが Java サーバーに参加できるよう Geyser を運用しているサーバー所有者やネットワーク管理者、そして Bedrock の ID に対して堅牢な認証・連携ソリューションを必要としている人向けです。

🏗️ 使用例

• モバイルやコンソールの Bedrock プレイヤーが既存の Java SMP や Survival サーバーに参加できるようにしつつ、プレイヤーアカウントを個別に管理・追跡する。
• プレイヤーの Bedrock ID を Java アカウントに連携し、プラグインや権限がそのユーザーに対して一貫して動作するようにする。

⌨️ コマンド

(コマンドと権限ノードは Floodgate の公式ドキュメントから取得しています。) ()

🔐 権限

⚙️ インストール

📥 セットアップ

• サーバー種別に合った Floodgate のビルドをダウンロードし、.jar をサーバーの plugins/ ディレクトリに配置してください（該当する場合は Fabric/NeoForge 用の mod をインストールしてください）。
• サーバーを再起動し、コンソールで Floodgate が読み込まれたことを確認してください。
• Geyser を使用している場合は、Geyser の設定を auth-type: floodgate に更新し、Bedrock 認証を Floodgate に委任するようにします。 ()

📦 依存関係

• Floodgate は Bedrock-to-Java の橋渡しとして Geyser と一緒に使うよう設計されています。インストール手順と推奨セットアップは、公式の Floodgate/Geyser ドキュメントに記載されています。 ()

🧠 技術メモ

• Floodgate はサーバーソフト向けのプラグインとしても、Fabric/NeoForge 向けの mod としても配布されています。対応サーバー種別には Spigot（Paper などの派生版を含む）、BungeeCord、Velocity、そして Fabric/NeoForge ビルドが含まれます。 ()
• Floodgate は、他のプラグインが Floodgate のプレイヤー情報を照会し、Bedrock 固有のイベントに応答できる API を公開しています。 ()

🤝 このプラグインが役立つ場面

Geyser を使って Bedrock プレイヤーに Java サーバーへ参加させている場合、Floodgate は Bedrock の ID とアカウント連携を担当するコンポーネントです。これにより、それらのプレイヤーは Java 側のプラグインやサーバーシステムから認識され、利用可能になります。