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

CasinoPlugin ― OP・運営ガイド

CasinoPlugin の導入・共通設定・モジュール構成・権限・コマンドの全体像をまとめます。各ゲームの個別設定は、それぞれの個別ページを参照してください。

基本情報

項目	値
プラグイン名	CasinoPlugin
api-version	26.1.2
メインクラス	jp.casinoplugin.CasinoPlugin
softdepend（任意連携）	WorldGuard（競馬・育成馬の領域用）、Citizens（クイズの NPC 用）
共通設定	plugins/CasinoPlugin/config.yml（全体設定とモジュール有効フラグ）
データ	plugins/CasinoPlugin/accounts.yml、各モジュール用ファイル

CasinoPlugin の構成

CasinoPlugin は 銀行（bank）＋8ゲームの計9モジュール を1つのjarに統合したプラグインです。ModuleRegistry が config.yml の modules.<id>.enabled を見て、有効なモジュールだけを起動します。あるモジュールが起動に失敗しても他のモジュールは動き続ける設計です。

導入手順

1. ビルドした CasinoPlugin-*.jar をサーバーの plugins/ フォルダに配置する。
2. 必要に応じて WorldGuard・Citizens を導入する（softdepend。無くても本体は起動しますが、競馬・育成馬の領域機能やクイズの NPC 機能が使えません）。
3. サーバーを起動すると plugins/CasinoPlugin/config.yml ほか、各モジュールが必要とするデータファイル（accounts.yml などモジュールごとに異なる）が自動生成される。
4. config.yml の modules: ブロックで、使いたいモジュールだけを enabled: true にする。
5. 各ゲームの個別設定（座標・配当・確率など）は、それぞれのモジュールが管理する 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 に emhorse が無い場合

同梱の config.yml の modules: には emhorse の項目が無いことがありますが、未記載のモジュールは 既定で有効（true） として起動します。無効化したい場合のみ modules.emhorse.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 の8項目があります（emhorse は未記載ですが既定 true で起動します）。不要なゲームを enabled: false にすると、そのコマンドとリスナーは一切登録されず、サーバーが軽くなります。bank だけは前述の通り true 固定が前提です。

権限ノード

ゲーム別に整理します。各モジュールごとに個別の権限ノードがあります。

銀行（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.npc	false	クイズ NPC の管理
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 <setup\|bet\|sign1-5\|start\|stop\|status>	/pk	テキサスホールデムポーカー

スロット（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）
/quiznpc [create\|remove\|settype]	―	クイズ NPC 管理（Citizens 必須、権限 quiz.admin）
/quizsign [create\|remove\|update\|list]	―	ランキング看板の管理（権限 quiz.admin）

各ゲームのサブコマンドの詳細

上記の各コマンドのサブコマンドの細かい使い方（座標設定・運営フローなど）は、それぞれのゲームの個別ページにまとめられています。

トラブルシューティング

あるゲームのコマンドが「不明なコマンド」になる

そのモジュールが config.yml の modules.<id>.enabled: false で無効化されている可能性があります。無効モジュールはコマンド・リスナーが一切登録されません。起動ログに「module [] は config で無効化されています」が出ていないか確認してください。

起動ログに「module [] の有効化に失敗しました」と出る

そのモジュールの onEnable で例外が発生しています。ModuleRegistry は例外を捕捉してログに残すため、他モジュールは動き続けますが、該当モジュールは停止状態です。スタックトレースを確認し、modules/<name>.yml の設定不備などを疑ってください。

クイズの NPC コマンドが使えない / NPC を作れない

クイズの NPC 機能（/quiznpc）は Citizens に依存します。Citizens が導入されているか確認してください。Citizens は softdepend なので、未導入でも CasinoPlugin 本体は起動しますが NPC 機能は使えません。

プレイヤーがクイズを遊べない

quiz.use 系の権限は 既定 false です。権限プラグインで quiz.use を付与してください。

賭け金の処理が動かない / 残高が反映されない

bank モジュールが有効になっているか確認してください。bank は共通通貨の基盤で、modules.bank.enabled が false だと他ゲームの賭け金・配当処理が機能しません。

---

← 👤 プレイヤー向けページへ ← CasinoPlugin 概要へ