クイズ ― OP・運営ガイド¶
クイズ（quiz モジュール）の有効化・設定・問題の追加・NPC や看板の設置・権限・管理コマンドをまとめます。クイズは CasinoPlugin の1モジュールなので、専用 jar の導入は不要です。
基本情報¶
| 項目 | 値 |
|---|---|
| モジュール ID | quiz |
| 所属プラグイン | CasinoPlugin（jp.casinoplugin.CasinoPlugin） |
| メインコマンド | /quiz（エイリアス /q）、/qd、/qt、/quiznpc、/quizsign |
| モジュール設定ファイル | plugins/CasinoPlugin/modules/quiz.yml |
| データファイル | plugins/CasinoPlugin/quiz/（questions.yml / players.yml / signs.yml） |
| softdepend（任意連携） | Citizens（NPC 機能に必要） |
| 依存モジュール | bank（報酬・参加費にエメラルド口座を使用。必須） |
quiz モジュールの位置づけ
クイズは単独プラグインではなく、CasinoPlugin に統合された quiz モジュール です。報酬の付与・タワー参加費の徴収は、すべて bank モジュールのエメラルド口座（EmeraldAPI）経由で行われます。bank が無効だと quiz モジュールは起動に失敗します。CasinoPlugin 全体の構成は CasinoPlugin の OP ページ を参照してください。
有効化¶
クイズは CasinoPlugin に内蔵されているため、専用 jar の導入は不要 です。
- CasinoPlugin が
plugins/に導入されていることを確認する。 plugins/CasinoPlugin/config.ymlを開き、modules.quiz.enabledをtrueにする。- NPC 機能を使う場合は
Citizensプラグインを導入する（softdepend。無くても本体は起動しますが NPC コマンドが無効になります）。 - サーバーを起動（または再起動）する。起動時に
plugins/CasinoPlugin/modules/quiz.ymlとplugins/CasinoPlugin/quiz/questions.yml/players.ymlが自動生成される。
bank モジュールが前提です
クイズの報酬・参加費はエメラルド口座を使います。modules.bank.enabled が false の状態だと、quiz モジュールは起動時に「bank module required」エラーで停止します。bank は有効のまま運用してください。
quiz.yml 設定項目¶
plugins/CasinoPlugin/modules/quiz.yml でクイズの動作を調整します。主なキーは以下の通りです。
デイリークイズ（daily_quiz）¶
| キー | 既定値 | 説明 |
|---|---|---|
daily_quiz.enabled |
true |
デイリークイズを有効にするか |
daily_quiz.questions_per_day |
5 |
1日に出題する問題数 |
daily_quiz.reset_hour |
0 |
リセット時刻（メッセージ表示に使用。既定は0時） |
daily_quiz.allow_retry |
false |
同日中の再挑戦を許可するか（false で1日1回のみ） |
daily_quiz.rewards.per_correct |
5 |
1問正解ごとの報酬エメラルド |
daily_quiz.rewards.perfect_bonus |
25 |
全問正解時の追加ボーナスエメラルド |
daily_quiz.streak_bonuses |
3:15 7:50 14:150 30:500 |
連続参加日数ごとのボーナス（日数: エメラルド） |
クイズタワー（tower）¶
| キー | 既定値 | 説明 |
|---|---|---|
tower.enabled |
true |
クイズタワーを有効にするか |
tower.total_floors |
100 |
タワーの総階数 |
tower.entry_cost |
100 |
参加費（エメラルド） |
tower.max_failures |
10 |
この回数失敗するとゲームオーバー |
tower.checkpoint_rewards.<階> |
100階のみ emeralds: 1000 |
10階ごとのチェックポイント報酬（emeralds / command / message） |
tower.retreat_reward_enabled |
true |
チェックポイントでの撤退報酬を有効にするか |
撤退報酬は固定値ではなく entry_cost × 到達階 ÷ 10 で計算されます。チェックポイント報酬の command を指定すると、{player} をプレイヤー名に置換してコンソールから実行されます（カスタムアイテム配布などに利用可能）。
ランキング（rankings）¶
| キー | 既定値 | 説明 |
|---|---|---|
rankings.enabled |
true |
ランキング機能を有効にするか |
rankings.reset_schedule |
monthly |
リセット周期（monthly / weekly / never） |
rankings.reset_day |
1 |
リセットする日（月の何日） |
rankings.display_top |
10 |
ランキングに表示する人数 |
その他¶
| キー | 既定値 | 説明 |
|---|---|---|
anti_cheat.* |
― | 不正防止用の設定群（最低回答時間・問題の重複防止など） |
messages.* |
― | チャットメッセージのテンプレート（& カラーコード対応） |
debug.enabled |
false |
デバッグログの出力 |
設定変更後はリロードを
quiz.yml や questions.yml を編集したら、/quiz admin reload で再読み込みできます。サーバー全体を再起動する必要はありません。
問題の追加方法¶
クイズの問題は plugins/CasinoPlugin/quiz/questions.yml で管理します。初回起動時に既定の問題セットが自動生成されます。
問題は questions: セクションの下に、一意の ID（q001 など）をキーとして1問ずつ記述します。
questions:
q001:
text: "マインクラフトで最も硬いブロックは？"
choices:
- "黒曜石"
- "ダイヤモンドブロック"
- "岩盤"
- "エンダーチェスト"
correct: 2 # 0=A, 1=B, 2=C, 3=D（正解の選択肢のインデックス）
difficulty: "easy" # easy / medium / hard
category: "minecraft"
| キー | 説明 |
|---|---|
text |
問題文 |
choices |
選択肢。ちょうど4つ 必要（A〜D に対応） |
correct |
正解の番号。0〜3（A〜D） |
difficulty |
難易度。easy / medium / hard |
category |
カテゴリ（現状は内部分類用） |
問題フォーマットの注意
選択肢が4つでない、または correct が 0〜3 の範囲外の問題は、読み込み時に無視されます（起動ログに警告が出ます）。問題が1問も読み込めないとクイズモジュールは停止します。
難易度と階の対応
クイズタワーは階に応じて難易度を選びます（1〜30階＝easy、31〜60階＝easy+medium、61〜90階＝medium+hard、91〜100階＝hard）。デイリークイズは easy 問題から出題されます。各難易度の問題をバランスよく用意してください。
NPC・ランキング看板の設置¶
クイズ NPC（/quiznpc）¶
Citizens プラグインが導入されている場合、NPC を右クリックしてクイズを開始させられます。NPC コマンドは Citizens が無いと登録されません。
NPC の タイプ は3種類です。
| タイプ | 右クリック時の動作 |
|---|---|
daily |
デイリークイズを開始 |
tower |
クイズタワーを開始 |
menu |
クイズのメニュー（コマンド案内）をチャット表示 |
ランキング看板（/quizsign）¶
設置済みの看板をランキング表示看板として登録できます。看板は 5分ごとに自動更新 されます。
看板の タイプ は2種類です。
| タイプ | 表示内容 |
|---|---|
daily |
デイリー正解数ランキング |
tower |
クイズタワー到達階ランキング |
<順位> には 1・2・3… のように表示したい順位を指定します（1看板につき1順位）。登録情報は plugins/CasinoPlugin/quiz/signs.yml に保存されます。
管理コマンド¶
| コマンド | 必要権限 | 説明 |
|---|---|---|
/quiz admin reload |
quiz.admin.reload |
quiz.yml と questions.yml を再読み込み |
/quiz admin stats |
quiz.admin.reload |
登録プレイヤー数・総問題数を表示 |
/quiznpc <create\|remove\|settype> |
quiz.admin.npc |
クイズ NPC の管理（Citizens 必須） |
/quizsign <create\|remove\|update\|list> |
quiz.admin.sign |
ランキング看板の管理 |
権限ノード¶
| 権限 | 既定 | 用途 |
|---|---|---|
quiz.use |
false | クイズ機能（デイリー／タワー／ランキング）の利用。子に quiz.daily / quiz.tower / quiz.ranking を含む |
quiz.daily |
false | デイリークイズを利用できる |
quiz.tower |
false | クイズタワーを利用できる |
quiz.ranking |
false | クイズランキングを表示できる |
quiz.admin |
false | クイズ管理コマンド全権限。子に quiz.use / quiz.admin.reload / quiz.admin.npc / quiz.admin.sign を含む |
quiz.admin.reload |
false | /quiz admin reload ・stats を使える |
quiz.admin.npc |
false | /quiznpc を使える |
quiz.admin.sign |
false | /quizsign を使える |
quiz.* の権限はすべて既定 false
quiz.* 系の権限は すべて既定値が false です。OP であっても自動では付与されません。プレイヤーにクイズを遊ばせるには、権限プラグイン（LuckPerms 等）で quiz.use を付与してください。運営スタッフには quiz.admin を付与すると、利用権限と管理権限がまとめて有効になります。
トラブルシューティング¶
クイズのコマンドが「不明なコマンド」になる
config.yml の modules.quiz.enabled が false になっている可能性があります。true にしてサーバーを再起動してください。起動ログで quiz モジュールが正常に起動しているかも確認します。
起動時に「bank module required」で quiz が止まる
クイズはエメラルド口座（bank モジュール）に依存します。modules.bank.enabled が true であることを確認してください。
プレイヤーがクイズを遊べない
quiz.use 系の権限は既定 false です。権限プラグインで quiz.use を付与してください。OP でも自動では付与されません。
/quiznpc が使えない / NPC を作れない
NPC 機能は Citizens に依存します。Citizens が導入されていないと /quiznpc コマンド自体が登録されません。Citizens を導入してサーバーを再起動してください。起動ログに「Citizens フック成功」が出ているか確認します。
問題が出題されない / 起動時に quiz が停止する
questions.yml に有効な問題が1問も無いと quiz モジュールは停止します。選択肢が4つでない、correct が範囲外などの不正な問題は無視されます。起動ログの警告を確認し、/quiz admin reload で再読み込みしてください。
ランキング看板が更新されない
看板は5分ごとに自動更新されます。すぐに反映したい場合は /quizsign update で手動更新してください。看板が正しく登録されているかは /quizsign list で確認できます。