Kakurenbo（かくれんぼ）― OP・運営ガイド¶

かくれんぼの導入・スポーン/フィールド設定・看板・擬態ブロック・config・権限をまとめます。

基本情報¶

項目	値
プラグイン名	Kakurenbo
メインコマンド	`/kakurenbo`（エイリアスなし）
依存プラグイン	なし
api-version	26.1.2
設定ファイル	`plugins/Kakurenbo/config.yml`（設定・メッセージ・擬態ブロック・看板テキスト）
地点ファイル	`plugins/Kakurenbo/locations.yml`（スポーン・看板位置。コマンドで自動保存）

仕組み

隠れる側は透明化し、自分に追従するフェイクブロック（クライアント側の表示ブロック）でブロックに擬態します。擬態ブロックは常に升目（プレイヤーの足元マス）にスナップしており、静止していれば同化、移動するとマス単位で追従します。鬼は配られる 雪玉を化けた隠れ側に当てて 捕獲し、捕まった側は猶予後に鬼へ転向します（増え鬼）。

導入手順¶

ビルドした Kakurenbo の jar を plugins/ に配置する。
サーバーを起動すると plugins/Kakurenbo/config.yml が生成される（地点は locations.yml に自動保存）。
後述の手順でスポーン・看板・擬態ブロックを設定する。
/kakurenbo status で設定状況を確認する。

設定ツール（おすすめ）¶

コマンドを打たずに、見ているブロック・看板へ直接セットアップできる OP用ツール（ブレイズロッド）と GUI メニューを用意しています。いずれも kakurenbo.admin 権限が必要で、非OPが入手しても使えません（受け取り時・使用時・メニューを開く時・クリック時のそれぞれで権限を確認します）。

OP用の設定ツール（ブレイズロッド）を受け取る

/kakurenbo wand

設定メニュー（GUI）を開く

/kakurenbo menu

かくれんぼに参加中は受け取れません

ロビー在籍中は持ち物が退室時の復元で上書きされるため、設定ツールは渡しません。先に /kakurenbo leave で離脱してから実行してください。

設定ツールの操作¶

操作	内容
左クリック／長押し（ブロック）	そのブロックをフィールド範囲の角1 にする
右クリック／タップ（ブロック）	そのブロックをフィールド範囲の角2 にする
右クリック／タップ（看板）	選んでいる看板モードで登録・解除する（モードなしなら登録状況を表示）
右クリック／タップ（空中）	設定状況の要約を表示（統合版は空中タップでも可）
しゃがみ＋左クリック／長押し（ブロック）	そのブロックを擬態パレットに追加（登録済みなら削除）
しゃがみ＋右クリック／タップ	設定メニューを開く（開かないときは `/kakurenbo menu`）

フィールド範囲は天井側も含めて囲む

角1・角2のブロックを含む直方体がフィールドです。両方を床のブロックにすると高さが1マスになり、参加者がジャンプした瞬間にフィールド外と判定されて動けなくなります。片方は床、もう片方は天井側（高い位置）のブロック にしてください。高さが4マス未満のときは設定ツールが注意を出します。

設定メニューでできること¶

区分	ボタン
地点（現在地で設定）	初期スポーン／ロビー／鬼スポーン（ソロのスタート地点）／隠れる側スポーン（任意）／鬼待機ステージ（任意）
表示	フィールド範囲（角1・角2・大きさ）／擬態パレット（登録数・中身）
看板モード	参加／離脱／開始／ブロック選択／鬼立候補／ソロ／登録解除／モード解除
数値（−／＋で即保存）	最大人数／最小人数／制限時間（30秒刻み）／隠れ時間（5秒刻み）
切り替え	ソロ「見つけて」の有効・無効（`solo.enabled`）
進行	ゲーム開始／強制停止（通常戦・ソロとも。在籍は維持）／設定状況を表示／閉じる／設定ツールを回収

統合版（スマホ・Switch など）

メニューは1tick遅らせて開き、数値は −／＋の別ボタンにしてタップでも操作できるようにしています。空中のタップが右クリックとして届かない場合は、腕振りだけでも設定状況を表示します。ブロックへの左クリックで壊れたように見えたブロックは送り直します。

