Aooni（青鬼）― OP・運営ガイド¶
Aooni（青鬼）の導入・会場の設定・config・権限・管理コマンドをまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | Aooni |
| バージョン | 1.0.0 |
| api-version | 26.1.2 |
| 作者 | henry |
| メインコマンド | /aooni |
| 依存プラグイン | なし |
| 設定ファイル | plugins/Aooni/config.yml（ゲーム設定・メッセージ・看板テキスト） |
| 地点ファイル | plugins/Aooni/locations.yml（スポーン・看板・チェスト・隠れ場所。コマンドで自動保存） |
ゲームの仕組み（脱出型 × 鍵集め式 × 感染）
逃走者は鍵チェストを開けて鍵を集め（既定3本）、脱出ドアに到達すれば逃走者陣営の勝利。青鬼は逃走者を殴って捕まえると相手を青鬼に変え（感染）、逃走者が全員青鬼になれば青鬼の勝利。制限時間（既定6分）に達すると引き分けです。
導入手順¶
- ビルドした
Aooniの jar ファイルをサーバーのplugins/フォルダに配置する。 - サーバーを起動・再起動すると
plugins/Aooni/config.ymlが自動生成される（地点を登録するとlocations.ymlも生成されます）。 - 後述の手順で会場（スポーン・脱出ドア・鍵チェスト・隠れ場所・看板）を設定する。
- 必要に応じて
config.ymlを編集し、/aooni reloadで反映する。
config の反映について
config.yml（ゲーム設定・メッセージ）は /aooni reload で再読み込みできます。地点系（スポーン・看板・チェスト・隠れ場所）は各セットアップコマンドの実行時に locations.yml へ即座に保存され、すぐ反映されます。/aooni setmax / setmin / settime / setkeys による数値変更は config.yml へ即座に保存されます。
config.yml 設定項目¶
game セクション¶
| キー | 既定値 | 説明 |
|---|---|---|
game.match-duration |
360 | 試合時間（秒）。到達すると引き分け（既定6分） |
game.min-players |
3 | ゲーム開始に必要な最小プレイヤー数 |
game.max-players |
16 | ロビーの最大人数 |
game.countdown-time |
15 | 開始前のカウントダウン時間（秒） |
game.initial-oni |
1 | 開幕時の青鬼の人数（立候補者を優先し、不足分はランダム指名で補完） |
game.keys-required |
3 | 脱出に必要な鍵の本数（逃走者個人ごと） |
game.escape-radius |
2.0 | 脱出ドア判定の半径（ブロック） |
game.darkness |
true | 逃走者に暗闇を付与する（青鬼は暗視） |
game.chest-reveal |
false | true にすると、チェストから鍵を取り出した逃走者を一時発光させ青鬼へ通知する（既定は発光・通知しない） |
game.result-seconds |
10 | 結果発表の表示秒数（この秒数だけ結果を見せてからロビーへ復帰） |
game.key-spawn-interval |
30 | 鍵の補充判定を行う間隔（秒） |
game.key-spawn-chance |
1.0 | 補充判定1回あたりの実行確率（0.0〜1.0）。当選すると補充される |
game.locker-hide-time |
8 | 隠れ場所で透明になる秒数 |
game.locker-cooldown |
15 | 隠れ場所の再使用クールダウン（秒。透明化時間に加算される） |
鍵の出現は「時間補充」方式です
鍵は最初からチェストに入っているのではなく、ゲーム中に key-spawn-interval 秒（既定30秒）ごとの補充判定で key-spawn-chance（既定1.0＝毎回）の確率で実行されます。チェストに同時に存在する鍵の総数は 「逃走者の人数 × keys-required」 に保たれ、1チェストにつき鍵は1本まで、回収されて空になったチェストには再補充されます（目標数に達していれば何も追加しません）。補充時は全員に「どこかのチェストに鍵が出現した…！」と通知されます。逃走者はチェストを開けて鍵を回収します（チェストは通常どおり開きます）。鍵の供給ペースは match-duration と key-spawn-interval / key-spawn-chance のバランスで決まるため、逃走者が必要本数を集められるかを試遊で確認して調整してください。
loadout セクション¶
役職ごとの配布装備をコード直書きせず config で定義します。リスポーン・役職変更時もこの設定から再構築して付与されます。
| キー | 既定値 | 説明 |
|---|---|---|
loadout.oni.helmet / chestplate / leggings / boots |
DIAMOND_* | 青鬼の防具マテリアル名（NONE または空文字で装備なし） |
loadout.oni.speed |
0.22 | 青鬼の移動速度（標準の歩行速度は0.2。大きいほど速い） |
loadout.oni.night-vision |
true | 青鬼に暗視を付与するか |
loadout.runner.helmet / chestplate / leggings / boots |
NONE | 逃走者の防具マテリアル名（既定は装備なし） |
loadout.runner.speed |
0.2 | 逃走者の移動速度 |
loadout.runner.night-vision |
false | 逃走者に暗視を付与するか |
移動速度・暗視は loadout セクションで設定します
旧バージョンの game.oni-speed は廃止され、移動速度は loadout.oni.speed / loadout.runner.speed、暗視は loadout.*.night-vision で個別に設定する方式になりました。防具マテリアルが不正な場合は「装備なし」にフォールバックします。
messages / sign セクション¶
messages には各種通知文（& カラーコード対応）、sign には参加 / 離脱 / 開始 / 立候補看板に書き込まれるテキストが定義されています。プレフィックスは messages.prefix（既定 &b[青鬼]）です。看板テキストの %current% / %max% はロビー人数・最大人数に、立候補看板の %count% は立候補者数に置換されます。
セットアップ手順¶
専用ワールドを用意し、OP権限（aooni.admin）で以下のコマンドを 設定したい地点に立って（または対象ブロックを見ながら）実行します。地点は実行位置・視線先のブロックとして locations.yml に保存されます。
登録の解除も視線先のブロックを見ながら実行できます。
設定の流れは次のとおりです。
/aooni setstartspawnで初期スポーン（途中抜け・終了時の戻り先）を設定する。- ロビーにする場所に立ち
/aooni setlobbyを実行する。 - 青鬼スポーン・逃走者スポーンをそれぞれの場所で
/aooni setspawn oni//aooni setspawn runnerで設定する。 - 脱出ドアにするブロックを見ながら
/aooni setgoalを実行する。 - 鍵チェスト（チェスト／トラップチェスト）を見ながら
/aooni addchestを実行する。別のチェストで繰り返すと複数登録できます（解除は/aooni removechest）。 - （任意）隠れ場所にするブロックを見ながら
/aooni addlockerを実行する。こちらも複数登録できます（解除は/aooni removelocker）。 /aooni statusで各設定状況を確認する。
ゲーム開始に必須の設定
/aooni start（開始看板を含む）は、初期スポーン・ロビー・青鬼スポーン・逃走者スポーン・脱出ドア・鍵チェスト1個以上 がそろっていないと開始できません（「設定が未完了です」と表示）。隠れ場所と看板は開始の必須条件ではありません（参加・離脱・開始はコマンドでも可能なため）。ただし、わかりやすさのため実運用では参加看板の設置を推奨します（後述）。
鍵チェストは複数を散らして設置するのがおすすめ
鍵は補充判定で 空いている登録チェストのどれか に1本ずつ補充され、チェスト内の鍵の総数は「逃走者数 × keys-required」に保たれます。チェストが多くマップ全体に散らばっているほど、鍵を探して動き回る駆け引きが生まれます。逆に少ないと鍵の出現場所が読まれて青鬼に張られやすくなります。少なくとも「逃走者数 × keys-required」個以上のチェストが必要なため、広いマップに数か所〜十数か所を目安に設置してください。
試合の鍵は自動でクリアされます
試合中に出現して回収されなかった鍵は、試合開始時・終了時・強制終了時に自動でクリアされます（プラグインが付与した「脱出の鍵」のみが対象）。前の試合の鍵が次の試合に持ち越されることはありません。ただし運用上、登録チェストには 他のアイテムを置かない ことを推奨します。
看板の設置¶
参加・離脱・開始は 看板 か コマンド（/aooni join / leave / start）のどちらでも行えます。看板はクリック1つで操作でき、初心者にもわかりやすいため設置を推奨します。看板を設置し、看板を見ながら（5ブロック以内）以下のコマンドを実行してください。テキストはプラグインが自動で書き込みます。
看板の解除は、解除したい看板を見ながら（5ブロック以内）次のコマンドを実行します。種別は自動判別されます。
青鬼立候補看板について
setsign oni で立候補看板を設置すると、ロビー在籍中のプレイヤーがクリックして 青鬼への立候補 をオン／オフできます。ゲーム開始時の青鬼（既定1人）は 立候補者を優先して抽選され、不足分はランダム指名で補完されます。立候補看板の4行目には現在の立候補者数（%count%）が表示されます。
参加は看板でもコマンドでも可能
プレイヤーは 参加看板のクリック または /aooni join（離脱は /aooni leave、開始は /aooni start）で操作できます。看板操作はイベント経由、コマンドは aooni.play（/aooni 全体の権限。既定で全員）で利用できます。/aooni start も aooni.play を持つプレイヤーなら誰でも実行できます。看板は無くても動作しますが、わかりやすさのため参加看板の設置を推奨します。
ゲームの運営¶
- プレイヤーが参加看板でロビーに集まるのを待つ（既定で最小3人）。
/aooni startまたは開始看板でゲームを開始する。- ゲームは「カウントダウン（既定15秒）→ 役割抽選 → 鍵集め＆逃走 → 決着」と進行します。
- 終了から既定10秒後（
result-seconds）に参加者は自動でロビーへ戻され、参加状態が維持されます。
コマンド一覧¶
join / leave / start / stats / status は 全プレイヤー が利用でき、それ以外のセットアップ・管理コマンドは aooni.admin（既定OP）が必要です。join / leave にプレイヤー名を付けて他プレイヤーを操作する場合は aooni.admin が必要です。
| コマンド | 必要権限 | 説明 |
|---|---|---|
/aooni（引数なし） |
全員 | ヘルプを表示する |
/aooni join [名前] |
全員（名前指定は admin） | ロビーに参加する（参加看板と同じ）。名前指定で他プレイヤーを参加させる |
/aooni leave [名前] |
全員（名前指定は admin） | ロビーから離脱する（離脱看板と同じ）。名前指定で他プレイヤーを離脱させる |
/aooni start |
全員 | ゲームを開始する（開始看板と同じ） |
/aooni stats [名前] |
全員 | 成績を表示する（名前省略で自分） |
/aooni status |
全員 | 設定状況を確認する |
/aooni setstartspawn |
aooni.admin | 初期スポーン（戻り先）を現在地に設定する |
/aooni setlobby |
aooni.admin | ロビー地点を現在地に設定する |
/aooni setspawn <oni\|runner> |
aooni.admin | 青鬼／逃走者スポーンを現在地に設定する |
/aooni setgoal |
aooni.admin | 視線先のブロックを脱出ドアに設定する |
/aooni addchest |
aooni.admin | 視線先のチェストを鍵チェストに登録する（複数可） |
/aooni removechest |
aooni.admin | 視線先の鍵チェストの登録を解除する |
/aooni addlocker |
aooni.admin | 視線先のブロックを隠れ場所に登録する（複数可） |
/aooni removelocker |
aooni.admin | 視線先の隠れ場所の登録を解除する |
/aooni setsign <join\|leave\|start\|oni> |
aooni.admin | 視線先の看板を各種看板に登録する |
/aooni setsign delete |
aooni.admin | 視線先の看板の登録を解除する（種別は自動判別） |
/aooni setmax <人数> |
aooni.admin | 最大人数を設定する（config に即保存） |
/aooni setmin <人数> |
aooni.admin | 最小人数を設定する（config に即保存） |
/aooni settime <秒> |
aooni.admin | 制限時間を設定する（config に即保存） |
/aooni setkeys <本数> |
aooni.admin | 必要鍵本数を設定する（config に即保存） |
/aooni stop |
aooni.admin | ゲームを強制終了する |
/aooni reload |
aooni.admin | config.yml を再読み込みする |
権限ノード¶
plugin.yml には aooni.admin と aooni.play の2つが定義されています。
| 権限 | 既定 | 用途 |
|---|---|---|
aooni.admin |
OP | セットアップ・看板登録系・数値設定・他プレイヤーの参加/離脱操作・stop / reload |
aooni.play |
すべてのプレイヤー | ロビーへの参加権限（join 実行・参加看板のクリックで判定） |
プレイヤー操作について
aooni.play は既定で 全員に付与 されており、ロビー参加の可否を判定します。プレイヤーは看板の右クリック、または /aooni join / leave / start で操作でき、stats / status も誰でも実行できます。/aooni start は権限チェックを行わないため誰でもゲームを開始できます。参加自体を制限したい場合は権限プラグイン（LuckPerms 等）で aooni.play を調整してください（外すと参加できなくなります）。join / leave に プレイヤー名を付けて他プレイヤーを操作 する場合のみ aooni.admin が必要です。
実装状況¶
実装済みの機能
- ロビー（看板またはコマンドでの参加・離脱・人数表示・最大人数制限）
- 開始カウントダウン（既定15秒）と役割の自動抽選（開幕青鬼数は
initial-oni） - 青鬼キット（ダイヤ装備・暗視・移動速度UP）／逃走者キット（暗闇）
- 鍵の時間補充（
key-spawn-interval/key-spawn-chance、総数は「逃走者数 ×keys-required」を維持）と全体通知 - 鍵の回収（
chest-reveal: trueの場合のみ取り出し時に発光＋青鬼へ通知。既定は発光しない） - 隠れ場所（右クリックで一時透明化・クールダウン）
- 脱出判定（必要本数の鍵を所持して脱出ドアへ接近）
- 感染（青鬼が逃走者を攻撃 → 青鬼化）
- 残り時間・人数・逃走者の鍵所持数のアクションバー表示、残り時間のチャット通知
- 勝敗判定（逃走者脱出 / 全員青鬼 / 時間切れ引き分け）
- 食事・落下などのダメージ無効（死亡防止）
- 終了後の自動ロビー帰還（参加状態を維持）・ログアウト時の戻り処理
注意点・制限
- 参加・離脱・開始は 看板 か コマンド（
/aooni join/leave/start・全プレイヤー可）のどちらでも行えます。/aooni startもaooni.playで実行できるため、必要なら権限で制限してください。 - 鍵は時間補充でチェストに出現する方式です。回収されなかった鍵は試合の開始・終了時に自動でクリアされます（プラグインの鍵のみ対象）。登録チェストには他のアイテムを置かないでください。
- 鍵チェストは青鬼も開けられます（GUIは全員に開きます）。青鬼が鍵を抜き取る妨害が可能な点に留意してください。
- 会場は1つのみです。複数会場の同時運用には対応していません。
config.ymlの地点系は持たず、地点はlocations.ymlで管理されます（地点系コマンドで自動保存）。
トラブルシューティング¶
「設定が未完了です」と表示されて開始できない
初期スポーン・ロビー・青鬼スポーン・逃走者スポーン・脱出ドア・鍵チェスト（1個以上）のいずれかが未設定です。/aooni status で「未設定」の項目を確認し、対応するコマンドで設定してください。
「プレイヤーが足りません」と表示される
ロビーの人数が game.min-players（既定3人）に達していません。/aooni status でロビー人数を確認してください。
参加看板をクリックしても参加できない
/aooni setsign join で参加看板が登録済みか確認してください（位置で判定するため、看板の手書きでは機能しません）。ゲーム進行中は参加できません。
チェストを開けても鍵が入っていない
鍵は最初から入っているのではなく、key-spawn-interval 秒ごとの補充判定で出現します。「どこかのチェストに鍵が出現した…！」の通知が出てから、登録チェストを探してください。なかなか出ない場合は game.key-spawn-chance を上げる、game.key-spawn-interval を短くする、登録チェスト数を増やすなどで供給ペースを調整できます（/aooni reload で反映）。チェスト内の鍵総数は「逃走者数 × keys-required」が上限のため、チェスト数が少ないと補充されないこともあります。
逃走者がすぐ脱出できてしまう／誰も脱出できない
鍵の供給ペースは game.keys-required（必要本数）と game.key-spawn-interval / key-spawn-chance、game.match-duration、登録チェスト数のバランスで決まります。誰も脱出できない場合は供給を増やし（間隔短縮・確率アップ・チェスト増設）、簡単すぎる場合は逆に絞ってください。config.yml を編集したら /aooni reload で反映します。
config.yml を編集したのに反映されない
ゲーム設定・メッセージは /aooni reload で反映されます。反映後は新しい試合から有効です（進行中の試合には適用されません）。