Claude で Minecraft プラグインを作る｜Bukkit/Spigot 入門

「プラグイン」と「Mod」はどう違うのか

Minecraft で Claude を使う情報を探すとき、最初に押さえるべきは「プラグイン」と「Mod」の違いだ。Mod は Forge・Fabric・NeoForge といったローダー上でゲーム本体を改造する仕組みで、新しいブロックやエンティティを追加できる反面、サーバーだけでなく参加者全員がクライアントに同じ Mod を入れる必要がある。

対して プラグインは Bukkit・Spigot・Paper というサーバーソフトの API 上で動く。配置先もサーバーの plugins/ フォルダで、参加者は手を加えていない通常の Minecraft からそのまま接続できる。ランク制度・ミニゲーム・保護機能・経済システムなど「サーバーの遊び方」を拡張するのがプラグインの役割だ。マルチプレイサーバーを運営して機能を足したいなら、必要なのはほぼプラグインの側になる。ゲーム本体の改造そのものが目的なら、Mod を扱う Claude で Minecraft Mod を作る方法 を参照してほしい。

Claude で Minecraft プラグインを作る 3 つのアプローチ

Claude を使ったプラグイン開発には、目的別に大きく 3 つのアプローチがある。

1. Claude Code で Java コードを書く:Bukkit/Spigot/Paper の開発知識を持たせたスキルを読み込ませ、本格的なプラグインを実装する。
2. DeveloperMCP で稼働サーバーを操作する:Model Context Protocol(MCP)経由で、Claude から実サーバーのログ確認やプラグイン導入を行う。
3. ノーコード・建築系ツールを使う:自然言語から建築や簡易プラグインを生成し、コードを書かずに成果物を得る。

配布できる本格的なプラグインを作るなら 1、運用中サーバーの保守を効率化したいなら 2、コードを書かずに試したいなら 3 が向く。以下でそれぞれを具体的に見ていく。

① Claude Code とプラグイン開発スキルでコードを書く

最も汎用性が高いのが、Claude Code に Minecraft プラグイン開発の知識を持たせる方法だ。コミュニティが公開する minecraft-bukkit-pro スキルは、Bukkit・Spigot・Paper の API を体系的に扱う指針を Claude に与える。

このスキルがカバーする範囲は広い。イベント駆動の設計、Brigadier を使ったコマンドシステム、インベントリ GUI、ワールド生成、エンティティ AI のカスタマイズに加え、Paper の Adventure / MiniMessage によるテキスト整形にも対応する。さらに NMS(net.minecraft.server)内部やパケット操作、バージョン互換のためのリフレクションといった上級トピック、ホットイベントの最適化や非同期処理・メモリプロファイリングといったパフォーマンス領域まで含む。実装前に最新のベストプラクティスを調べる「リサーチ優先」の進め方と、MockBukkit を使ったテストを推奨する点も実務的だ。単発のコード片ではなく、本番運用に耐える構造を意識した設計を返してくれる。

開発スキルの導入と使い方

Claude Code にこの種のスキルを取り込む手順は次のとおりだ。

1. Claude Code で /plugin を実行し、Marketplaces から対象リポジトリを追加する。
2. Discover タブで該当スキルを選んでインストールする。
3. プラグインのソースを開いた状態で「プレイヤーのキル数を記録するコマンドを追加して」のように依頼する。
4. 生成されたコードを Maven または Gradle でビルドし、サーバーの plugins/ に配置して再起動する。

導入コマンドはリポジトリごとに異なるため、最新の手順は各 README で確認してほしい。スキルはプラグインのコードを扱う文脈で自動的に立ち上がる設計が多く、毎回明示的に呼び出さなくても適切なガイドが働く。

② DeveloperMCP:稼働中サーバーを Claude から操作する

コードを書く支援だけでなく、動いているサーバーそのものを Claude から操作したい場合に使えるのが DeveloperMCP だ。これは Spigot/Paper サーバーに導入するプラグインで、Model Context Protocol(MCP)を実装し、JSON-RPC over SSE を通じて Claude Desktop や Cursor といった AI クライアントとサーバーを橋渡しする。

公開している機能は、出力まで取得するコマンド実行、設定やログの読み書きを行うファイル管理、JAR やワールドデータを Base64 で送受信するバイナリ転送、バージョン情報つきの導入プラグイン一覧、ログ閲覧、ファイルサイズ込みのディレクトリ探索など 8 種類だ。これにより、サーバーのエラーを Claude が解析して原因を切り分けたり、新しいプラグインを導入したり、パフォーマンス指標を監視したりといった保守作業を、コンソールに張り付かずに任せられる。

DeveloperMCP の導入手順

DeveloperMCP の導入は次の流れで進める。

1. Modrinth の Versions タブからサーバーのバージョンに合う JAR をダウンロードする。
2. サーバーの plugins/ フォルダに JAR を配置する。
3. サーバーを再起動して初期設定ファイルを生成させる。
4. plugins/MCPMinecraft/config.yml でセキュリティトークンと待ち受けポートを設定する。
5. Claude などのクライアント側の mcp.json に接続情報を記述して連携する。

このプラグインはサーバーへの管理者権限に近い操作を許すため、トークンは強固でランダムな値を使い、ポートをファイアウォールなしに外部公開しないことが必須の注意点になる。

③ コードを書かない選択肢:Promptcraft と Kodari AI

プログラミングを避けたい場合の選択肢も増えている。Promptcraft は Claude Code 用のプラグインで、自然言語の指示を Minecraft Java Edition の建築データに変換する。「堀のある中世の城」と伝えると、Claude が Python スクリプトを生成・実行し、WorldEdit 互換の .schem ファイルを出力してスキマティックフォルダへ自動コピーする。あとはゲーム内で //schem load と //paste を実行すれば配置できる。導入後は /promptcraft:setup で Python 3.8 以上の確認や依存導入、フォルダ設定までまとめて済む。これはサーバーロジックではなく「建築の自動化」に特化したツールだ。

サーバー機能そのものを生成したいなら、Kodari AI のようにブラウザだけでプラグインや Fabric Mod を生成し、コンパイルとエラー修正、デプロイまで自動化するサービスもある。コードを一行も書かずに動く成果物を得たい初心者の入口として向く。

コストと運用上の注意点

いずれの方法も、Claude や Claude Code の利用枠を消費する。生成するプラグインの規模が大きいほど一度のやり取りで消費量が増えるため、まずは小さな機能から試して挙動と消費感を確かめるのが安全だ。DeveloperMCP のようにサーバーを直接操作するツールは、管理者権限相当の力を持つ点を忘れてはいけない。トークンの厳重な管理とポートの非公開を徹底し、本番投入前には MockBukkit などでテストしておきたい。

加えて、プラグインは Minecraft とサーバーソフトのバージョンに強く依存する。plugin.yml の api-version や対応する Paper のバージョンが合わないと、起動時に読み込まれなかったりエラーになったりする。導入前にサーバーのバージョンと各プラグインの対応表を必ず確認し、ワールドのバックアップを取ってから検証する手順を習慣づけることが、安定運用への近道になる。