Yukigassen ― OP・運営ガイド¶
Yukigassen の導入・地点のセットアップ・config・権限・管理コマンドをまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | Yukigassen |
| バージョン | 1.0 |
| api-version | 26.1.2 |
| メインコマンド | /yukigassen <subcommand> |
| 依存プラグイン | なし |
| 設定ファイル | plugins/Yukigassen/config.yml |
導入手順¶
- ビルドした
Yukigassenの jar をサーバーのplugins/フォルダに配置する。 - サーバーを起動すると
plugins/Yukigassen/config.ymlが自動生成される。 - 後述の手順で各種地点を設定する。
- プレイヤーが集まったら
/yukigassen startでゲームを開始する。
config.yml 設定項目¶
設定ファイルは以下のキーで構成されます。地点（locations）はセットアップコマンドで自動的に書き込まれるため、手動編集は不要です。
| キー | 既定値 | 説明 |
|---|---|---|
default-lives |
3 | プレイヤーの初期残機数 |
max-players |
16 | 最大参加人数（満員時は参加拒否） |
min-players |
1 | 最小開始人数（0以下は1扱い） |
game.respawn-invincible-seconds |
3 | リスポーン直後の無敵秒数（スポーンキル防止。0で無効） |
game.result-seconds |
10 | 勝敗確定後、結果発表を表示してからロビーへ戻すまでの秒数 |
loadout |
シャベル＋雪玉16 | 配布ロードアウト（リスポーン時にも再付与） |
locations.spawn |
未設定 | 初期リスポーン地点（途中抜け時の戻り先） |
locations.lobby |
未設定 | ロビー地点（受付エリア・ゲーム終了後の戻り先） |
locations.spawnred |
未設定 | 赤チームのスポーン地点（ゲーム中のリスポーン先） |
locations.spawnblue |
未設定 | 青チームのスポーン地点（ゲーム中のリスポーン先） |
locations.area.pos1 |
未設定 | ゲームエリアの角1 |
locations.area.pos2 |
未設定 | ゲームエリアの角2 |
signs.join / signs.leave / signs.start |
[] |
看板の位置リスト（setsign で自動保存。手動編集不要） |
残機・人数設定について
config.yml の default-lives はプラグイン起動時の既定残機です。/yukigassen setzanki <数>・/yukigassen setmax <数>・/yukigassen setmin <数> で変更でき、これらは config.yml にも保存されます。
ロードアウトのカスタマイズ
loadout は material（Bukkit Material 名）・amount（個数）・name（任意・表示名）・enchants（任意・「エンチャント名: レベル」のマップ）で指定します。未設定の場合はダイヤのシャベル1本＋雪玉16個が既定として配られます。
セットアップ手順¶
専用ワールドを用意し、OP権限で以下のコマンドを その場に立って 実行します（実行位置が座標として保存されます）。
ゲーム開始の必須条件
/yukigassen start には 赤チームと青チームのスポーン地点が両方とも設定済み であることが必要です。setspawn red と setspawn blue を必ず実行してください。エリア（setfield）が未設定の場合はエリア外移動の制限がかからない（マップ全体が有効）扱いになります。
参加用看板の設置¶
ロビーに看板を設置し、看板を見た状態で以下のコマンドを実行します（yukigassen.admin 権限が必要）。
看板は 参加 / 退出 / 開始 の3種類です。yukigassen.admin 権限で、看板を見ながら登録します。
コマンドを実行すると、プラグインが看板テキストを自動書き込みし、位置を config の signs.join / signs.leave / signs.start に保存します（座標で判定するため手書き登録は廃止）。開始看板は /yukigassen setsign start で登録します（独立した setstart コマンドはありません）。/yukigassen setsign delete は視線先の登録看板を種別自動判別で解除し、看板テキストも消去します。
コマンド¶
プレイヤー用（全員可）¶
| コマンド | 説明 |
|---|---|
/yukigassen join |
ロビーに参加する（参加看板と同等） |
/yukigassen leave |
ロビーから退出する（退出看板と同等） |
/yukigassen start |
ゲームを開始する（開始看板と同等。コマブロ/コンソール可） |
/yukigassen status |
設定状況（地点・看板登録数・人数・ゲーム状態）を確認する |
/yukigassen stats [名前] |
成績（キル/デス/勝利/試合数）を確認する（名前なし＝自分） |
他プレイヤー指定はadmin権限
join / leave に 対象（プレイヤー名や @a などのセレクタ）を指定する場合のみ yukigassen.admin が必要です。引数を省略すると実行者自身が対象になり、権限は不要です。start は誰でも実行できます。teamjoinred / teamjoinblue というコマンドは存在しません（チーム振り分けは開始時に自動）。
管理用（yukigassen.admin）¶
| コマンド | 説明 |
|---|---|
/yukigassen join <player> |
対象（プレイヤー名／@a 等のセレクタ）を参加させる |
/yukigassen leave <player> |
対象（プレイヤー名／@a 等のセレクタ）を離脱させる |
/yukigassen stop |
ゲームを強制停止する |
/yukigassen setzanki <数> |
初期残機数を設定する（config に保存） |
/yukigassen setmax <数> |
最大参加人数を設定する（config に保存） |
/yukigassen setmin <数> |
最小開始人数を設定する（config に保存） |
/yukigassen setstartspawn |
初期リスポーン地点を設定する |
/yukigassen setlobby |
ロビー地点を設定する |
/yukigassen setspawn <red\|blue> |
チームのスポーン地点を設定する |
/yukigassen setfield <1\|2> |
ゲームエリアの角を設定する |
/yukigassen setsign <join\|leave\|start> |
視線先の看板を参加/退出/開始看板として登録する |
/yukigassen setsign delete |
視線先の登録看板を解除する（テキストも消去） |
運営の流れ¶
- プレイヤーがコマンドまたはロビー看板から参加し、人数が集まるのを待つ。
- 必要に応じて
/yukigassen setzanki <数>・/yukigassen setmax <数>・/yukigassen setmin <数>で残機・人数を調整する。 /yukigassen startでゲームを開始する（赤・青スポーン設定が前提）。- 相手チーム全滅で自動的に勝敗が決まり、全員がロビーへ戻る。
- 異常時は
/yukigassen stopで強制停止できる。
権限ノード¶
| 権限 | 既定 | 用途 |
|---|---|---|
yukigassen.admin |
OP | stop・setzanki・setmax・setmin・setstartspawn・setlobby・setspawn・setfield・setsign（delete含む）、および join/leave での他プレイヤー指定。join/leave/start/status/stats（自分対象）は権限不要 |
トラブルシューティング¶
/yukigassen start でゲームが開始できない
赤・青チームのスポーン地点が未設定の可能性があります。/yukigassen setspawn red と /yukigassen setspawn blue を実行してください。また、ロビー参加者が最小開始人数（min-players・既定1）未満の場合も開始できません。/yukigassen setmin <数> で調整できます。
プレイヤーがエリア外に弾かれない
locations.area.pos1 / pos2 が未設定だと、エリア判定が常に有効（マップ全体OK）になります。/yukigassen setfield 1 と /yukigassen setfield 2 でエリアの2点を設定してください。
参加看板が機能しない
看板は /yukigassen setsign <join|leave|start> で登録した 保存座標 で判定されます（手書きテキストでは機能しません）。看板が登録済みか、/yukigassen status の参加/離脱/開始看板の登録数で確認してください。看板の登録には yukigassen.admin 権限が必要です。
ゲーム終了後にプレイヤーがロビーに戻らない
locations.lobby が未設定の可能性があります。/yukigassen setlobby でロビー地点を設定してください。