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権限（kakurenbo.admin）で、設定したい場所に 立って／対象を見て 実行します。地点は locations.yml に即保存されます。
ロビー・スポーンの配置に注意
隠れ側スポーン（setspawn）が未設定の場合、隠れ側は ロビー位置からそのまま擬態を開始 します。ロビーがフィールドから離れていると擬態がフィールド外で始まってしまうため、ロビーをフィールド内に置くか、setspawn（隠れ側スポーン）を設定してください。フィールド範囲（setfield 1/2）を設定すると、その範囲外へは移動できなくなります（未設定なら制限なし）。
鬼の待機ステージ（setstage）
隠れ時間中、鬼は 待機ステージ に隔離され足止めされます。setstage が未設定の場合は鬼スポーン（setspawn seeker）の位置で待機し、探索フェーズ開始時に鬼スポーンへ解き放たれます。隠れ側に化け場所を覗かれたくない場合は、フィールドから離れた地点を setstage に設定してください。
数値設定（コマンドで即保存）¶
人数や各タイマーは config を直接編集しなくてもコマンドで変更でき、即 config.yml に保存されます。
擬態ブロックパレットの登録¶
隠れる側が化けられるブロックの一覧を登録します。化けさせたいブロックを 手に持って 実行します（config の blocks に保存されます）。
既定パレットは STONE / OAK_LOG / GRASS_BLOCK / COBBLESTONE / OAK_PLANKS です。マップに合うブロックを登録してください（未登録だと隠れ側が化けられません）。
看板の設置¶
参加・離脱・開始・ブロック選択・鬼立候補の 5種 の看板を登録できます。看板を見ながら（5ブロック以内）以下を実行します。
テキストはプラグインが自動で書き込み（config の sign.* から描画）、位置は locations.yml に保存されます。クリック判定は保存位置との一致で行います。
鬼立候補看板（setsign oni）
ロビー参加者がクリックすると 鬼に立候補（もう一度クリックで取り消し）。看板の4行目に現在の立候補人数（%count%）が表示されます。開始時は立候補者から優先的に鬼を抽選し、不足分はランダム指名で補います。未設置でも従来どおり全員ランダムで鬼が決まります。
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雪玉 … |
雪玉の表示名 |
blocks / messages / sign / gui¶
blocks… 擬態パレット（addblock/removeblockで編集・自動保存）。messages… 各種通知文（&カラーコード対応）。prefixほか役割通知・捕獲・残り時間・鬼立候補・ロビー参加/退出ブロードキャストなど。sign.{lobby,leave,start,block,oni}… 各看板の表示文。参加看板の4行目は%current%/%max%で人数、鬼立候補看板の4行目は%count%で立候補人数を表示。gui.block-select-title… ブロック選択GUIのタイトル。
既存サーバーは config が自動追記されません
本プラグインは saveDefaultConfig() のみで、既存の config.yml に新キーを自動追記しません（コード側に既定値があるため動作はします）。メッセージ等を調整する場合は手動追記、または config を退避して再生成してください。地点・看板は locations.yml にコマンドで保存されます。
権限ノード¶
| 権限 | 既定 | 用途 |
|---|---|---|
kakurenbo.admin |
OP | setsign系・setlobby・setspawn系・setstage・setfield・setmax・setmin・settime・setdelay・addblock・removeblock・stop・reload・join/leave の他プレイヤー指定 |
kakurenbo.play |
全員 | ゲームへの参加（join） |
join / leave / start / status は権限不要で全員可
/kakurenbo join・leave・start・status は権限チェックがなく全プレイヤーが使えます（看板と同等）。ただし join <名前> / leave <名前> のように 他プレイヤーを指定 する場合のみ kakurenbo.admin が必要です。設定・管理コマンドも kakurenbo.admin が必要です。
管理コマンド¶
| コマンド | 権限 | 説明 |
|---|---|---|
/kakurenbo join [名前] / leave [名前] / start |
全員（名前指定は admin） | 参加 / 退出 / 開始（看板と同等。名前指定で他プレイヤーを操作） |
/kakurenbo status |
全員 | 設定状況・進行状態を表示（読み取り専用） |
/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\|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 を再読み込み |
トラブルシューティング¶
ゲームが開始できない
参加者が game.min-players（既定2人）以上か /kakurenbo status で確認してください。
隠れ側が化けられない／「擬態ブロックが登録されていません」と出る
擬態パレットが空です。化けさせたいブロックを手に持って /kakurenbo addblock で登録してください（既定で5種登録済み）。
隠れ側がフィールド外で始まってしまう
隠れ側スポーン未設定だとロビー位置から擬態が始まります。/kakurenbo setspawn（隠れ側スポーン）を設定するか、ロビーをフィールド内に配置してください。
看板をクリックしても反応しない
看板は /kakurenbo setsign <種別> で登録した位置で判定されます。登録済みか /kakurenbo status で確認してください（手書きでは機能しません）。