統計サブコマンド【ダイスプラグイン】

←マニュアルトップへ戻る

ダイスの統計処理に関するコマンドです。
ゾロ目の有無やポーカーのような役を判定するのに便利です。
サンプルではちんちろりんの役を判定するのに使用しています。

ここではダイスID1~5を使用して５つのサイコロを振ったときのポーカー役の判定で説明していきます。

「randRoll/乱数ロール」コマンドなどでダイスの目が決定したら、まずは
『dice analyze start 1 2 3 4 5』のように「analyze start/統計 開始」コマンドを必ず実行してください。

このコマンドを行うと、全ての統計データが計算されて内部に保存されます。
その後に「analyze total/統計 合計値」といった各種統計サブコマンドを使うことで各項目を変数にセットすることができます。

コマンド解説

コマンド一覧

• start/開始 → 各種統計を取得する準備
• total/合計 → 目の合計値を変数にセット
• total/合計 → 目の合計値を変数にセット
• multiply/乗算 → 目を全て掛けた値を変数に
• max/最大値 → 最大の目の値を変数にセット
• min/最小値 → 最小の目の値を変数にセット
• num/目 → 指定した目のダイスの数
• pair/ペア → 指定したペアの組みの数
• maxPair/最大ペア → 最大のペア数
• maxPairNum/最大ペアの目 → 最大ペアの目(の最大値)
• straight/ストレート → ストレート判定値をセット
• end/終了 → 分析を終了

start/開始 → 各種統計を取得する準備

▷パラメータ：「ダイスID,ダイスID…」
簡易例）『dice analyze start』
　→ 表示中の全ダイスを対象に統計を取る
詳細例）『dice analyze start 1 2 3』
　→ ダイスID1,2,3の統計を取る

total/合計 → 目の合計値を変数にセット

▷パラメータ：「変数番号」
簡易例）『dice analyze total 1』
　→ 統計を行ったダイスの合計値を変数1にセット
(要:事前に統計 開始コマンド)
　multiply/乗算

▷補足

multiply/乗算 → 目を全て掛けた値を変数に

▷パラメータ：「変数番号」
簡易例）『dice analyze muliply 1』
　→ 統計を行ったダイス目を掛け合わせた値を変数1にセット
(要:事前に統計 開始コマンド)
　
▷補足

max/最大値 → 最大の目の値を変数にセット

▷パラメータ：「変数番号」
簡易例）『dice analyze max 1』
　→ 統計を行ったダイスのうち最大の値を変数1にセット
(要:事前に統計 開始コマンド)
　

▷補足

min/最小値 → 最小の目の値を変数にセット

▷パラメータ：「変数番号」
簡易例）『dice analyze min 1』
　→ 統計を行ったダイスのうち最小の値を変数1にセット
(要:事前に統計 開始コマンド)
　
▷補足

num/目 → 指定した目のダイスの数

▷パラメータ：「変数番号 対象の目」
簡易例）『dice analyze num 1 2』
　→ 統計を行ったダイスのうち目が2のダイス数を変数1にセット（ダイスの目が1,2,1,2,2の場合は2の目が3つあるので3となる）
(要:事前に統計 開始コマンド)

▷補足

pair/ペア → 指定したペアの組みの数

▷パラメータ：「変数番号 対象のペア数（※ペア数2は２つのダイスの目が同じ、ペア数3は３つのダイスの目が同じ状態を指す）」
簡易例）『dice analyze pair 1 2』
　→ 統計を行ったダイスのうちペア数2の組の数を変数1にセット(ダイスの目が4,5,5,6,6の場合はペア数2の組みは5と6で2つ)
(要:事前に統計 開始コマンド)
　
▷補足
５つのダイスを投げると、同じ目が１つの場合（すべての目がバラバラ）〜５つ（全部が同じ目）の場合まである。

例えばポーカー役の２ペアかどうかを調べたかったら『dice analyze pair 1 2』のように変数１にペア数２の個数を代入して、その値が２であれば良い。

フルハウスかどうかを調べたかったらペア数２が１つ、ペア数３が１つ。
３カードを調べたかったらペア数３が１つ、かつペア数２が０個であれば良い。

maxPair/最大ペア → 最大のペア数

▷パラメータ：「変数番号」
簡易例）『dice analyze maxPair 1』
　→ 統計を行ったダイスの最大ペア数を変数1にセット(ダイスの目が4,4,5,5,5の場合は5のペア数3が最大のペア数となる)
(要:事前に統計 開始コマンド)
　
▷補足

maxPairNum/最大ペアの目 → 最大ペアの目(の最大値)

