Bomberman（ボンバーマン）― OP・運営ガイド¶
ボンバーマンの導入・フィールド設定・看板・config・権限・管理コマンド、ソロモード（CPU対戦・パズル）の設定をまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | Bomberman |
| メインコマンド | /bomberman（エイリアス /bm・/bomber） |
| 依存プラグイン | なし（Geyser / Floodgate は任意） |
| api-version | 26.1.2 |
| 設定ファイル | plugins/Bomberman/config.yml・plugins/Bomberman/puzzles.yml |
| データファイル | lobby-inventory.yml（持ち物の退避）・solo-records.yml（ソロの記録） |
仕組み
setfield の2点で囲んだ直方体にゲーム開始時に 格子状フィールドを自動生成（外周と偶数マスに硬ブロック、残りに軟ブロックを密度指定で配置）し、終了時に元の地形へ 完全復元 します。爆弾は重力無効の TNT 落下ブロック（FallingBlock）で表示し（統合版／Geyserでも表示されるようにするため。BlockDisplay は使用しません）、十字判定はプラグインが自前で計算します。
導入手順¶
- ビルドした
Bombermanの jar をplugins/に配置する。 - サーバーを起動すると
plugins/Bomberman/config.ymlとpuzzles.ymlが生成される。 /bomberman wandで 設定ツール（ブレイズロッド） を受け取り、フィールド・スポーン・看板を設定する（コマンドでも可）。/bomberman statusで設定状況を確認する。
設定ツール（おすすめ）¶
コマンドを打たずに、見ているブロック・看板へ直接セットアップできる OP用ツール（光るブレイズロッド）と GUI メニューです。どちらも bomberman.admin 権限が必要で、非OPが入手しても使えません（受け取る時・使う時・メニューを開く時・押す時に確認します）。
| 操作（ツールを持って） | 内容 |
|---|---|
| 左クリック／長押し（ブロック） | フィールドの角1 |
| 右クリック／タップ（ブロック） | フィールドの角2 |
| 右クリック／タップ（看板） | 選んでいる看板モードで登録・解除（モードなしなら何の看板かを表示） |
| 右クリック／タップ（空中） | 設定状況の要約 |
| しゃがみ＋左クリック／長押し | 現在地をスポーンに追加（空いている一番小さい番号・マスの中央にそろえる） |
| しゃがみ＋右クリック／タップ | 設定メニューを開く |
| 持っている間 | フィールドの枠（橙）・スポーン（黄緑／置き場所に問題があれば赤）・ロビー（水色）・初期スポーン（白）を粒子で表示（本人だけ） |
設定メニュー（54スロット）では次の操作ができます。押すとすぐ保存されます。
- 地点：初期スポーン・ロビーを現在地に設定／スポーン追加・最後のスポーンを削除・全削除（3秒以内にもう一度押すと削除）
- 看板モード：参加・離脱・開始・ソロ・登録解除・モード解除
- ソロモードの ON/OFF（
solo.enabled） - 数値（−／＋ボタン）：初期火力・初期ボム数・最小開始人数・起爆秒数（0.5秒刻み）・サドンデス（30秒刻み、0＝なし）・軟ブロック密度（5%刻み）
- 進行：ゲーム開始・強制停止（3秒以内にもう一度押すと停止）・設定ツールの回収／受け取り
ツールでのフィールド指定は「床にするブロック」をクリック
ツールでクリックしたブロックの高さがそのまま 床 になり、プレイヤーはその1つ上に立ちます（地面のブロックを2か所クリックすればOK）。コマンドの setfield 1/2 は 立っている足元の高さ が床になる（地面より1段上に床ができる）ので、混ぜて使うときは高さに注意してください。角を設定すると、フィールドの大きさと床・立つ高さがチャットに出ます。奇数×奇数（例：15×15）がおすすめです。
スポーンの置き場所チェック
スポーンを追加すると（ツール・メニュー・setspawn のどれでも）、フィールドの外周や柱（硬ブロック）のマス、立つ高さが違う場所なら警告を出します。/bomberman status にも問題のあるスポーンが赤で出ます。スポーン1番はソロのプレイヤー、2番以降は CPU の出現地点にも使われます。
ボンバーマンに参加中は受け取れません
ロビーに入ると持ち物が退避されるため、在籍中は設定ツールを渡しません。先に /bomberman leave してください（メニューだけなら在籍中でも /bomberman menu で開けます）。統合版は空中を右クリックしても届かないため、空中タップ＝設定状況の要約、メニューはしゃがんでタップか /bomberman menu で開きます。
セットアップ手順（コマンド）¶
OP権限（bomberman.admin）で、設定したい場所に 立って／対象を見て 実行します。各設定は即 config.yml に保存されます。設定ツールでも同じことができます。
フィールドとスポーンの注意
setfield 1/2 の2点で直方体（X・Z範囲）を決め、下から床→障害物2段が生成されます。スポーンはフィールドの升目上の正しい高さ（足元の段）に立って setspawn <番号> で設定してください。スポーン数が実質の最大参加人数になります（maxplayers と少ない方が上限）。外周と偶数マスは固定の硬ブロックになります。
看板の設置¶
参加・離脱・開始・ソロの4種の看板を設置できます。看板を見ながら（6ブロック以内）以下を実行します。
テキストはプラグインが自動で書き込みます（1行目 [ボンバーマン]）。ソロ看板の4行目にはアリーナの状況（空き／挑戦中: 名前／通常戦の試合中）が出ます。位置は config の signs に保存され、再起動後も有効です。看板の破壊は bomberman.admin のみ可能で、破壊すると登録も解除されます。
看板の登録解除
解除は 視線先（6ブロック以内）の看板を自動判別 して行います。/bomberman setsign delete が標準で、/bomberman removesign は同じ動作の互換エイリアスです。開始看板に付けた識別子ラベルは単一ステージのため 表示用（看板2行目に表示）で、ステージ切替などには影響しません。
ソロモードの設定¶
通常戦の設定（ロビー・初期スポーン・フィールド）がそろっていれば、追加で必要なのは ソロ看板 だけです（看板を置かず /bomberman solo だけで遊ぶこともできます）。
| モード | 追加で必要なもの |
|---|---|
| CPU対戦 | スポーン地点 2か所以上（1番＝プレイヤー、2番以降＝CPU）。CPU の数より少ないときは、CPU を減らして始めます（メニューに「スポーン不足で○体」と出ます） |
| パズル | フィールドが盤面より大きいこと。初期のステージは 7×7・9×9・11×11（外周込み）。11×11 以上（おすすめ 15×15）のフィールドなら全ステージ遊べます。入らないステージはメニューで遊べない表示になります |
- パズルの盤面はフィールドの 中央 に置かれ、盤面の外は硬ブロックで埋まります（終わると元の地形に戻ります）。
- 「つよい」で CPU 3体にするには、スポーンが4か所必要です。四隅に置くのがおすすめです。
ソロを始められない場合
ソロメニューのボタンがバリアになり、理由が表示されます（ソロ無効／ロビー・初期スポーン・フィールド未設定／スポーン不足／フィールドが小さい／アリーナ使用中）。
ミニゲームメニューへの登録（ソロ）¶
本人として実行するボタンなら：
コンソールとして実行するボタンなら：
/bomberman solo <プレイヤー> cpu [難易度]・/bomberman solo <プレイヤー> puzzle <ステージ> にすると、メニューを通さずすぐ始めさせます。@p などのセレクターも使えます。
ゲーム設定コマンド（bomberman.admin）¶
各設定は実行直後に config へ保存されます。
一人練習モード
setminplayers 1 にすると、通常参加1人でも start できます。この場合は通常の勝敗判定を行わず、本人が全滅（爆風で脱落）するまで自由に爆弾を試せる 練習モード になります。終了は /bomberman stop で行います。記録が残る1人用の遊びは ソロモード を使ってください。
爆弾の秒数・初期火力はソロにも効きます
bomb-timer はソロ（CPU対戦・パズル）にも使われます。default-power・default-bombs は CPU対戦のプレイヤーの初期値です（パズルはステージの値を使います）。パズルは「既定の 2.5 秒」で解けることを確認しています。
config.yml 主要項目¶
| キー | 既定値 | 説明 |
|---|---|---|
settings.max-players |
8 | 最大参加人数（通常参加の人数。ソロで入った人は数えない） |
settings.min-players |
2 | 開始に必要な最小人数（1で一人練習モード可） |
settings.bomb-timer |
2.5 | 爆弾の起爆秒数 |
settings.default-power |
2 | 初期火力 |
settings.default-bombs |
1 | 初期の同時設置数 |
settings.sudden-death-time |
120 | サドンデス開始秒（0で無効） |
settings.soft-block-ratio |
75 | 軟ブロックの配置密度（%） |
settings.item-drop-chance |
35 | 軟ブロック破壊時のパワーアップ出現率（%） |
blocks.soft |
TERRACOTTA | 軟ブロックの種類 |
blocks.floor |
SMOOTH_STONE | 床ブロックの種類 |
powerups.<種別>.weight |
fire30 / bomb30 / speed25 / pierce8 / full7 | パワーアップの抽選重み |
- 硬ブロックは
IRON_BLOCK固定（config項目なし）。 locations（ロビー/スポーン/フィールド）とsignsはコマンド実行時に自動生成・保存されます。手動編集は不要です。
ソロ（solo.*）¶
| キー | 既定値 | 説明 |
|---|---|---|
solo.enabled |
true | false でソロを無効にする |
solo.countdown |
3 | 選んでから始まるまでの秒数 |
solo.result-seconds |
3 | 結果を出してからロビーへ戻すまでの秒数 |
solo.menu-delay |
3 | ロビーへ戻ってからソロメニューを開くまでの秒数 |
solo.broadcast-result |
true | クリアをサーバー全体に1行で流す |
solo.ranking-size |
10 | /bomberman ranking solo の表示人数 |
solo.cpu.sudden-death |
true | CPU対戦でもサドンデスを使う（開始秒は settings.sudden-death-time） |
solo.cpu.default-level |
normal | 難易度を省略したとき・ランキングの既定 |
solo.cpu.levels.<id>.* |
easy / normal / hard | CPU の難易度（下表）。並び順でメニューに並ぶ（最大8） |
solo.puzzle.time-limit |
180 | パズルの制限時間（秒。0で無制限） |
solo.puzzle.unlock |
true | 前のステージ／章をクリアすると次が遊べる（false で最初から全部遊べる。OP は常に全部遊べる） |
solo.puzzle.hint |
true | ヒントの本（スロット8）を配る |
blocks.puzzle-hard-soft |
BRICKS | パズルの硬いブロック（X）。軟ブロック・硬ブロックと同じ種類にはできない |
blocks.puzzle-no-bomb |
MAGMA_BLOCK | パズルの置けない床（_）。床と同じ種類にはできない |
levels.<id> のキー |
よわい | ふつう | つよい | 説明 |
|---|---|---|---|---|
display |
よわい | ふつう | つよい | 表示名 |
icon |
LIME_CONCRETE | YELLOW_CONCRETE | RED_CONCRETE | メニューのアイコン |
count |
1 | 2 | 3 | CPU の数（最大4） |
move-ticks |
8 | 6 | 5 | 1マス進む tick（小さいほど速い。プレイヤーの歩きは約5） |
think-ticks |
12 | 4 | 0 | 1マスごとに立ち止まる tick |
aggression |
30 | 60 | 90 | 相手を爆風に入れられる位置でボムを置く確率（%） |
dig |
60 | 80 | 90 | 軟ブロックを壊せる位置でボムを置く確率（%） |
hunt |
10 | 40 | 80 | 相手に近づこうとする強さ（0〜100） |
seek-items |
false | true | true | パワーアップを拾いに行くか |
power / bombs |
1 / 1 | 2 / 1 | 2 / 1 | CPU の初期火力・同時設置数 |
config は起動時に自動で更新されます
プラグインを更新すると、起動時に 足りない項目だけ が既存の config.yml に追加されます（設定済みの値・看板・地点はそのまま。更新前のファイルは config.yml.bak-日時 に退避され、コンソールに反映内容が出ます）。config.yml を消して作り直す必要はありません。puzzles.yml も同じ仕組みで、新しいステージが増えたときに追加されます。
ただし、CPU の難易度やパズルのステージを 消しても、次の起動で初期のものが戻ります。使わない難易度は残したままにするか、ソロ全体を solo.enabled: false で止めてください。
ロビー共通インベントリ（lobby-inventory）¶
ロビー入場時に入る前の所持品を退避してインベントリを空にし、ロビー退室時に復元する共通システムです。退避データは plugins/Bomberman/lobby-inventory.yml に自動保存され、サーバー再起動やクラッシュをまたいでも復元されます（試合の開始・終了では復元されず、ロビー在籍中はずっと空のまま）。
| キー | 既定値 | 説明 |
|---|---|---|
lobby-inventory.enabled |
true | falseでこの機能を丸ごと無効化（従来挙動に戻る） |
lobby-inventory.gamemode |
ADVENTURE | ロビー滞在中のゲームモード（ADVENTURE/SURVIVAL/CREATIVE/KEEP） |
lobby-inventory.clear-effects |
true | ロビー入場時にポーション効果を消す |
lobby-inventory.reset-health |
true | ロビー入場時に最大体力を既定へ戻し体力・満腹度を全回復 |
lobby-inventory.reset-exp |
true | ロビー入場時に経験値とレベルを0にする |
lobby-inventory.expire-days |
30 | 復元されずに残った退避データの保持日数 |
持ち物が戻らないときは /bomberman lobbyfix
まれに退避した持ち物が戻らないままになった場合は /bomberman lobbyfix <プレイヤー> で個別に復旧できます。force を付けると退避データを破棄してロックだけ解除します。
名前表示・参加通知（name-tag）¶
参加すると頭上ネームタグ・Tabリスト・チャットの名前が 【ゲーム名】名前 になり、離脱・ログアウト・プラグイン停止で元に戻ります。参加時にはサーバー全体へ参加通知を出します。
| キー | 既定値 | 説明 |
|---|---|---|
name-tag.enabled |
true | false で名前表示を付けない |
name-tag.display-name |
ボンバーマン | 【】 に入れる正式名 |
name-tag.color |
GOLD | 【ゲーム名】 の色（GOLD / AQUA / GREEN / RED / YELLOW など） |
name-tag.announce-join |
true | false でサーバー全体への参加通知を出さない |
統合版対応（bedrock）¶
Geyser / Floodgate 経由の統合版（Bedrock）プレイヤー向けの設定です。
| キー | 既定値 | 説明 |
|---|---|---|
bedrock.wax-signs |
true | 登録看板を蝋引きし、統合版でタップしても編集画面が開かないようにする |
bedrock.swing-to-use |
true | 統合版は空中タップ（腕振り）でもボムを足元に置けるようにする |
bedrock.sneak-to-bomb |
true | 統合版はスニーク（スニークボタン）でもボムを足元に置けるようにする |
bedrock.spectator-style |
AUTO | 観戦方式。AUTO＝統合版だけゴースト観戦／GHOST＝全員ゴースト／VANILLA＝全員観戦モード（統合版は観戦モードでHUDが消えるため AUTO 推奨） |
bedrock.name-prefix |
"." |
Floodgate が無いときに統合版と見なす名前の接頭辞 |
パズルのステージ（puzzles.yml）¶
初期は 6章・54ステージ です（第5章「組み合わせ」＝ギミック2種類以上、第6章「大きい盤面」＝11×11）。章ごとにステージ一覧のメニューが開き、前のステージをクリアすると次のステージ、前の章を決まった数クリアすると次の章が開きます（solo.puzzle.unlock。OP は解放に関係なく遊べます）。
chapters:
c2:
display: "かたいブロックと置けない床" # 表示名
icon: BRICKS # メニューのアイコン
description: "レンガは爆風2回で壊れる" # 説明
unlock-clears: 3 # 前の章を何ステージクリアすると開くか（0 で最初から）
stages:
p08:
chapter: c2 # 入る章
display: "ひび割れ" # 表示名
stars: 2 # 難しさ（1〜5。表示用）
power: 2 # 火力
bombs: 5 # 使えるボムの総数
max-active: 1 # 同時に置けるボムの数
par: 35 # ★2・★3 の目標タイム（秒。省略で bombs×5+10）
bomb-power: 2 # 置きボムの火力（省略で power と同じ）
hint: "レンガは1回目でひびが入って軟ブロックになり、もう1回で壊れます。"
map: # 記号は下の表
- "#######"
- "#S....#"
- "#.#.#.#"
- "#.x...#"
- "#x#x#.#"
- "#Xx.xx#"
- "#######"
solution: ["2,1", "3,1", "3,3", "3,3", "2,5"] # 解答（盤面の "x,z" を置く順に。左上が 0,0）
| 記号 | 意味 |
|---|---|
# |
硬ブロック（壊れない） |
x |
軟ブロック（全部壊すとクリア） |
X |
硬いブロック（blocks.puzzle-hard-soft。爆風1回目で軟ブロックになり、2回目で壊れる） |
. |
空き |
S |
スタート地点（1つだけ） |
o |
置きボム（光るTNT。時間では爆発せず、爆風が当たると誘爆する） |
+ |
火力アップ（ファイアチャージ。拾うと火力+1。消えない） |
_ |
ボムを置けない床（blocks.puzzle-no-bomb） |
- ステージは 章の順 → ファイルの並び順 に
章-番号（例2-3）が付きます（章は最大8・1章のステージは最大9）。 - ★：★1 クリア／★2
par秒以内／★3par秒以内かつヒントなし。記録はsolo-records.ymlのstarsに残ります。 solutionがあるステージだけ、ヒントの本（次に置く場所を光らせる）を配ります。解答は「火力アップは取りに行けるようになったらすぐ拾う」前提で書いてください。- 行の長さがそろっていない・S が1つでない・x/X が無い・使えない文字がある ステージは、起動時に警告を出して読み込みません。
- 初期の54ステージは、すべて ちょうど
bombs個で解ける（それより少ない数では解けない）ことと、solutionの手順で解けることをプログラムで確認しています（bomb-timer2.5秒）。盤面を変えたら必ず自分で解けるか試してください。 /bomberman reloadで読み直せます。ステージ名（p01等）を変えると、記録は別のステージとして扱われます。- 既存のサーバーでは、起動時に新しい章・ステージ・項目が
puzzles.ymlに自動で追加されます（前の版の7ステージは第1章になり、記録はそのまま残ります。★の記録が無い前の版のクリアは★1として数えます）。
権限ノード¶
| 権限 | 既定 | 用途 |
|---|---|---|
bomberman.admin |
OP | wand・menu・set系・stop・reload・setsign・removesign・lobbyfix・他人の join/leave/solo・ranking reset などの設定/管理、設定ツールの使用、看板の破壊 |
join / leave / start / status / solo / ranking は権限不要
/bomberman join・leave・start・status・solo・ranking solo は権限チェックがなく 全プレイヤーが実行可能 です（看板と同等）。設定・管理コマンドのみ bomberman.admin が必要です。
管理コマンド¶
| コマンド | 権限 | 説明 |
|---|---|---|
/bomberman join / leave / start |
全員 | 参加 / 退出 / 開始（看板と同等） |
/bomberman solo [cpu [難易度] \| puzzle <ステージ>] |
全員 | ソロメニュー／すぐ開始 |
/bomberman ranking solo [cpu [難易度] \| puzzle [ステージ]] |
全員 | ソロのランキング |
/bomberman status |
全員 | 設定・進行状況を表示（ソロの状況も） |
/bomberman wand |
bomberman.admin |
OP用の設定ツール（ブレイズロッド）を受け取る |
/bomberman menu |
bomberman.admin |
設定メニュー（GUI）を開く |
/bomberman stop |
bomberman.admin |
ゲームを強制終了（ソロも。コマンドブロック/コンソール可） |
/bomberman lobbyfix <プレイヤー> [force] |
bomberman.admin |
ロビーに入る前の持ち物が戻らないときの復旧。退避データを本人へ戻してロックを解除（force で退避データを破棄してロックだけ解除） |
/bomberman solo <プレイヤー> [cpu\|puzzle] [...] |
bomberman.admin |
指定した人をソロへ（コンソール・コマンドブロック可） |
/bomberman ranking reset <プレイヤー\|all> [cpu\|puzzle\|all] [難易度・ステージ\|all] |
bomberman.admin |
ソロ記録を消す（フィールドやステージを作り直したとき用） |
/bomberman reload |
bomberman.admin |
config・puzzles.yml の再読み込み＋看板の再ロード |
/bomberman set... / maxplayers |
bomberman.admin |
各種設定（前述） |
ソロの仕様メモ（共通ルールとの関係）¶
- ソロは共通ルール14章（GUIロビー）に従います。通常戦とアリーナを共用し、同時にどちらか1つだけ です。ソロ中に
/bomberman startを打つと理由を出して断り、通常戦の試合中はソロを始められません。 - 試合中（通常戦・ソロとも）の
/bomberman joinはロビー在籍として受け付け、次の試合から参加します（共通ルール12章）。ソロで入った人は通常戦の参加者に含めません。 /bomberman stop：ソロ中なら中断（記録なし）して挑戦者をロビーへ戻し、ソロメニューを開きます。カウントダウン中なら開始を取りやめます。結果表示中なら記録はそのまま、片付けを早めます。試合が無いときは「進行中の試合はありません」と出ます。- leave・切断・やり直し（時計）は「中断」で記録しません（1人なので脱落＝試合の終わり。負けそうで抜けても記録にならないようにするため）。共通ルール12章の例外です。
- CPU対戦の難易度を省略すると既定の難易度（ふつう）で始めます（共通ルール1章の例外。他ゲームのソロと同じ）。
- ロビー中はソロメニューのネザースター、ソロの試合中はやり直しの時計を1つ置きます（共通ルール6章の例外）。どちらも PDC で識別し、捨てる・移動・持ち替え・額縁／防具立てへの設置はできません。
- CPU は AI を切ったゾンビ（PDC 付き）をプラグインが1マスずつ動かしています。無敵で、日光で燃えず、変身せず、アイテムを拾わず、だれも攻撃しません。脱落は爆風（とサドンデスのブロック）の判定だけです。セーブされないので再起動で残らず、残っていても起動時・読み込み時に消えます。
- 進行のメッセージ・タイトルは挑戦者本人にだけ送ります。サーバー全体に流すのはクリアの結果1行だけです（
solo.broadcast-result）。 - 記録の時間はサーバーの tick で数えます（ラグがあっても表示とずれません）。
統合版（Geyser）について
ソロメニュー（チェスト画面）・ネザースター・時計は統合版でも使えます（空中タップ、ネザースターはスニークでも開く）。CPU（ゾンビ）は統合版でも表示されますが、通信の遅れで動きが少しカクつくことがあります。実機で見え方を確認してください。
トラブルシューティング¶
ゲームが開始できない
開始には 最小開始人数（既定2人・setminplayers で変更可）以上 の通常参加と、ロビー・初期スポーン・フィールド（1/2）・スポーン地点（人数分） がすべて設定されている必要があります。ソロ挑戦中は開始できません。/bomberman status で不足項目を確認してください。
スポーン地点でプレイヤーが落ちる／埋まる
フィールド生成で床・障害物の高さが決まるため、スポーンは 床の1つ上（立つ高さ） に置いてください。/bomberman status に問題のあるスポーンが赤で出ます。設定ツールを持つと、問題のあるスポーンが赤い粒子で見えます。CPU もスポーン地点に出るので同じです。
サドンデスの効果が薄い
外周（元々の硬い壁）からせり上がるため、最初の数リングは壁の上書きになります。フィールドが大きいほど中央が詰まるまで時間がかかります。setsuddendeath の秒数やフィールドサイズで調整してください。
パズルのステージが選べない（バリアになる）
フィールドが盤面より小さいと遊べません。メニューのボタンに必要な大きさが出ます。/bomberman status の「パズル」行に、このフィールドで遊べるステージ数が出ます。
パズルのステージが灰色（未解放）で選べない
前のステージ・前の章をクリアしていないためです（solo.puzzle.unlock）。OP は解放に関係なく遊べます。全部を最初から遊べるようにするなら solo.puzzle.unlock: false にして /bomberman reload。
CPU が少ない
CPU はスポーン地点の2番以降に出ます。スポーンが CPU の数＋1か所より少ないと、CPU を減らして始めます。setspawn 3・setspawn 4 を追加してください。
アナウンスが一部のプレイヤーに見えない
各種アナウンスはロビー在籍者に送られます。観戦のみ（未参加）のプレイヤーには表示されない設計です。ソロの進行メッセージは挑戦者本人だけに送られます。