ガイド

Minecraftのミニゲームプラグインの作り方

2026年10月18日に更新

ミニゲームプラグインはラウンドを回します。プレイヤーがロビーで待ち、カウントダウンが始まり、独自のルールでゲームが進み、誰かが勝って、次のラウンドのためにアリーナがリセットされます。スプリーフからベッドウォーズまで、どのミニゲームも骨組みは同じです。そこをしっかり作れば、ゲームのルールは簡単な部分です。

この例から始めて、ルールを変えてください。

Codexeでこれを生成

手順

  1. 1.1ラウンドのルールを書く

    何人で遊ぶか、ラウンドがどう始まりどう終わるか、どうすれば勝ちか、死んだらどうなるか(脱落、リスポーン、観戦)、開始時にプレイヤーが何を受け取るか。

  2. 2.アリーナの設定方法を考える

    アリーナを作成し、ロビー、スポーン地点、境界を設定する管理者コマンドです。例: /mg create <name>、/mg setspawn <name>。アリーナはファイルに保存され、再起動後も残ります。

  3. 3.ゲームの状態を決める

    待機中、開始中(カウントダウン)、プレイ中、終了中。状態ごとにできることが違います。ロビーでは誰もブロックを壊せず、進行中のゲームには誰も参加できません。

  4. 4.アリーナのリセット方法を決める

    ラウンド中に変わったブロックを記録して元に戻すか、テンプレートワールドのコピーを読み込み直します。リセットがないと、2ラウンド目は壊れたマップで始まります。

  5. 5.プレイヤーに見せるものを加える

    残り人数と時間を表示するサイドバーのスコアボード、カウントダウン用のボスバーやタイトル、キルと勝者を伝えるチャットメッセージ。

  6. 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でこれを生成
Minecraftのミニゲームプラグインの作り方 | Codexe