▷パラメータ：「変数番号」
簡易例）『dice analyze maxPairNum 1』
　→ 統計を行ったダイスの最大ペアの目を変数1にセット(ダイスの目が4,4,4,5,5の場合の最大ペア数は3でその目の「4」が最大ペアの目となる)
(要:事前に統計 開始コマンド)
　
▷補足

ポーカーの同じ役同士で目の大きさで判定したいようなときに便利です。

straight/ストレート → ストレート判定値をセット

▷パラメータ：「変数番号」
簡易例）『dice analyze straight 1』
　→ 統計を行ったダイスのストレート判定を変数1にセット(2,3,4なら判定は2、4,5,6は判定6、1,3,4は連続になってないので0）
(要:事前に統計 開始コマンド)
　
▷補足
すべての目が連続になっているかを判定します。
連続になっている場合は最小の目、連続になっていない場合は０がセットされます。

例えば、ちんちろりんの役の判定では『dice analyze straight 1』のように変数1にストレート判定の結果をセットし、

結果が1の場合は目が1,2,3となっている状態でヒフミ、
結果が4の場合は目が4,5,6となっている状態でシゴロのように判定しています。
（ペアがなくてストレート判定が0の場合は目ナシ）

end/終了 → 分析を終了

▷パラメータ：なし
簡易例）『dice analyze end』
　→ 分析を終了（再度統計結果を取得するには統計 開始コマンドを使用)

▷補足
分析が終わった際にendコマンドで統計結果を消去しておくことで、セーブデータ容量が多少ですが少なくなります。

設定系コマンド【ダイスプラグイン】

←マニュアルトップへ戻る

ダイスの内部設定に関するコマンドです。
（※補足以外のパラメータ解説はチートシートと同じ内容です。）

コマンド一覧

• clear/クリア → 非表示ののち設定をクリア
• type/タイプ → タイプ設定の変更
• variable/変数 → 紐付ける変数を変更
• number/目 → 指定した目をセット
• max/最大値 → ダイスの最大の目をセット
• min/最小値 → ダイスの最小の目をセット

clear/クリア → 非表示ののち設定をクリア

