DorokeiGame ― OP・運営ガイド¶
DorokeiGame の導入・会場（ロビー＋エリア）の設定・config・権限・管理コマンドをまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | DorokeiGame |
| バージョン | 3.1（コマンド統合・簡略化版） |
| api-version | 26.1.2 |
| 作者 | へんりー |
| メインコマンド | /dorokei（エイリアス /dk） |
| 依存プラグイン | なし |
| 設定ファイル | plugins/DorokeiGame/config.yml |
最新アップデートの変更点（ラッキーチェスト＆逃走者支援アイテム）
逃走者（市民）を支援する ラッキーチェスト が追加されました。マップ上のチェスト・トラップチェスト・樽を会場に登録すると、市民が右クリックした際にランダムで支援アイテムを入手できます（警官・収監中は利用不可）。あわせて次が追加されています。
- ラッキーチェストの登録／解除 …
/dorokei setchest（視線先のチェストを登録）・/dorokei setchest clear（全解除）。 - 逃走者支援アイテム5種 … スピードポーション／跳躍のお守り／蜘蛛の巣トラップ／鈍足の罠／レーダージャマー（加えて予備の煙幕玉・緊急テレポート用エンダーパールが抽選で出現）。
config.ymlのchest-settings… 再開封クールダウン（cooldown-seconds）と出現重み付きルートテーブル（loot）を設定可能。/dorokei statusにラッキーチェストの登録数を表示。
会場運用について（単一会場方式）
会場は 1サーバー1会場（単一会場）方式 です。セットアップ・看板・開始コマンドから ゲーム名の指定は不要 です。牢屋は複数登録可（/dorokei setjail / setjail clear）、人数別の警官数は /dorokei setcop <人数> <警官数> で上書きでき、/dorokei status で設定状況を確認できます。
旧コマンド（start / setpolice / settime）は廃止されました
以前後方互換として残っていた /dorokei start / setpolice / settime の各コマンドは 廃止 されました。実行すると「不明なサブコマンドです」と表示されます。運営は新方式のコマンド（gamestart / setcop など）を使用してください。
導入手順¶
- ビルドした
DorokeiGameの jar ファイルをサーバーのplugins/フォルダに配置する。 - サーバーを起動・再起動すると
plugins/DorokeiGame/config.ymlが自動生成される。 - 後述の手順でゲーム（ロビー＋エリア）を設定する。
- 必要に応じて
config.ymlを直接編集し、サーバーを再起動して反映する。
config の反映について
本プラグインには config 再読み込み用のコマンドがありません。config.yml を手で編集した場合は サーバーの再起動 で反映してください。なお setstartspawn / setlobby / setfield / setjail / setchest / setcop / delete 系コマンドで変更した内容は即座にファイルへ保存され、ゲームインスタンスへも即時反映されます（chest-settings の出現重み・クールダウンを手動編集した場合のみ再起動が必要です）。
config.yml 設定項目¶
| キー | 既定値 | 説明 |
|---|---|---|
version |
"3.1" | 設定ファイルのバージョン |
spawn-location |
world / 0,64,0 | 初期リスポーン地点。ログアウト時に戻り先が不明な場合に使用 |
games |
{} |
会場定義。単一会場（内部名 main）で管理され、セットアップコマンドで自動的に追加される |
games.main.lobby |
— | 待機ロビー定義。world / x / y / z / yaw / pitch / max-players（既定20） |
games.main.area |
— | ゲームエリア定義。world / pos1 / pos2 / jails（牢屋座標のリスト） / luck-chests（ラッキーチェスト座標のリスト） |
games.main.area.luck-chests |
— | ラッキーチェストの座標リスト。/dorokei setchest で自動追加される |
signs |
{} |
登録済み看板（参加 / 離脱 / 開始）。setsign / setstart で自動追加され、再起動後も復元される |
game-settings.game-time |
480 | ゲーム時間（秒）。既定8分 |
game-settings.escape-preparation-time |
30 | 逃走準備時間（秒）。この間は警官が動けない |
chest-settings.cooldown-seconds |
45 | 同じラッキーチェストの再開封クールダウン（秒） |
chest-settings.loot |
7種の既定テーブル | ラッキーチェストの出現アイテム。item（アイテムキー）と weight（出現重み・大きいほど出やすい）のリスト |
cop-allocation |
2〜20の対応表 | プレイヤー数ごとの警官人数の割り振り表（/dorokei setcop で上書き可能） |
defaults.cop-count |
1 | フォールバック用の既定警官人数 |
defaults.game-time |
300 | フォールバック用の既定ゲーム時間（秒） |
牢屋（jails）は複数登録に対応
games.main.area.jails は牢屋座標の リスト で、/dorokei setjail を実行するたびに1か所ずつ追加されます。旧形式の単一 jail: { x:.., y:.., z:.. } も引き続き読み込めます。座標は手動編集よりもセットアップコマンドでの登録を推奨します。
games セクションの構造例¶
games:
main:
lobby:
world: world
x: 0.0
y: 64.0
z: 0.0
yaw: 0.0
pitch: 0.0
max-players: 20
area:
world: world
pos1: { x: 100.0, y: 60.0, z: 100.0 }
pos2: { x: 200.0, y: 80.0, z: 200.0 }
jails:
- { x: 150.0, y: 65.0, z: 150.0 }
- { x: 160.0, y: 65.0, z: 140.0 }
luck-chests:
- { x: 120.0, y: 64.0, z: 130.0 }
- { x: 180.0, y: 64.0, z: 170.0 }
警官の自動割り振り（cop-allocation）¶
参加人数に応じて警官の人数を自動決定します。既定の対応表は次のとおりです。
| 参加人数 | 警官数 | 参加人数 | 警官数 |
|---|---|---|---|
| 2〜4人 | 1人 | 12〜14人 | 5人 |
| 5〜6人 | 2人 | 15〜17人 | 6人 |
| 7〜8人 | 3人 | 18〜20人 | 7人 |
| 9〜11人 | 4人 |
割り振りはコマンドでも上書きできます。
対応表にない人数のとき
cop-allocation に該当する人数の項目がない場合は、内部のフォールバック計算（約35%目安）で警官数が決定されます。21人以上の場合も内部計算で7人になります。/dorokei setcop <人数> <警官数> で個別に上書きすると、その人数のときの警官数を固定できます（警官数は1以上かつ参加人数未満で指定）。
ラッキーチェスト（chest-settings）¶
逃走者（市民）専用のラッキーチェストの挙動を設定します。チェストの 設置場所 は config.yml を直接編集せず、ゲーム内で /dorokei setchest を使って登録してください（後述）。出現アイテムの内容や確率はこの chest-settings で調整します。
| キー | 既定値 | 説明 |
|---|---|---|
chest-settings.cooldown-seconds |
45 | 同じチェストを再度開けられるようになるまでの秒数 |
chest-settings.loot |
下表の7種 | 出現アイテムのリスト。各要素は item（アイテムキー）と weight（出現重み） |
ルートテーブルの既定値と各アイテムキーは次のとおりです。weight が大きいほど出やすくなります。
item キー |
アイテム | 既定 weight |
効果 |
|---|---|---|---|
speed_potion |
スピードポーション | 10 | 10秒間 速度II |
jump_charm |
跳躍のお守り | 10 | 15秒間 跳躍III |
smoke_bomb |
予備の煙幕玉 | 8 | 配布と同じ煙幕玉を補充 |
ender_escape |
緊急テレポート | 5 | エンダーパール（バニラ動作） |
cobweb_trap |
蜘蛛の巣トラップ | 5 | 足元に蜘蛛の巣を設置（約8秒で消滅） |
slow_trap |
鈍足の罠 | 5 | 周囲6m以内の警官を4秒間 鈍足 |
radar_jammer |
レーダージャマー | 4 | 全警官の追跡コンパスを20秒間 無効化 |
chest-settings:
cooldown-seconds: 45
loot:
- { item: speed_potion, weight: 10 }
- { item: jump_charm, weight: 10 }
- { item: smoke_bomb, weight: 8 }
- { item: ender_escape, weight: 5 }
- { item: cobweb_trap, weight: 5 }
- { item: slow_trap, weight: 5 }
- { item: radar_jammer, weight: 4 }
loot 未設定でも動作します
chest-settings.loot が未設定（または空）の場合は、上表の組み込み既定テーブルで動作します。特定のアイテムを出さないようにしたい場合は、その行を削除するか loot を書き換えてサーバーを再起動してください。
セットアップ手順（単一会場）¶
専用ワールドを用意し、OP権限で以下のコマンドを 設定したい地点に立って 実行します（実行位置が座標として保存されます）。会場は1つ（内部名 main）なので、ゲーム名の指定は不要です。
設定の流れは次のとおりです。
/dorokei setstartspawnで初期リスポーン地点を設定する。- ロビーにする場所に立ち
/dorokei setlobbyを実行する（ロビーの既定上限は20人。config.ymlのgames.main.lobby.max-playersを手動で書き換えれば変更可能）。 - エリアの角1に立ち
/dorokei setfield 1、対角の角2に立ち/dorokei setfield 2を実行する（pos1/pos2 がそろうとエリアサイズがチャットに表示されます）。 - 牢屋にする場所に立ち
/dorokei setjailを実行する。必要なら別の場所で繰り返し実行して牢屋を増やせます。 - （任意）マップ上にチェスト・トラップチェスト・樽を設置し、それを見ながら
/dorokei setchestを実行してラッキーチェストを登録する。別のチェストで繰り返すと複数登録できます。 /dorokei statusで4点（ロビー / pos1 / pos2 / 牢屋）・ラッキーチェスト・看板の設定状況を確認する。
ラッキーチェストは任意設定です
ラッキーチェスト（/dorokei setchest）は会場成立の必須条件ではありません。未登録でもゲームは開始でき、その場合は逃走者支援アイテムが手に入らないだけです。設置するとゲーム性が大きく変わるので、会場に合わせて数か所登録するのがおすすめです。
次のステップが自動で案内されます
各セットアップコマンドの実行後、未設定の項目（lobby / pos1 / pos2 / jail）がチャットに表示されます。4点すべてがそろうと「セットアップが完了しました!」と通知され、/dorokei gamestart で開始できる旨が案内されます。
pos1 / pos2 のワールドは一致が必須
pos1 と pos2 が異なるワールドにあるとセットアップが拒否されます。先に登録した方と同じワールドで取り直してください。
看板の設置¶
プレイヤーがロビーへ参加するための看板をコマンドで登録します。看板を設置し、看板を見ながら以下のコマンドを実行してください（テキストはプラグインが自動で書き込みます）。
手書き登録は廃止済み
以前の方式（参加看板に [Dorokei]/[ドロケイ] を手書き、退出看板に [DorokeiLeave]/[ドロケイ退出] を手書きして認識させる方式）は廃止されています。看板は必ずコマンドで登録してください（座標で保存され、再起動後も復元されます）。
ゲームの運営¶
- プレイヤーが看板でロビーに集まるのを待つ（最低2人必要）。
/dorokei gamestartまたは開始看板でゲームを開始する。- ゲームは「カウントダウン → 逃走準備（既定30秒）→ 追跡開始 → 決着」と進行します。
- 終了から5秒後に参加者は自動でロビーへ戻され、同じロビーへ再参加した状態になります。
管理コマンド一覧¶
| コマンド | 説明 |
|---|---|
/dorokei（引数なし） |
ヘルプを表示する |
/dorokei setstartspawn |
初期リスポーン地点を現在地に設定する |
/dorokei setlobby |
現在地を待機ロビーに設定する |
/dorokei setfield 1 |
エリアの角1を現在地に設定する |
/dorokei setfield 2 |
エリアの角2を現在地に設定する |
/dorokei setjail |
牢屋を現在地に追加する（複数登録可） |
/dorokei setjail clear |
牢屋の登録を全て解除する |
/dorokei setchest |
視線先のチェスト（樽可）をラッキーチェストに追加する（複数登録可） |
/dorokei setchest clear |
ラッキーチェストの登録を全て解除する |
/dorokei setcop <人数> <警官数> |
人数別の警官数を設定する |
/dorokei delete |
会場の設定を削除する |
/dorokei setsign join |
視線先の看板を参加看板に登録する |
/dorokei setsign leave |
視線先の看板を離脱看板に登録する |
/dorokei setstart |
視線先の看板を開始看板に登録する |
/dorokei removesign |
視線先の看板の登録を解除する |
/dorokei gamestart |
ゲームを開始する（コマンドブロック可） |
/dorokei list |
会場の状態を表示する |
/dorokei status |
設定状況を確認する |
/dorokei join |
プレイヤーをロビーに参加させる（通常は看板を使用） |
/dorokei leave |
ロビーから退出する（通常は看板を使用） |
権限ノード¶
plugin.yml には dorokei.admin と dorokei.play の2つが定義されています。どちらも既定は OP です。
| 権限 | 既定 | 用途 |
|---|---|---|
dorokei.admin |
OP | セットアップ系（setstartspawn / setlobby / setfield / setjail / setchest / setcop / delete） / 看板系（setsign / setstart / removesign） / gamestart / status の実行 |
dorokei.play |
OP | /dorokei join / leave / list の実行 |
プレイヤー操作について
dorokei.play は既定 OP です。一般プレイヤーが /dorokei join・leave・list を直接使うことは想定されておらず、参加・退出は看板から 行います。看板の右クリックはコマンドではなくイベント経由のため、権限の有無に関わらず誰でも利用できます。一般プレイヤーにもコマンドを許可したい場合は、権限プラグイン（LuckPerms 等）で dorokei.play を付与してください。
実装状況¶
実装済みの機能
- 単一会場の統合管理（ロビー＋エリアを
games.main配下にまとめて保持・ゲーム名指定不要） - 簡略化されたセットアップコマンド（ゲーム名引数の廃止・ワンド廃止）
- 牢屋の複数登録（
setjailで追加・setjail clearで全解除） - 人数別の警官数の手動設定（
setcop）と 設定状況の確認（status） - ロビー（既定上限20人・看板参加）
- ゲームエリア管理（pos1/pos2/牢屋による範囲設定・エリア外移動制限）
- 参加人数に応じた警官の自動割り振り（
cop-allocation） - 逃走準備フェーズ（警官の盲目・移動制限）と追跡フェーズ
- 捕獲（警棒）・牢獄・市民による救出（救出時の速度上昇バフ）
- 警官／市民の専用アイテム（煙幕玉・ダッシュブーツ・スプリントブースト・ネット投擲）
- ラッキーチェスト（
setchestで登録・逃走者専用・チェストごとの再開封クールダウン・出現重み付きルートテーブル） - 逃走者支援アイテム5種（スピードポーション・跳躍のお守り・蜘蛛の巣トラップ・鈍足の罠・レーダージャマー）＋抽選用の予備煙幕玉・緊急テレポート
- ボスバー・専用サイドバー（残り時間／逃走中／捕獲済／救出／役割）・コンパス・追跡パーティクル・心臓の鼓動音などの演出
- 勝敗判定（全市民捕獲／時間切れ／全員ログアウト）
- ログアウト処理（ゲーム・ロビーからの離脱、次回ログイン時の位置復帰）
- ゲーム終了後の自動ロビー帰還・再参加
注意点・制限
- 旧コマンド（
start/setpolice/settime）は廃止されました。gamestart/setcop等の新方式を使用してください。 - config 再読み込み用コマンドはありません。
config.ymlを手動編集した場合はサーバー再起動が必要です。 - 会場は1つ（
main）のみです。複数会場の同時運用には対応していません。
トラブルシューティング¶
ゲームが開始できない（プレイヤーが足りません）
ゲーム開始には ロビーに最低2人 が必要です。/dorokei list でロビーの参加人数を確認してください。
「ゲームエリアが設定されていません」と表示される
エリア（pos1 / pos2 / 牢屋）が未設定です。/dorokei setfield 1 / /dorokei setfield 2 / /dorokei setjail をすべて実行してください。エリアは pos1・pos2・牢屋の3点がそろって初めて有効になります。/dorokei status で不足項目を確認できます。
会場が [未完成] と表示される
ロビーまたはエリアの一部が未設定です。/dorokei status で ロビー: 未設定 や フィールド1(pos1): 未設定 等を確認し、不足している項目を /dorokei setlobby / /dorokei setfield 1 / /dorokei setfield 2 / /dorokei setjail で追加してください。3点がそろわないエリアは読み込まれません。ワールドが存在しない場合も読み込みに失敗します。
「pos2 と異なるワールドです」と言われる
pos1 と pos2 は同じワールドである必要があります。先に登録した方と同じワールドで取り直してください。
参加看板をクリックしても参加できない
/dorokei setsign join で登録済みか確認してください（座標登録が必要なため手書きは機能しません）。対象ロビーがゲーム中の場合は参加できません。
config.yml を編集したのに反映されない
config 再読み込みコマンドはありません。サーバーを再起動して反映してください。
ラッキーチェストを右クリックしても何も出ない
まず /dorokei setchest でそのチェストが登録済みか確認してください（/dorokei status の「ラッキーチェスト」件数で確認できます）。登録済みでも、警官が開いた場合や収監中は出ません（逃走者専用のため）。また同じチェストには再開封クールダウン（既定45秒）があります。なお /dorokei setchest はチェスト・トラップチェスト・樽のいずれかを 5ブロック以内で見ながら 実行する必要があります。
アップグレード後、ラッキーチェストの抽選内容を変えたい / 反映されない
chest-settings.loot を編集してサーバーを再起動してください。v3.0 など古いバージョンから更新した既存サーバーでは、既存の config.yml に chest-settings が自動追記されません（組み込み既定テーブルで動作します）。抽選内容をカスタムしたい場合は、config.yml に chest-settings セクションを手動追記するか、一度 config.yml を退避してサーバー再起動で再生成してください。
会場を丸ごと作り直したい
/dorokei delete で会場の設定を丸ごと削除できます。削除後に同じ手順で再設定してください。牢屋だけを取り直したい場合は /dorokei setjail clear で全解除してから登録し直せます。