Minecraftプラグイン Geyser-Spigot

🔌 Geyser-Spigot について

Geyser-Spigot は、Geyser の Spigot/Paper 向けプラットフォーム版です。Minecraft: Bedrock Edition のクライアントが、Geyser をサーバーサイドプラグインとして動かすことで Java Edition サーバーに接続できるようにするプロトコル変換ツールです。Spigot 互換のサーバー JAR 内で動作し、Bedrock のプロトコル通信をホストサーバー向けの Java プロトコル通信に変換する Bedrock listener を提供します。

🎯 目的

別のプロキシプロセスを用意せずに、サーバー所有者が Java サーバーで Bedrock プレイヤーを受け入れられるようにクロスプレイ機能を提供します。これにより、Bedrock 版と Java 版の間にあるプロトコル互換性の問題という核心部分を解決します。

⚙️ 機能

• Spigot/Paper プラグインとして動作します（JAR を plugins/ に置いて再起動）。
• Bedrock のプロトコル通信を Java プロトコルに変換し、Bedrock クライアントが Java サーバーに参加できるようにします。
• サーバーごとの設定を生成します（プラグインフォルダと設定ファイルは plugins/Geyser-Spigot 配下に作成されます）。
• Bedrock プレイヤーを Java アカウント認証なしで参加させたい場合、Bedrock 認証には Floodgate と組み合わせるのが公式に推奨されています。
• GeyserMC プロジェクトの一部としてサポート・保守されています（ソースはプロジェクトのリポジトリで公開されています）。

🧩 対象ユーザー

• 1 つの Spigot または Paper バックエンドで Java/Bedrock のクロスプレイを実現したいサーバー所有者。
• Bedrock クライアント互換が必要な、小規模から大規模までの Survival、SMP、コミュニティサーバー。
• 別のスタンドアロン型プロキシではなく、プラグインとして Geyser を動かしたい管理者。

🏗️ 使用例

• モバイルやコンソールのプレイヤー（Bedrock）が、別のプロキシサーバーを立てずに Spigot/Paper の Java サーバーへ参加できるようにする。
• ゲームロジックを同じバックエンドに保ちながら、Java と Bedrock の両方のクライアントを受け入れる公開 SMP サーバーを運営する。

⚙️ インストール

📥 セットアップ

• Spigot/Paper 向けの公式 Geyser-Spigot JAR をダウンロードします。
• Geyser-Spigot.jar ファイルをサーバーの plugins/ ディレクトリに配置します。
• サーバーを起動または再起動し、ログを確認してプラグインが有効化され、フォルダが作成されたことを確認します。

📦 依存関係

• Floodgate（任意）: Bedrock プレイヤーを Java アカウント認証なしで認証・参加させたい場合に推奨されます。Floodgate は Geyser の一般的な併用プラグインとして案内されています。

🧾 設定

• Geyser-Spigot は plugins/Geyser-Spigot の下に設定ディレクトリと、listener、リモート Java サーバー設定、その他のオプションを定義するメイン設定ファイルを作成します。必要に応じてそれらを編集し、サーバーを再起動して変更を適用してください。

🧠 技術メモ

• 確認されている対応サーバープラットフォーム: Spigot と Paper。
• Spigot/Paper プラグインとして使用する場合、1.16.5 以降の最新サーバーバージョンをサポートすると記載されています。
• ソースコードと issue 管理は、GeyserMC プロジェクトのリポジトリで管理されています。
• MIT License の下でライセンスされています。

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

別のプロキシプロセスを動かさずに、既存の Spigot/Paper Java サーバーで Bedrock プレイヤーを受け入れる必要がある場合、Geyser-Spigot はサーバーサイドで保守されるプロトコル変換レイヤーを提供し、Bedrock の接続を Java プレイヤーと同じバックエンドに維持します。