CasinoPlugin ― OP・運営ガイド¶
CasinoPlugin の導入・共通設定・モジュール構成・権限・コマンドの全体像をまとめます。各ゲームの個別設定は、それぞれの個別ページを参照してください。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | CasinoPlugin |
| api-version | 26.1.2 |
| メインクラス | jp.casinoplugin.CasinoPlugin |
| softdepend（任意連携） | WorldGuard（競馬・育成馬の領域用） |
| 共通設定 | plugins/CasinoPlugin/config.yml（全体設定とモジュール有効フラグ） |
| データ | plugins/CasinoPlugin/accounts.yml、各モジュール用ファイル |
CasinoPlugin の構成
CasinoPlugin は 銀行（bank）＋8ゲームの計9モジュール を1つのjarに統合したプラグインです。ModuleRegistry が config.yml の modules.<id>.enabled を見て、有効なモジュールだけを起動します。あるモジュールが起動に失敗しても他のモジュールは動き続ける設計です。
導入手順¶
- ビルドした
CasinoPlugin-*.jarをサーバーのplugins/フォルダに配置する。 - 必要に応じて
WorldGuardを導入する（softdepend。無くても本体は起動しますが、競馬・育成馬の領域機能が使えません）。 - サーバーを起動すると
plugins/CasinoPlugin/config.ymlほか、各モジュールが必要とするデータファイル（accounts.ymlなどモジュールごとに異なる）が自動生成される。 config.ymlのmodules:ブロックで、使いたいモジュールだけをenabled: trueにする。- 各ゲームの個別設定（座標・配当・確率など）は、それぞれのモジュールが管理する yml ファイルで編集する（詳細は各ゲームの個別ページ参照）。
bank モジュールは必須
bank モジュールはエメラルドの口座機能（共通通貨）を提供し、他のすべてのゲームがこれに依存します。modules.bank.enabled は 通常 true 固定 で運用してください。false にすると他ゲームの賭け金処理が動きません。
含まれるモジュール一覧¶
| モジュール ID | 内容 | 主なデータ／設定ファイル |
|---|---|---|
bank |
エメラルド銀行（経済基盤・共通通貨） | accounts.yml（残高） |
poker |
ポーカー（テキサスホールデム） | poker/ 配下 |
slot |
スロットマシン | slot/ 配下 |
lottery |
宝くじ | lottery/ 配下 |
tintiro |
チンチロ（サイコロ賭博） | tintiro/ 配下 |
blackjack |
ブラックジャック | blackjack/ 配下 |
horse |
競馬（7種類の馬券） | horse/ 配下 |
emhorse |
育成馬（EmeraldHorse・馬を育てて競馬に出走） | emhorse_data.yml / modules/emhorse.yml |
quiz |
クイズ（デイリー＋タワー） | quiz/ 配下 |
未記載モジュールは既定で有効
config.yml の modules: ブロックには全9モジュール（bank / poker / slot / lottery / tintiro / blackjack / horse / quiz / emhorse）が記載されています。仮に何らかのモジュールの項目が未記載でも、未記載のモジュールは 既定で有効（true） として起動します。無効化したい場合のみ modules.<id>.enabled: false を手動で追記してください。
各ゲームの詳細は個別ページへ
上記モジュールの個別設定（座標設定・配当率・確率調整など）は、このページでは深掘りしません。各ゲームの個別ページにまとめられています。
config.yml 主要項目¶
config.yml は 全体設定とモジュール有効フラグのみ を扱います。各ゲームの個別設定は modules/<name>.yml に分離されています。
| キー | 既定値 | 説明 |
|---|---|---|
locale |
ja |
言語ロケール（現状 ja のみ） |
server-account-uuid |
00000000-0000-0000-0000-000000000000 |
ハウス（ディーラー側）として使う固定 UUID。ベット金額の一時保管口座。通常は既定のままで問題なし |
modules.<id>.enabled |
true |
各モジュールの有効化フラグ。false にすると onEnable が呼ばれず、コマンド・リスナーも登録されない |
debug.verbose |
false |
true で各モジュールの詳細ログを出力（本番では false 推奨） |
モジュールの ON / OFF
modules: ブロックには bank / poker / slot / lottery / tintiro / blackjack / horse / quiz / emhorse の9項目があります。不要なゲームを enabled: false にすると、そのコマンドとリスナーは一切登録されず、サーバーが軽くなります。bank だけは前述の通り true 固定が前提です。
config.yml の新キーは自動追記されません
本体は起動時に saveDefaultConfig() を呼びますが、これは config.yml が 存在しない場合のみ 同梱版を書き出す動作です（copyDefaults は使っていません）。そのため、プラグイン更新で新しい設定キーが増えても、既存サーバーの config.yml には自動で追記されません。新しく追加された設定キーを使いたい場合は手動で追記するか、一度 config.yml を退避してから再生成してください。
権限ノード¶
ゲーム別に整理します。各モジュールごとに個別の権限ノードがあります。
銀行（bank）¶
| 権限 | 既定 | 用途 |
|---|---|---|
emerald.list |
全員 | 全プレイヤーの残高リストを表示 |
emerald.admin |
OP | 管理者用コマンド（ATM 看板設置など） |
ポーカー（poker）¶
| 権限 | 既定 | 用途 |
|---|---|---|
poker.admin |
OP | ポーカー管理コマンドの全権限（下記3つを含む） |
poker.admin.setup |
OP | セットアップ系コマンド |
poker.admin.control |
OP | ゲーム制御系コマンド |
poker.admin.debug |
OP | デバッグ系コマンド |
スロット（slot）¶
| 権限 | 既定 | 用途 |
|---|---|---|
slot.admin |
OP | スロットの管理（設置・設定） |
slot.remote |
OP | リモートスロットアイテムを取得できる |
スロットの利用権限について
slot.use という権限は存在しません。プレイヤーは [スロット] 看板からスロットを利用します（看板操作に専用権限は不要）。
宝くじ（lottery）¶
| 権限 | 既定 | 用途 |
|---|---|---|
kuzi.admin |
OP | 宝くじの管理（看板設置など） |
kuzi.reload |
OP | 宝くじ機能のリロード権限 |
ブラックジャック（blackjack）¶
| 権限 | 既定 | 用途 |
|---|---|---|
blackjack.start |
OP | ブラックジャックを開始する |
blackjack.stop |
OP | ブラックジャックを強制終了する |
blackjack.setup |
OP | 看板・地点の設定 |
プレイヤーは看板から参加
/blackjack コマンドは原則 OP 専用です。プレイヤーは [BlackJack] 看板を経由して参加します。
チンチロ（tintiro）¶
| 権限 | 既定 | 用途 |
|---|---|---|
tintiro.admin |
OP | チンチロの管理コマンド全権限 |
プレイヤーは看板から参加
/tintiro コマンドは原則 OP 専用です。プレイヤーは [チンチロ] 看板（lobby/leave/金額/open）から参加します。
競馬（horse）¶
| 権限 | 既定 | 用途 |
|---|---|---|
horseracing.admin |
OP | 競馬の管理コマンド全権限 |
horseracing.bet |
OP | /horseracing bet の実行権限（プレイヤーは getitem 看板で取得した馬券アイテムからベット） |
horseracing.sign.create |
OP | 馬券販売所/結果掲示看板の設置 |
育成馬（emhorse）¶
| 権限 | 既定 | 用途 |
|---|---|---|
emhorse.admin |
OP | 育成馬の管理コマンド（/emhorse ...）全権限・看板設置 |
プレイヤーは看板・アイテムから操作
/emhorse コマンドは OP 専用です。プレイヤーは [馬ショップ] / [厩舎] / [出走受付] 看板と、子馬券・呼び笛・エサのアイテムで育成・出走します。
クイズ（quiz）¶
| 権限 | 既定 | 用途 |
|---|---|---|
quiz.use |
false | クイズ機能（デイリー / タワー / ランキング）を利用できる |
quiz.daily |
false | デイリークイズを利用できる |
quiz.tower |
false | クイズタワーを利用できる |
quiz.ranking |
false | クイズランキングを利用できる |
quiz.admin |
false | クイズ管理コマンド全権限 |
quiz.admin.reload |
false | クイズの reload |
quiz.admin.sign |
false | ランキング看板の管理 |
クイズの権限は既定 false
quiz.* 系の権限は 既定値が false です。プレイヤーにクイズを遊ばせたい場合は、権限プラグイン（LuckPerms 等）で quiz.use を付与してください。
コマンド一覧¶
ゲーム別に整理します。
銀行（bank）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/emerald |
/eb |
Emerald Bank メインコマンド（book / money / deposit / withdraw / send / list / wallet / gui / ranking / blankbook / blankwallet） |
/ed <金額> |
― | /emerald deposit のエイリアス（預け入れ） |
/ew <金額> |
― | /emerald withdraw のエイリアス（引き出し） |
ポーカー（poker）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/poker <join\|leave\|setlobby\|setstartspawn\|setfield\|setsign\|bet\|raisemoney\|start\|stop\|status> |
/pk |
テキサスホールデムポーカー（join/leave は全員可、その他は OP） |
スロット（slot）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/slot [remote\|setsign] |
― | スロットマシン GUI / 起動ロッド取得 / 看板登録（OP専用、権限 slot.admin） |
宝くじ（lottery）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/kuzi <種類> <枚数> |
/lottery |
宝くじ機能 |
チンチロ（tintiro）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/tintiro [subcommand] |
/ti |
チンチロゲームコマンド |
ブラックジャック（blackjack）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/blackjack <join\|leave\|bet\|start\|stop\|setup> |
― | ブラックジャックゲーム |
競馬（horse）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/horseracing <subcommand> |
― | 競馬プラグインコマンド |
育成馬（emhorse）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/emhorse <subcommand> |
― | 育成馬の管理（OP専用。看板設置・子馬券/エサ付与・調整など。詳細は育成馬ページ） |
クイズ（quiz）¶
| コマンド | エイリアス | 説明 |
|---|---|---|
/quiz [daily\|tower\|ranking\|admin] |
/q |
クイズメインコマンド（権限 quiz.use） |
/qd |
― | デイリークイズの直接起動（権限 quiz.use） |
/qt |
― | クイズタワーの直接起動（権限 quiz.use） |
/quizsign [create\|remove\|update\|list] |
― | ランキング看板の管理（権限 quiz.admin） |
各ゲームのサブコマンドの詳細
上記の各コマンドのサブコマンドの細かい使い方（座標設定・運営フローなど）は、それぞれのゲームの個別ページにまとめられています。
トラブルシューティング¶
あるゲームのコマンドが「不明なコマンド」になる
そのモジュールが config.yml の modules.<id>.enabled: false で無効化されている可能性があります。無効モジュールはコマンド・リスナーが一切登録されません。起動ログに「module [
起動ログに「module [] の有効化に失敗しました」と出る
そのモジュールの onEnable で例外が発生しています。ModuleRegistry は例外を捕捉してログに残すため、他モジュールは動き続けますが、該当モジュールは停止状態です。スタックトレースを確認し、modules/<name>.yml の設定不備などを疑ってください。
プレイヤーがクイズを遊べない
quiz.use 系の権限は 既定 false です。権限プラグインで quiz.use を付与してください。
賭け金の処理が動かない / 残高が反映されない
bank モジュールが有効になっているか確認してください。bank は共通通貨の基盤で、modules.bank.enabled が false だと他ゲームの賭け金・配当処理が機能しません。