ガイド
Minecraftのミニゲームプラグインの作り方
2026年10月18日に更新
ミニゲームプラグインはラウンドを回します。プレイヤーがロビーで待ち、カウントダウンが始まり、独自のルールでゲームが進み、誰かが勝って、次のラウンドのためにアリーナがリセットされます。スプリーフからベッドウォーズまで、どのミニゲームも骨組みは同じです。そこをしっかり作れば、ゲームのルールは簡単な部分です。
この例から始めて、ルールを変えてください。
Codexeでこれを生成手順
1.1ラウンドのルールを書く
何人で遊ぶか、ラウンドがどう始まりどう終わるか、どうすれば勝ちか、死んだらどうなるか(脱落、リスポーン、観戦)、開始時にプレイヤーが何を受け取るか。
2.アリーナの設定方法を考える
アリーナを作成し、ロビー、スポーン地点、境界を設定する管理者コマンドです。例:
/mg create <name>、/mg setspawn <name>。アリーナはファイルに保存され、再起動後も残ります。3.ゲームの状態を決める
待機中、開始中(カウントダウン)、プレイ中、終了中。状態ごとにできることが違います。ロビーでは誰もブロックを壊せず、進行中のゲームには誰も参加できません。
4.アリーナのリセット方法を決める
ラウンド中に変わったブロックを記録して元に戻すか、テンプレートワールドのコピーを読み込み直します。リセットがないと、2ラウンド目は壊れたマップで始まります。
5.プレイヤーに見せるものを加える
残り人数と時間を表示するサイドバーのスコアボード、カウントダウン用のボスバーやタイトル、キルと勝者を伝えるチャットメッセージ。
6.生成してビルドし、1ラウンド遊ぶ
Codexeに説明してコンパイルさせ、「今すぐ試す」でテストサーバーに参加します。ラウンドを始められるように、テスト中は最低人数を少なくしておきます。
ゲームの状態
ミニゲームのバグのほとんどは、プレイヤーが間違った状態で何かをすることで起きます。リクエストに状態を書いておけば、AIはそれを軸にプラグインを組み立てます。
| 状態 | 起きること | よくあるルール |
|---|---|---|
| 待機中 | プレイヤーがロビーに参加する | ダメージなし、ブロック破壊なし、アイテムかコマンドで退出 |
| 開始中 | 最低人数に達したらカウントダウン | プレイヤーが抜けて最低人数を下回るとカウントダウンが止まる |
| プレイ中 | ゲームのルールが適用される | 途中参加なし、死ぬと脱落またはリスポーン、退出は負け扱い |
| 終了中 | 勝者を発表し、報酬を配る | 数秒後にプレイヤーを戻し、アリーナをリセット |
アリーナのリセット
- 変更を記録して戻す: ラウンド中に変わる前の各ブロックを保存し、終了時に元に戻します。プレイヤーが少しだけブロックを壊したり置いたりする小さなアリーナなら高速です。
- テンプレートワールド: マップのきれいなコピーを保管しておき、ラウンド後にプレイしたワールドをアンロードして、テンプレートで上書きします。壊されるマップには、シンプルで確実な方法です。
- 変更を許可しない: パルクールやPvPの対戦のようなゲームでは、ブロックの変更をすべてキャンセルすれば、リセットするものは何もありません。
説明の例
「Paper 1.21.4のスプリーフミニゲームプラグイン。管理者は/spleef create <name>、/spleef setlobby、/spleef setfloor(雪の床の2つの角)でアリーナを作る。プレイヤーは/spleef join <arena>で参加する。2人そろってから15秒後にラウンド開始、最大8人。プレイヤーはダイヤモンドのシャベルを受け取り、雪を一瞬で壊せ、床より下に落ちたら脱落。最後まで残ったプレイヤーはVault経由で50コインを獲得。脱落したプレイヤーは観戦者になる。雪の床はラウンドごとに復元。残り人数と時間を表示するサイドバー。アリーナはarenas.yml、最低人数と報酬はconfig.ymlに保存。」
ミニゲームのテスト
ミニゲームはコードを見ても判断しにくく、実際に1ラウンド遊ぶ必要があります。「今すぐ試す」は、プラグインを入れたあなたのバージョンの専用Paperサーバーを、通常はフラットワールドで起動します。サーバーアクセスに追加すれば、友達も参加できます。テストサーバーに参加できる人数は、Freeプランで2人、Proで5人、Businessで10人、Enterpriseで20人です。
テスト中に1や2に設定できるように、最低人数をconfig.ymlに入れるよう指定しましょう。テストプレイヤーも参加して、参加コマンドや管理者コマンドを実行し、メッセージを確認できるので、自分で遊ぶ前に壊れたコマンドを見つけられます。
よくある質問
アリーナは1つ、それとも複数?
最初から複数のアリーナを指定しましょう。単一アリーナのプラグインを後から複数アリーナに対応させるには、プレイヤーとゲームの状態の保存方法を書き直すことになります。
1.8のPvPミニゲームは作れますか?
はい。リクエストにSpigotまたはPaper 1.8.8と書いてください。Codexeはその古いAPI向けにコードを書き、テストサーバーは1.8から26.3までのバージョンで動きます。
ミニゲームのネットワークはどういう仕組みですか?
大きなネットワークでは、BungeeCordやVelocityのプロキシの後ろで、ゲームごとに別のサーバーを動かし、ロビーサーバーが空いているゲームにプレイヤーを送ります。つまり、プロキシプラグインとゲームプラグインの2つのプロジェクトです。
ミニゲームを作る
このプロンプトは、そのまま送信できる状態で開きます:
“Paper 1.21.4のスプリーフミニゲームプラグイン: /spleef create、setlobby、setfloorでアリーナを作成、/spleef joinで参加、2人そろってから15秒後にラウンド開始(最大8人)、ダイヤモンドのシャベル、床より下に落ちたら脱落、最後の1人はVault経由で50コイン、脱落者は観戦者、ラウンドごとに雪の床を復元、残り人数と時間のサイドバー、アリーナはarenas.ymlに保存。”
Codexeでこれを生成