セットアップ手順（コマンド）¶

OP権限（kakurenbo.admin）で、設定したい場所に 立って／対象を見て 実行します。地点は locations.yml に即保存されます。

① ロビー地点を現在地に設定

/kakurenbo setlobby

② 初期スポーン（離脱・終了時の戻り先）を現在地に設定

/kakurenbo setstartspawn

③ 鬼スポーンを現在地に設定

/kakurenbo setspawn seeker

④ 隠れ側スポーンを現在地に設定（任意）

/kakurenbo setspawn

⑤ 鬼の待機ステージを現在地に設定（任意・隠れ時間中の隔離地点）

/kakurenbo setstage

⑥ フィールド範囲の頂点1を現在地に設定（任意）

/kakurenbo setfield 1

⑥ フィールド範囲の頂点2を現在地に設定（任意）

/kakurenbo setfield 2

設定状況を確認

/kakurenbo status

ロビー・スポーンの配置に注意

隠れ側スポーン（setspawn）が未設定の場合、隠れ側は ロビー位置からそのまま擬態を開始 します。ロビーがフィールドから離れていると擬態がフィールド外で始まってしまうため、ロビーをフィールド内に置くか、setspawn（隠れ側スポーン）を設定してください。フィールド範囲（setfield 1/2）を設定すると、その範囲外へは移動できなくなります（未設定なら制限なし）。

鬼の待機ステージ（setstage）

隠れ時間中、鬼は 待機ステージ に隔離され足止めされます。setstage が未設定の場合は鬼スポーン（setspawn seeker）の位置で待機し、探索フェーズ開始時に鬼スポーンへ解き放たれます。隠れ側に化け場所を覗かれたくない場合は、フィールドから離れた地点を setstage に設定してください。

数値設定（コマンドで即保存）¶

人数や各タイマーは config を直接編集しなくてもコマンドで変更でき、即 config.yml に保存されます。

最大参加人数を設定

/kakurenbo setmax <人数>

開始に必要な最小人数を設定

/kakurenbo setmin <人数>

制限時間（秒）を設定

/kakurenbo settime <秒>

隠れ時間（秒）を設定

/kakurenbo setdelay <秒>

擬態ブロックパレットの登録¶

隠れる側が化けられるブロックの一覧を登録します。化けさせたいブロックを 手に持って 実行します（config の blocks に保存されます）。

手持ちブロックを擬態パレットに追加

/kakurenbo addblock

手持ちブロックを擬態パレットから削除

/kakurenbo removeblock

既定パレットは STONE / OAK_LOG / GRASS_BLOCK / COBBLESTONE / OAK_PLANKS です。マップに合うブロックを登録してください（未登録だと隠れ側が化けられません）。

看板の設置¶

参加・離脱・開始・ブロック選択・鬼立候補・ソロの 6種の看板を登録できます。看板を見ながら（5ブロック以内）以下を実行します。

参加看板を登録

/kakurenbo setsign join

離脱看板を登録

/kakurenbo setsign leave

開始看板を登録

/kakurenbo setsign start

擬態ブロック選択看板を登録（隠れ側が右クリックでGUIを開く）

/kakurenbo setsign block

鬼立候補看板を登録（クリックで鬼に立候補・任意）

/kakurenbo setsign oni

ソロ看板を登録（クリックでソロメニュー）

/kakurenbo setsign solo

登録済み看板の登録を解除（視線先の看板を自動判別）

/kakurenbo setsign delete

テキストはプラグインが自動で書き込み（config の sign.* から描画）、位置は locations.yml に保存されます。クリック判定は保存位置との一致で行います。

鬼立候補看板（setsign oni）

ロビー参加者がクリックすると 鬼に立候補（もう一度クリックで取り消し）。看板の4行目に現在の立候補人数（%count%）が表示されます。開始時は立候補者から優先的に鬼を抽選し、不足分はランダム指名で補います。未設置でも従来どおり全員ランダムで鬼が決まります。

ソロモード「見つけて」の設定¶

