🛠️ OP・運営向けページ — 運営スタッフ向けの導入・設定情報です。遊び方は 👤 プレイヤー向けページ をご覧ください。

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分）に達すると引き分けです。

導入手順

1. ビルドした Aooni の jar ファイルをサーバーの plugins/ フォルダに配置する。
2. サーバーを起動・再起動すると plugins/Aooni/config.yml が自動生成される（地点を登録すると locations.yml も生成されます）。
3. 後述の手順で会場（スポーン・脱出ドア・鍵チェスト・隠れ場所・看板）を設定する。
4. 必要に応じて config.yml を編集し、/aooni reload で反映する。

config の反映について

config.yml（ゲーム設定・メッセージ）は /aooni reload で再読み込みできます。地点系（スポーン・看板・チェスト・隠れ場所）は各セットアップコマンドの実行時に locations.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.oni-speed	0.22	青鬼の移動速度（既定の歩行速度は0.2。大きいほど速い）
game.keys-required	3	脱出に必要な鍵の本数（逃走者個人ごと）
game.escape-radius	2.0	脱出ドア判定の半径（ブロック）
game.darkness	true	逃走者に暗闇を付与する（青鬼は暗視）
game.chest-reveal	false	true にすると、チェストから鍵を取り出した逃走者を一時発光させ青鬼へ通知する（既定は発光・通知しない）
game.key-spawn-interval	30	鍵の抽選を行う間隔（秒）
game.key-spawn-chance	1.0	抽選1回あたりの当選確率（0.0〜1.0）。当選すると鍵が出現
game.keys-per-spawn	2	1回の当選で鍵が出現するチェストの数（別々のチェストに1本ずつ分散）
game.locker-hide-time	8	隠れ場所で透明になる秒数
game.locker-cooldown	15	隠れ場所の再使用クールダウン（秒。透明化時間に加算される）

鍵の出現は「時間抽選」方式です

鍵は最初からチェストに入っているのではなく、ゲーム中に key-spawn-interval 秒（既定30秒）ごとの抽選で key-spawn-chance（既定1.0＝毎回）の確率で当選し、当たると登録チェストのうち keys-per-spawn 個（既定2個）の 別々のチェスト にそれぞれ鍵が1本ずつ分散して出現します（見つけやすくするため）。出現時は全員に「どこかのチェストに鍵が出現した…！」と通知されます。逃走者はチェストを開けて鍵を回収します（チェストは通常どおり開きます）。鍵の供給量は match-duration と上記3項目のバランスで決まるため、逃走者が必要本数を集められるかを試遊で確認して調整してください。

messages / sign セクション

messages には各種通知文（& カラーコード対応）、sign には参加 / 離脱 / 開始看板に書き込まれるテキストが定義されています。プレフィックスは messages.prefix（既定 &b[青鬼]）です。看板テキストの %current% / %max% はロビー人数・最大人数に置換されます。

セットアップ手順

専用ワールドを用意し、OP権限（aooni.admin）で以下のコマンドを 設定したい地点に立って（または対象ブロックを見ながら）実行します。地点は実行位置・視線先のブロックとして locations.yml に保存されます。

① 初期スポーン（途中抜け・終了時の戻り先）を現在地に設定

/aooni setstartspawn

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

/aooni setlobby

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

/aooni setspawn oni

④ 逃走者スポーンを現在地に設定

/aooni setspawn runner

⑤ 脱出ドアを設定（脱出ドアにするブロックを見ながら／6ブロック以内）

/aooni setfield 1

⑥ 鍵チェストを登録（チェストを見ながら／6ブロック以内・複数可）

/aooni setchest

⑦ 隠れ場所を登録（ブロックを見ながら／6ブロック以内・複数可）

/aooni setlocker

設定の流れは次のとおりです。

1. /aooni setstartspawn で初期スポーン（途中抜け・終了時の戻り先）を設定する。
2. ロビーにする場所に立ち /aooni setlobby を実行する。
3. 青鬼スポーン・逃走者スポーンをそれぞれの場所で /aooni setspawn oni / /aooni setspawn runner で設定する。
4. 脱出ドアにするブロックを見ながら /aooni setfield 1 を実行する。
5. 鍵チェスト（チェスト／トラップチェスト）を見ながら /aooni setchest を実行する。別のチェストで繰り返すと複数登録できます。
6. （任意）隠れ場所にするブロックを見ながら /aooni setlocker を実行する。こちらも複数登録できます。
7. /aooni status で各設定状況を確認する。

ゲーム開始に必須の設定

/aooni start（開始看板を含む）は、初期スポーン・ロビー・青鬼スポーン・逃走者スポーン・脱出ドア・鍵チェスト1個以上 がそろっていないと開始できません（「設定が未完了です」と表示）。隠れ場所と看板は開始の必須条件ではありませんが、参加・離脱・開始は看板でのみ行うため、実運用では参加看板の設置が必要です（後述）。

鍵チェストは複数を散らして設置するのがおすすめ

鍵は抽選で 登録チェストのうち keys-per-spawn 個（既定2個）の別々のチェスト に1本ずつ分散して出現します。チェストが多くマップ全体に散らばっているほど、鍵を探して動き回る駆け引きが生まれます。逆に1〜2個だと鍵の出現場所が読まれて青鬼に張られやすくなります（keys-per-spawn がチェスト総数を超える場合は登録チェスト数に丸められます）。広いマップに数か所〜十数か所を目安に設置してください。

チェストの中身は試合をまたいで残ります

現在の仕様では、試合中に出現して回収されなかった鍵は チェスト内に残ったまま で、試合終了時に自動でクリアされません。次の試合の開幕直後に前回の残り鍵を拾えてしまうため、運用では 試合開始前に登録チェストの中身を空にしておく ことをおすすめします（チェスト内に他のアイテムを置かないことも推奨）。