▷パラメータ：「ダイスID 所要時間」
簡易例）『dice clear 1』
　→ ダイスID1の設定を初期化
詳細例）『dice clear all 10』(所要時間は使わないのを推奨）
　→ 全てのダイスを10フレームかけて非表示にしたのち設定を初期化

▷補足
『dice clear 1 10』のように所要時間を設定すると、フェードアウト後に設定のクリアが行われます。
この際に、所要時間を待たずに『dice show 1』のようにダイスを表示したり設定を行ってしまうと、設定のクリアが行われなかったり、表示した直後にクリアされてしまいます。

直後にダイスの再表示や設定を行う可能性がある場合は『dice hide 1 10』のようにhideコマンドで非表示にしてウェイトコマンドで10フレーム待機したあとに『dice clear 1』と即座に設定をクリアすると安全です。

type/タイプ → タイプ設定の変更

▷パラメータ：「ダイスID タイプ」
簡易例）『dice type 1 すごろく』
　→ ダイスID1のタイプを「すごろく」に変更

▷補足
タイプはプラグイン設定で登録することが可能です。

variable/変数 → 紐付ける変数を変更

▷パラメータ：「ダイスID 変数番号」
簡易例）『dice variable 1 31』
　→ ダイスID1と紐付ける変数番号を31に変更
詳細例）『dice variable 1 clear』
　→ ダイスID1の変数設定を初期化

▷補足
基本的にはプラグイン設定の「同期変数の開始番号」に基づいた変数と同期していますが、一時的に紐付ける変数を変えたい場合に使用してください。
clearコマンドで設定を初期化すると同期先は元の変数に戻ります。
（同期しているというのは紐付いている変数の値が変われば表示されているダイスの目が変わり、プラグインコマンドでダイスの目を変えると変数の値も自動で変わります。）

number/目 → 指定した目をセット

▷パラメータ：「ダイスID 目の値」
簡易例）『dice number 1 6』
　→ ダイスID1の目を6にセット
詳細例）『dice number 1 max』
　→ ダイスID1の目を最大値にセット

▷補足
使う機会は少ないと思いますが、サンプルのすごろくでは右上に手持ちのダイスを表示する際に、手動で最大値にセットしてダイスの種類がわかりやすいようにしています。

max/最大値 → ダイスの最大の目をセット

▷パラメータ：「ダイスID 最大値」
簡易例）『dice max 1 3』
　→ ダイスID1の最大値を3に変更(4以上は出ない)
詳細例）『dice max 1 clear』
　→ ダイスID1の最大値の設定を初期化する

▷補足
すごろくの「１２３サイ」では、面数６のダイス画像を使っていますが、最大の目を３にセットすることで１〜３の目しか出ないサイコロとなっています。

min/最小値 → ダイスの最小の目をセット

▷パラメータ：「ダイスID 最小値」
簡易例）『dice min 1 4』
　→ ダイスID1の最小値を4に変更(3以下は出ない)
詳細例）『dice min 1 clear』
　→ ダイスID1の最小値の設定を初期化する

▷補足
すごろくの「４５６サイ」では、面数６のダイス画像を使っていますが、最小の目を４にセットすることで４〜６の目しか出ないサイコロとなっています。

表示/演出系コマンド【ダイスプラグイン】

←マニュアルトップへ戻る

ダイスの表示や演出に関するコマンドです。
（※補足以外のパラメータ解説はチートシートと同じ内容です。）

コマンド一覧

• show/表示 → 位置を指定してダイス表示
• hide/非表示 → 非表示、フェードアウト
• change/変化 → 目がコロコロ変わる演出
• row/行 → 画像の行数を変更
• move/移動 → ダイスの位置を移動
• relativeMove/相対移動 → 移動量を指定して相対移動
• scale/拡大 → ダイスの拡大と縮小
• animation/アニメーション → アニメーションの再生
• layer/レイヤー → ダイス表示の重なり順を変更
• preload/プリロード → ダイス画像のプリロード

show/表示 → 位置を指定してダイス表示

▷パラメータ：「ダイスID X位置 Y位置 所要時間」
簡易例）『dice show 1』
　→ ダイスID1を瞬時に表示
詳細例）『dice show 1 408 312 10』
　→ 10フレームかけてダイスID1をx=408、y=312の位置に表示

▷補足
事前に「move/移動」コマンドで位置を指定しておくことも可能です。
その際は、X,Y座標はデフォルト(def)指定してください。
例）

dice move 1 408 312
dice show 1 def def 30

ダイス1をx=408,y=312に瞬時にセットし、showコマンドでx,y位置を変えずに30フレームで表示。

hide/非表示 → 非表示、フェードアウト

▷パラメータ：「ダイスID 所要時間」
簡易例）『dice hide 1』
　→ ダイスID1を瞬時に非表示
詳細例）『dice hide all 10』
　→ 全てのダイスを10フレームかけて非表示

row/行 → 画像の行数を変更

▷パラメータ：「ダイスID 行数」
簡易例）『dice row 1 2』
　→ ダイスID1の画像を「Dice_面数.png」内の2行目のものに変更
▷補足
↓行は上から順に１行目、２行目…

change/変化 → 目がコロコロ変わる演出

▷パラメータ：「ダイスID インターバル」
簡易例）『dice change 1』
　→ ダイスID1のロール完了まで目をコロコロと変化
詳細例）『dice change 1 10』(目押しのようなことは不可)
　→ ダイス1の目をロールが完了するまで10フレームごとに変化

▷補足
ダイスロールが完了するまで目が変わり続けます。
手動で止めるには『dice change 1 stop』としてください。

move/移動 → ダイスの位置を移動

▷パラメータ：「ダイスID X座標 Y座標 所要時間」
簡易例）『dice move 1 100 200』
　→ ダイスID1をx=100,y=200の位置に瞬時に移動
詳細例）『dice move 1 100 200 30』
　→ ダイスID1をx=100,y=200の位置に30フレームかけて移動

▷補足

relativeMove/相対移動 → 移動量を指定して相対移動

▷パラメータ：「ダイスID X移動量 Y移動量 所要時間」
簡易例）『dice relativeMove 1 100 200』
　→ ダイスID1をxに+100、yに+200に瞬時に移動
詳細例）『dice relativeMove 1 100 200 30』
　→ ダイスID1をxに+100、yに+200だけ30フレームかけて移動

▷補足

scale/拡大 → ダイスの拡大と縮小

▷パラメータ：「ダイスID 拡大率 所要時間」
簡易例）『dice scale 1 200』
　→ ダイスID1を瞬時に200%に拡大
詳細例）『dice scale 1 50 20』
　→ ダイスID1を拡大率50%まで20フレームかけて縮小

▷補足

animation/アニメーション → アニメーションの再生

▷パラメータ：「ダイスID アニメーションID 左右反転フラグ ディレイ (静止/static)」
簡易例）『dice animation 1 20』
　→ ダイスID1にアニメーションID20を表示
詳細例）『dice animation 1 20 true 30 static』
　→ ダイスID1にアニメーションID20を左右反転で30フレーム後に位置固定で表示

▷補足
静止/staticパラメータはパラメータの最後に指定すれば反映されます。ですので、
『dice animation 1 20 static』のように間のパラメータを省略しててもだいじょうぶです。

↓static無しの場合はアニメーションがダイスの位置に追随し、有りの場合はアニメーションは位置が固定化されます。

layer/レイヤー → ダイス表示の重なり順を変更

▷パラメータ：「Z位置(最前面/ウィンドウ後ろ/ピクチャ後ろ)」
簡易例）『dice layer 最前面』
　→ 全てのダイス表示を最前面に変更
詳細例）『dice layer ピクチャ後ろ』
　→ 全てのダイス表示をピクチャの後ろに変更

▷補足
全てのダイスを一括で重なり順を変更します。
一部のダイスだけを設定することはできませんのでご注意。

preload/プリロード → ダイス画像のプリロード

▷パラメータ：「ダイスID」
簡易例）『dice preload 1』
　→ ダイスID1に設定されているダイス画像を全てプリロードしてちらつきを抑える。

ダイスプラグインマニュアル

Boothにて販売中のRPGツクールMV向けのダイスプラグインのマニュアルページです。（販売ページはこちら）
６面、４面、１０面といったサイコロを表示して振るというシンプルなプラグインですが、スゴロク、ちんちろりん、TRPG風ダイス判定といった抱負なサンプルイベントが付属しています。

• RPGツクールMZでの動作について

使用条件と利用上の注意

ダイスプラグイン使用条件
ダイスプラグイン利用上の注意

本プラグインを使用する際の使用条件ならびに、注意事項と動作対応する環境などについて説明しています。

スタートアップ

基本の使い方【ダイスプラグイン】

このプラグインを始めて触る人は最初に読んでみてください。
プラグインコマンドや画像規格など基本的な内容を解説しています。

• プラグインの一番基本的な使い方
• オリジナルの画像を用意する際の注意点

プラグイン設定項目について

プラグイン設定/ダイスタイプの登録
プラグイン設定の各項目について解説します。
（新しいダイスタイプを登録するにはプラグイン設定から行えます）

ミニゲーム・サンプルデータについて

ミニゲーム・サンプルデータについて
各ミニゲームサンプルデータの簡単な紹介と、コモンイベント・変数・スイッチに関する解説、移植する際の注意点について解説しています。

各コマンドの解説

チートシート(印刷用のコマンド一覧)

以下で各コマンドのパラメータを解説しますが、コマンドごとのパラメータをまとめたチートシートも用意しましたのでご活用ください。（２種類のサイズのPDFが入っています。一部、バージョンが低いと存在しないコマンドやパラメータがある可能性があります。）

表示/演出系コマンド

表示/演出系コマンド【ダイスプラグイン】
ダイスの表示や移動、アニメーションといった見た目の演出に関するコマンドを紹介します。（ダイスロールに関してはロール系コマンド参照）

設定系コマンド

設定系コマンド【ダイスプラグイン】
ダイスの内部設定に関するコマンドを紹介します。ダイスの目の範囲を設定したり、タイプや紐付ける変数を一時的に変更することができます。

ロール系コマンド

ロール系コマンド【ダイスプラグイン】
このプラグインの核ともなるダイスロールに関するコマンドを紹介します。

統計サブコマンド

統計サブコマンド【ダイスプラグイン】
複数のダイスを振った場合にゾロ目になっているか・ストレートになっているかといった判定に便利な統計サブコマンドについて紹介します。

グループ系プラグイン

グループ系プラグインのコマンド【ダイスプラグイン】
ダイスプラグイン付属のグループ系プラグインのコマンドを紹介します。
ランダムな宝箱、戦闘、イベントの処理を条件分岐を使わず手早く実装できます。

カスタム情報ウィンドウプラグイン

カスタム情報ウィンドウプラグインのコマンド【ダイスプラグイン】
ダイスプラグイン付属の「カスタム情報ウィンドウプラグイン」のコマンドを紹介します。マップ上での情報表示に特化したオリジナルウィンドウを表示することができます。

[進捗]施設メニューの表示

進捗

フィールドマップ場面のシステムも大詰めです！
街やダンジョンのマスに止まった際のメニュー表示を実装しました。

↓ボタンが全部訓練所になってるけど、街では「鍛冶屋」「冒険者ギルド」「馬車小屋」などの施設、ダンジョンでは「NORMAL」「HARD」といった難易度コマンドを配置します。

余計なボタン操作なしに施設コマンドが選べて、かつフィールドタップすれば続けて移動もできるのでなかなか優れたUI設計では？と自画自賛してます💪

こういうUIは縦長＆タッチ操作のスマホならではで色々と工夫のしがいがありますね！

ダイスプラグインの方は明日動作テストして大きな不具合がなければ
明日か明後日に販売できるかなと思います！
（明日の朝あたりにヘルプページを大量にアップすると思いますのでお目汚し失礼します）