フィールド（setfield 1/2）・擬態パレット（addblock）・鬼スポーン（setspawn seeker）は通常戦と共用です。設定済みなら、追加の作業は ソロ看板の設置だけ です。

ソロ看板を登録（看板を見ながら）

/kakurenbo setsign solo

設定を確認

/kakurenbo status

自分で試す（かんたん）

/kakurenbo solo easy

ソロ看板の4行目には「空き／ソロ挑戦中／通常戦中」が自動で表示されます。
スタート地点は 鬼スポーン（未設定ならロビー）です。CPU はスタート地点から solo.min-distance-from-spawn（既定10ブロック）以上離れた所に隠れます。
CPU は 挑戦者にだけ見える見た目のブロック で、ワールドのブロックは変えません。サーバーが止まっても残骸は残りません。
挑戦中は「見た目だけのブロック」の上に乗っても飛行キックされないよう、挑戦者だけ飛行を許可 しています（実際に飛ぶ操作は止めています）。

CPU の隠れ場所が足りないとき

CPU は パレットのブロックに化けます。むずかしい（blend: strict）は「周り6マスのうち3マス以上が同じパレットのブロック」の場所にしか隠れません。フィールドの床・壁にパレットのブロックを使ってください。
鬼スポーンがフィールドの中央にあると、近くに隠れられない分だけ場所が減ります。solo.min-distance-from-spawn を下げてください。
フィールドが広いときは solo.placement-attempts を増やしてください。
置けた数が足りないときは、置けた数で始まり挑戦者に知らせます（1体も置けないと開始しません）。

ソロの記録を消す¶

プレイヤーの「ふつう」の記録を消す（コンソール可）

/kakurenbo ranking reset <プレイヤー> normal

全員・全難易度の記録を消す（コンソール可）

/kakurenbo ranking reset all all

記録は plugins/Kakurenbo/solo-records.yml に保存されます（自動更新の対象外）。

config.yml 主要項目¶

game セクション¶

キー	既定値	説明
`game.min-players`	2	開始に必要な最小人数
`game.max-players`	16	最大参加人数
`game.countdown-time`	10	開始前カウントダウン（秒）
`game.hiding-time`	30	隠れ時間（この間鬼は足止め）（秒）
`game.match-duration`	300	制限時間（秒）
`game.conversion-delay`	3	捕獲から鬼へ転向するまでの猶予（秒）
`game.seeker-ratio`	8	何人につき鬼1人か（切り上げ・最低1人・最大 n-1）
`game.snap-interval-ticks`	2	擬態ブロックの追従（升目スナップ）判定を行う間隔（tick）
`game.snap-idle-ms`	300	予約キー（現行ロジックでは未使用。擬態ブロックは常時升目にスナップされます）
`game.result-seconds`	10	結果発表を表示してからロビーへ戻すまでの秒数

数値はコマンドでも変更できます

min-players / max-players / match-duration / hiding-time は、それぞれ /kakurenbo setmin / setmax / settime / setdelay でゲーム内から変更でき、即 config.yml に保存されます。

disguise セクション（隠れ側の擬態アイテム）¶

キー	既定値	説明
`disguise.item-material`	`STICK`	擬態ステッキのアイテム種別
`disguise.item-name`	`&b擬態ステッキ …`	擬態ステッキの表示名
`disguise.release-hold-ticks`	20	スニーク長押しで擬態解除に必要な tick（20=約1秒）

seeker セクション（鬼の捕獲アイテム）¶

キー	既定値	説明
`seeker.snowball-amount`	16	鬼に配る雪玉の数（投擲後に自動補充）
`seeker.snowball-name`	`&f雪玉 …`	雪玉の表示名

firework セクション（隠れ側の花火アイテム）¶

隠れる側に配られる花火（ホットバー2番目・無限使用）の設定です。擬態中にスロットを選ぶと打ち上がり、位置の自己申告・演出に使えます。

