Yukioni ― OP・運営ガイド¶
Yukioni の導入・初期設定・config・権限・管理コマンドをまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | Yukioni |
| 説明 | 雪鬼ごっこミニゲームプラグイン |
| api-version | 26.1.2 |
| メインコマンド | /yukioni <join\|leave\|setstartspawn\|setlobby\|setfield\|setsign\|start\|stop\|status\|reload>（join/leaveは全員可） |
| 依存プラグイン | なし |
| 設定ファイル | plugins/Yukioni/config.yml |
| 座標保存ファイル | plugins/Yukioni/locations.yml（自動生成・自動保存） |
導入手順¶
- ビルドした
Yukioniの jar をサーバーのplugins/フォルダに配置する。 - サーバーを起動すると
plugins/Yukioni/config.ymlが自動生成される。 - 後述の手順でスポーン・ロビー・ゲームエリアの座標を設定する。
- ロビーに参加看板・離脱看板を設置する。
- 設定を変更したら
/yukioni reloadで再読み込みする。
config.yml 設定項目¶
ゲーム設定（game）¶
| キー | 既定値 | 説明 |
|---|---|---|
match-duration |
420 | 試合時間（秒）。経過で市民の勝利 |
min-players |
2 | ゲーム開始に必要な最小プレイヤー数 |
max-players |
16 | ロビーの最大プレイヤー数 |
oni-freeze-time |
10 | 開始直後に鬼が動けない時間（秒） |
snowblock-cooldown |
5 | 鬼の雪ブロック投げクールダウン（秒） |
countdown-time |
10 | ゲーム開始前のカウントダウン時間（秒） |
citizen-speed |
0.3 | 市民の移動速度倍率（通常0.2、0.3で約1.5倍） |
メッセージ設定（messages）¶
prefix のほか、ゲーム開始・勝敗・役職通知・クールダウン・ロビー出入りなどの各種メッセージを定義します。色は & 形式のレガシーカラーコードで指定します。%player% %time% %current% %max% %min% %count% などのプレースホルダーが利用できます。
看板設定（sign）¶
参加看板（sign.lobby）・離脱看板（sign.leave）の各行の表示文を定義します。sign.lobby.line4 では %current% %max% で人数を表示できます。開始看板の文言（sign.start）は config.yml に既定セクションが無く、プラグイン内蔵のデフォルト（[Yukioni] / ▶クリックで開始）で書き込まれます。カスタマイズしたい場合のみ config に sign.start を追記してください。
設定変更後は /yukioni reload
config.yml を編集したら /yukioni reload を実行してください。設定が再読み込みされます。
既存サーバーは config が自動追記されません
本プラグインは saveDefaultConfig() のみのため、既存の config.yml に新しいキーは自動追記されません。コード側に既定値があるため動作はしますが、sign.start 等を編集したい場合は手動追記、または config を退避して再生成してください。
セットアップ手順¶
専用ワールドを用意し、OP権限で以下のコマンドを その場に立って 実行します（実行位置が座標として locations.yml に保存されます）。
設定後、ロビーに看板を設置します。看板を設置したら、その看板を見た状態で以下のコマンドを実行します（yukioni.admin 権限が必要）。
コマンドを実行すると、プラグインがテキストを自動書き込みし、位置を locations.yml の sign.join / sign.leave / sign.start に保存します。手書きでのテキスト入力は不要です。
開始看板はクリックで誰でも開始できます
/yukioni setsign start で設置した開始看板は、クリックするとゲームが始まります（内部で権限チェックを行わないため、設置すると一般プレイヤーもクリックで開始できます）。独立した setstart コマンドは廃止され、開始看板も setsign start で登録します。運営のみで開始したい場合は開始看板を設置せず、/yukioni start で開始してください。
ゲームエリアについて
setfield 1 / setfield 2 の2点で囲まれた直方体がゲームエリアになります。プレイヤーはこの範囲外に出られず、開始時はこの範囲内のランダムな位置にテレポートされます。エリア未設定の場合は、エリア判定が無効になりロビー地点が代替に使われます。
管理コマンド¶
| コマンド | 権限 | 説明 |
|---|---|---|
/yukioni setstartspawn |
yukioni.admin |
スポーン地点を設定 |
/yukioni setlobby |
yukioni.admin |
ロビー地点を設定 |
/yukioni setfield 1 |
yukioni.admin |
ゲームエリアの角1を設定 |
/yukioni setfield 2 |
yukioni.admin |
ゲームエリアの角2を設定 |
/yukioni join / leave |
全員 | ロビーに参加／退出する（看板と同等） |
/yukioni setsign <join\|leave\|start> |
yukioni.admin |
視線先の看板を参加／離脱／開始看板に登録 |
/yukioni start |
yukioni.admin |
ゲームを開始する |
/yukioni stop |
yukioni.admin |
ゲームを強制終了する |
/yukioni status |
yukioni.admin |
設定状況を確認する |
/yukioni reload |
yukioni.admin |
config.yml を再読み込み |
ゲームの開始について
プレイヤーがロビー看板から参加し、min-players 以上集まったら /yukioni start で開始します。人数が不足している場合は開始できません。異常時は /yukioni stop で強制終了できます。
権限ノード¶
| 権限 | 既定 | 用途 |
|---|---|---|
yukioni.admin |
OP | 管理・セットアップコマンドすべて、看板の設置 |
yukioni.play |
全員 | ゲーム参加権限 |
トラブルシューティング¶
プレイヤーがゲームに参加できない
参加導線は ロビー看板 です。/yukioni setsign join を、登録したい看板を見ながら実行してください（yukioni.admin 権限が必要）。また、/yukioni setlobby でロビー座標が設定済みかも確認してください。
ゲームが開始できない
min-players（既定2人）以上がロビーに入っているか確認してください。人数不足の場合、/yukioni start を実行しても開始されません。また、すでにゲームが進行中の場合も開始できません。
プレイヤーがエリア外に出てしまう／開始位置がおかしい
/yukioni setfield 1 と /yukioni setfield 2 の両方が設定されているか確認してください。エリアが未設定だとエリア判定が無効になり、開始時のテレポート先がロビー地点になります。pos1・pos2 は同じワールド内で設定してください。
看板が登録されない
看板の登録には yukioni.admin 権限が必要です。登録したい看板を見ながら /yukioni setsign join（または leave）を実行してください（yukioni.admin 権限が必要）。
設定変更が反映されない
config.yml を編集したら /yukioni reload を実行してください。なお、座標は locations.yml に保存され、setup コマンド実行時に即保存されます。