【RPGツクールMZ プラグイン】カードミニゲーム素材｜ブラックジャック＆ハイ&ロー判定を変数・スイッチで受け取る（動作確認テスト同梱）

酒場や町のイベントに短いカード遊びを1つ足したいとき、判定処理をゼロから書くと時間がかかります。このプラグインは、ブラックジャック風判定とハイ&ロー判定を済ませて、結果を変数とスイッチに渡すところまでを引き受けます。演出は普段どおりイベントコマンドで作れます。

## こんな方向け

- 酒場・カジノ・寄り道イベントに短いミニゲームを入れたいRPGツクールMZユーザー

- 長い自作スクリプトを書かずに、変数とスイッチで報酬分岐を作りたい方

- 「勝ったら鍵をもらえる」「負けたら追い出される」のような分岐を1イベントで済ませたい方

## 収録内容

- RPG Maker MZ用プラグイン AQ_ArcadeCards_MZ.js（1ファイル）

- ブラックジャック風の自動判定（Aと絵札の得点調整・バースト・ディーラーは17点以上で停止）

- ハイ&ローの自動判定（高い / 低い / 同じ の3択予想）

- 動作確認用の自動テスト2本（Node.jsでそのまま再実行できます）

- カード仕様表（CSV）・日本語README・利用条件・更新履歴

## 結果の受け取り方

プラグインコマンドで結果変数IDとスイッチIDを指定するだけです。

- 結果変数: 1 = 勝ち／当たり、0 = 引き分け、-1 = 負け／はずれ

- スイッチ: 勝利・敗北・引き分けを個別にON

- ID に 0 を指定した項目には書き込みません（既存の変数・スイッチを壊しません）

- 乱数シードを固定できるので、テストプレイで同じ結果を再現できます

## 動作確認について

同梱の tests/ にある2本のテストで、カード判定（52枚デッキ・Aの得点調整・バースト・大小判定・ディーラーの停止条件・シャッフルの再現性）と、プラグインコマンド層（コマンド登録・変数とスイッチへの書き込み・ID=0のときに書き込まないこと）を検証しています。購入後、お手元のNode.jsで `node tests/logic_test.js` と `node tests/plugin_command_test.js` を実行すれば同じ結果を確認できます。

## 含まれないもの

- カード画像、背景、BGM、効果音（第三者素材・公式素材を同梱しないため）

- 画面レイアウトやカードのアニメーション演出

- RPG Maker MZ本体

- RPG Maker MVや他エンジン向けのファイル

## 利用条件

購入者本人が制作するゲーム・動画作品へ、商用・非商用を問わず組み込めます。素材ファイルそのもの（改変版を含む）を素材集として再配布・販売することはできません。

## ご注意

実際のお金を扱う賭博、オンラインカジノ、換金性のある報酬設計への利用は想定していません。外部サーバー通信、通信ランキング、課金処理、個人情報の取得は行いません。公式企業との提携・公認・保証を示すものではありません。