キー	既定値	説明
`firework.item-material`	`FIREWORK_ROCKET`	花火アイテムの種別
`firework.item-name`	`&d花火 …`	花火アイテムの表示名
`firework.cooldown-seconds`	3	手動打ち上げの連打防止クールダウン（秒・0で無効）
`firework.forced-interval-seconds`	60	鬼が動き出してから、隠れ側全員の花火を強制で一斉に打ち上げる間隔（秒・0で無効）
`firework.power`	1	打ち上げの高さ（飛行時間 0〜3）
`firework.colors`	10色	打ち上げ色のリスト（毎回ランダム）。染料色名または `#RRGGBB`
`firework.types`	`BALL_LARGE` ほか	形のリスト（ランダム）: `BALL` / `BALL_LARGE` / `STAR` / `BURST` / `CREEPER`
`firework.flicker`	`true`	きらめき効果
`firework.trail`	`true`	尾を引く効果
`firework.sound`	`entity.firework_rocket.launch`	打ち上げ時に追加で鳴らす音（`""`で追加音なし・バニラ破裂音は常に鳴る）
`firework.sound-volume`	3.0	追加音の音量（3.0でおよそ48ブロック先まで）
`firework.sound-pitch`	1.0	追加音のピッチ

reveal セクション（終盤の擬態ブロック公開）¶

残り時間が一定以下になると、隠れ側の擬態ブロックを 発光・パーティクル で鬼にわかるようにして膠着を防ぎます。

キー	既定値	説明
`reveal.seconds-left`	60	残り何秒から擬態ブロックを光らせるか（0で無効）
`reveal.glow-color`	`#FF5555`	発光色（Java版の輪郭・パーティクル色）。染料色名または `#RRGGBB`
`reveal.particle`	`true`	擬態ブロック上にパーティクルを出す（統合版は発光が見えないための代替）
`reveal.blink-block`	`REDSTONE_BLOCK`	統合版の閲覧者にだけ擬態ブロックと交互に点滅表示するブロック（発光が見えない統合版向け）
`reveal.blink-ticks`	10	点滅の切り替え間隔（tick・20=1秒）

solo セクション（ソロモード「見つけて」）¶

キー	既定値	説明
`solo.enabled`	`true`	false でソロを無効（メニュー・看板・コマンドとも開始不可）
`solo.menu-delay`	3	試合後、ロビーへ戻してからソロメニューを開くまでの秒数
`solo.hide-seconds`	5	CPU が隠れる時間（秒）。この間挑戦者は動けない
`solo.reach`	5.0	叩いて届く距離（ブロック）
`solo.miss-cooldown`	0.5	お手つきを数える最短間隔（秒）
`solo.find-score`	100	CPU を1体見つけたときの点数
`solo.time-bonus-per-second`	2	クリア時、残り1秒あたりに加える点数
`solo.placement-attempts`	1500	隠れ場所を探す回数（フィールドの列を調べる回数）
`solo.min-distance-from-spawn`	10	スタート地点からこのブロック数以内には隠れない
`solo.block-when-lobby-waiting`	`false`	true で、通常戦の待機者がいる間はソロ不可
`solo.broadcast-result`	`true`	結果をサーバー全体に1行流す
`solo.ranking-size`	10	`/kakurenbo ranking solo <難易度>` の表示人数

難易度は solo.modes.<名前> で追加・削除できます（名前が /kakurenbo solo <名前> になる。. は使えない）。メニューに出せるのは7つまでです。

キー	easy	normal	hard	説明
`display`	`&aかんたん`	`&eふつう`	`&cむずかしい`	表示名
`icon`	`GRASS_BLOCK`	`OAK_LOG`	`STONE_BRICKS`	メニューのアイコン
`cpu-count`	3	5	7	CPU の数
`time`	180	180	240	制限時間（秒）
`blend`	`random`	`neighbor`	`strict`	化けるブロックの選び方
`blend-min`	3	3	3	strict のとき周り6マスで必要な同じブロックの数
`spots`	`floor`	`floor`	`any`	`floor`＝床の上だけ／`any`＝床の上＋壁のくぼみ
`min-spacing`	8	6	4	CPU どうしの最小距離
`hint-interval`	30	45	60	ヒントの花火の間隔（秒・0でなし）
`reveal-seconds`	60	30	0	残り何秒から光らせるか（0でなし）
`miss-penalty`	20	20	30	お手つき1回の減点