看板の設置

参加・離脱・開始はすべて 看板 で行います（プレイヤー用の参加コマンドはありません）。看板を設置し、看板を見ながら（5ブロック以内）以下のコマンドを実行してください。テキストはプラグインが自動で書き込みます。

参加看板を登録（クリックで参加・ロビーへTP・人数表示）

/aooni setsign join

離脱看板を登録（クリックでロビーから離脱）

/aooni setsign leave

開始看板を登録（クリックでゲーム開始）

/aooni setstart

参加は看板からのみ

プレイヤーが参加・離脱するための /aooni join のようなコマンドはありません。プレイヤーは 参加看板のクリック で参加します。看板操作はイベント経由のため、aooni.play を持つプレイヤー（既定で全員）が利用できます。必ず参加看板を設置してください。

ゲームの運営

ゲームを開始（ロビーに最小人数以上が必要）

/aooni start

ゲームを強制終了する

/aooni stop

設定状況（地点・看板・オブジェクト・現在の状態）を確認

/aooni status

config.yml を再読み込み

/aooni reload

1. プレイヤーが参加看板でロビーに集まるのを待つ（既定で最小3人）。
2. /aooni start または開始看板でゲームを開始する。
3. ゲームは「カウントダウン（既定15秒）→ 役割抽選 → 鍵集め＆逃走 → 決着」と進行します。
4. 終了から5秒後に参加者は自動でロビーへ戻され、参加状態が維持されます。

管理コマンド一覧

すべて aooni.admin（既定OP）が必要です。

コマンド	説明
/aooni（引数なし）	ヘルプを表示する
/aooni setstartspawn	初期スポーン（戻り先）を現在地に設定する
/aooni setlobby	ロビー地点を現在地に設定する
/aooni setspawn oni	青鬼スポーンを現在地に設定する
/aooni setspawn runner	逃走者スポーンを現在地に設定する
/aooni setfield 1	視線先のブロックを脱出ドアに設定する
/aooni setchest	視線先のチェストを鍵チェストに登録する（複数可）
/aooni setlocker	視線先のブロックを隠れ場所に登録する（複数可）
/aooni setsign join	視線先の看板を参加看板に登録する
/aooni setsign leave	視線先の看板を離脱看板に登録する
/aooni setstart	視線先の看板を開始看板に登録する
/aooni start	ゲームを開始する
/aooni stop	ゲームを強制終了する
/aooni status	設定状況を確認する
/aooni reload	config.yml を再読み込みする

権限ノード

plugin.yml には aooni.admin と aooni.play の2つが定義されています。

権限	既定	用途
aooni.admin	OP	すべての /aooni コマンド（セットアップ・看板・start / stop / status / reload）
aooni.play	すべてのプレイヤー	ロビーへの参加（参加看板のクリック時に判定）

プレイヤー操作について

aooni.play は既定で 全員に付与 されています。プレイヤーは看板の右クリックで参加・離脱します。参加を制限したい場合は権限プラグイン（LuckPerms 等）で aooni.play を調整してください。

実装状況

実装済みの機能

• ロビー（看板での参加・離脱・人数表示・最大人数制限）
• 開始カウントダウン（既定15秒）と役割の自動抽選（開幕青鬼数は initial-oni）
• 青鬼キット（ダイヤ装備・暗視・移動速度UP）／逃走者キット（暗闇）
• 鍵の抽選出現（key-spawn-interval/key-spawn-chance/keys-per-spawn）と全体通知
• 鍵の回収（chest-reveal: true の場合のみ取り出し時に発光＋青鬼へ通知。既定は発光しない）
• 隠れ場所（右クリックで一時透明化・クールダウン）
• 脱出判定（必要本数の鍵を所持して脱出ドアへ接近）
• 感染（青鬼が逃走者を攻撃 → 青鬼化）
• 残り時間・人数・逃走者の鍵所持数のアクションバー表示、残り時間のチャット通知
• 勝敗判定（逃走者脱出 / 全員青鬼 / 時間切れ引き分け）
• 食事・落下などのダメージ無効（死亡防止）
• 終了後の自動ロビー帰還（参加状態を維持）・ログアウト時の戻り処理

注意点・制限

• 参加・離脱・開始は 看板でのみ 行います（プレイヤー用の参加コマンドはありません）。
• 鍵は抽選でチェストに出現する方式です。回収されなかった鍵は試合をまたいでチェストに残るため、試合前にチェストを空にしておくことを推奨します。
• 鍵チェストは青鬼も開けられます（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 を短くする、game.keys-per-spawn を増やすなどで供給量を調整できます（/aooni reload で反映）。

逃走者がすぐ脱出できてしまう／誰も脱出できない

鍵の供給量は game.keys-required（必要本数）と game.key-spawn-interval / key-spawn-chance / keys-per-spawn、game.match-duration のバランスで決まります。誰も脱出できない場合は供給を増やし（間隔短縮・確率/本数アップ）、簡単すぎる場合は逆に絞ってください。config.yml を編集したら /aooni reload で反映します。

前の試合の鍵が残っている／開幕でいきなり鍵が拾える

回収されなかった鍵は試合終了時に自動でクリアされず、チェスト内に残ります。試合を始める前に登録チェストの中身を空にしておいてください。

config.yml を編集したのに反映されない

ゲーム設定・メッセージは /aooni reload で反映されます。反映後は新しい試合から有効です（進行中の試合には適用されません）。

---

← 👤 プレイヤー向けページへ ← Aooni（青鬼）概要へ