終盤に光るときの色・点滅は通常戦と同じ reveal.glow-color / reveal.particle / reveal.blink-block / reveal.blink-ticks を使います。ヒントの花火の色・形は firework.* を使います（打ち上げ音は挑戦者にだけ鳴らします）。
既存サーバーでは、起動時に solo 一式・sign.solo・messages.solo-* が自動で追記されます（既存の値は変えません）。solo.modes は一度作られた後は中身を補完しません（消した難易度が復活しないように）。

blocks / messages / sign / gui¶

blocks … 擬態パレット（addblock / removeblock で編集・自動保存）。
messages … 各種通知文（& カラーコード対応）。prefix ほか役割通知・捕獲・残り時間・鬼立候補・花火（firework-cooldown / firework-forced）・終盤公開（reveal-start）・ロビー参加/退出ブロードキャストなど。
sign.{lobby,leave,start,block,oni,solo} … 各看板の表示文。参加看板の4行目は %current%/%max% で通常戦の人数（待機＋試合中）、鬼立候補看板の4行目は %count% で立候補人数、ソロ看板の4行目は %state% で状態を表示。
messages.solo-* … ソロモードの通知文（メニュー名・開始・発見・お手つき・ヒント・結果・全体告知など）。
gui.block-select-title … ブロック選択GUIのタイトル。

config は不足キーを自動追記します

起動時および /kakurenbo reload 時に、config.yml へ不足している項目を既定値＋コメント付きで自動追記します（既存の値は変更せず、更新があった場合は config.yml.bak を保存）。このため firework / reveal などの新セクションも、既存サーバーで自動的に補完されます。座標・看板などのデータ領域（locations.yml）は補完対象外で、コマンドで保存されます。

権限ノード¶

権限	既定	用途
`kakurenbo.admin`	OP	wand・menu・setsign系・setlobby・setspawn系・setstage・setfield・setmax・setmin・settime・setdelay・addblock・removeblock・stop・reload・forceunlock・join/leave/solo の他プレイヤー指定・ranking reset
`kakurenbo.play`	全員	ゲームへの参加（`join`）

join / leave / start / status / solo / ranking は権限不要で全員可

/kakurenbo join・leave・start・status・solo・ranking は権限チェックがなく全プレイヤーが使えます（看板と同等）。ただし join <名前> / leave <名前> のように 他プレイヤーを指定 する場合のみ kakurenbo.admin が必要です。設定・管理コマンドも kakurenbo.admin が必要です。

管理コマンド¶

コマンド	権限	説明
`/kakurenbo join [名前]` / `leave [名前]` / `start`	全員（名前指定は admin）	参加 / 退出 / 開始（看板と同等。名前指定で他プレイヤーを操作）
`/kakurenbo status`	全員	設定状況・進行状態を表示（読み取り専用）
`/kakurenbo solo [難易度]`	全員	ソロ「見つけて」のメニューを開く／難易度を付けると即開始
`/kakurenbo ranking [solo] [難易度]`	全員	ソロのランキング
`/kakurenbo solo <プレイヤー> [難易度]`	`kakurenbo.admin`	指定した人をソロへ（コンソール・コマンドブロック可）
`/kakurenbo ranking reset <プレイヤー\\|all> [難易度\\|all]`	`kakurenbo.admin`	ソロの記録を消す（コンソール可）
`/kakurenbo wand`	`kakurenbo.admin`	OP用の設定ツール（ブレイズロッド）を受け取る（参加中は不可）
`/kakurenbo menu`	`kakurenbo.admin`	設定メニュー（GUI）を開く
`/kakurenbo setlobby` / `setstartspawn`	`kakurenbo.admin`	ロビー / 初期スポーンを設定
`/kakurenbo setspawn [seeker]`	`kakurenbo.admin`	隠れ側スポーン（引数なし）／鬼スポーン（`seeker`）を設定
`/kakurenbo setstage`	`kakurenbo.admin`	鬼の待機ステージ（隠れ時間中の隔離地点）を設定
`/kakurenbo setfield <1\\|2>`	`kakurenbo.admin`	フィールド範囲の頂点を設定（立っているマスが角になる。設定ツールならクリックしたブロック）
`/kakurenbo setsign <join\\|leave\\|start\\|block\\|oni\\|solo\\|delete>`	`kakurenbo.admin`	視線先の看板を各用途で登録 / 解除
`/kakurenbo setmax` / `setmin <人数>`	`kakurenbo.admin`	最大 / 最小人数を設定
`/kakurenbo settime <秒>` / `setdelay <秒>`	`kakurenbo.admin`	制限時間 / 隠れ時間を設定
`/kakurenbo addblock` / `removeblock`	`kakurenbo.admin`	手持ちブロックを擬態パレットに追加 / 削除
`/kakurenbo stop`	`kakurenbo.admin`	強制停止（通常戦・ソロとも）。勝敗・記録なしで止め、在籍者をロビーへ戻す（在籍は解除しない）。ソロ挑戦者にはソロメニューを開き直す
`/kakurenbo reload`	`kakurenbo.admin`	config を再読み込み
`/kakurenbo forceunlock <プレイヤー>`	`kakurenbo.admin`	他ゲーム参加中フラグが異常に残った場合の強制解除（コンソール可）

トラブルシューティング¶

ゲームが開始できない

参加者が game.min-players（既定2人）以上か /kakurenbo status で確認してください。

隠れ側が化けられない／「擬態ブロックが登録されていません」と出る

擬態パレットが空です。化けさせたいブロックを手に持って /kakurenbo addblock で登録してください（既定で5種登録済み）。

隠れ側がフィールド外で始まってしまう

隠れ側スポーン未設定だとロビー位置から擬態が始まります。/kakurenbo setspawn（隠れ側スポーン）を設定するか、ロビーをフィールド内に配置してください。

ソロが始められない（メニューのボタンがバリアになっている）

ボタンの説明に理由が出ます。「アリーナを使用中」は通常戦（カウントダウン・結果発表を含む）か、ほかの人のソロ挑戦が終わるまで待ってください。「フィールドが未設定」は setfield 1/2、「擬態ブロックが未登録」は addblock を行ってください。

ソロで「CPU の隠れ場所が見つかりません」と出る

上の「CPU の隠れ場所が足りないとき」を確認してください。フィールドのチャンクが読み込まれていない場所は調べないため、挑戦者の近くにフィールドがあることも条件です。

看板をクリックしても反応しない

看板は /kakurenbo setsign <種別> で登録した位置で判定されます。登録済みか /kakurenbo status で確認してください（手書きでは機能しません）。

全ゲーム共通の改修（2026-09）¶

全ミニゲーム共通の改修が入り、本ゲームにも適用されています。

名前表示 … 参加中はチャット名・Tabリスト名・頭上の名札が「【ゲーム名】名前」になり、離脱で元に戻ります（表示名は config の display-name）。
参加/離脱の全体告知 … 参加・離脱時にサーバー全体へ「【ゲーム名】名前が参加しました (N人)」等を通知します。
同時参加は1ゲームまで … 他ゲームに参加中は参加が拒否されます（「【○○】に参加中です」）。異常で参加ロックが残った場合はOPが /<コマンド> forceunlock <プレイヤー> で解除できます。
退避データのファイル保存 … ロビー入場時に退避した所持品を plugins/<プラグイン>/vault/<UUID>.yml に保存し、サーバークラッシュ後の再ログインでも復元 します（退避・復元は各1回、試合終了時は復元しません）。

追加された config キー¶

キー	説明
`display-name`	ゲーム表示名（「【…】」の中身）
`messages.join-broadcast`	参加の全体告知文
`messages.leave-broadcast`	離脱の全体告知文
`messages.already-in-other-game`	他ゲーム参加中に拒否したときの文言

config は自動で追記されるようになりました

起動時（reload 対応プラグインは reload 時も）に、config.yml へ不足している項目を既定値＋コメント付きで自動追記します（既存の値は変更しません／更新時は config.yml.bak を保存）。座標・看板・会場・ステージなどのデータ領域（locations.yml）は補完対象外です。

← 👤 プレイヤー向けページへ ← Kakurenbo 概要へ