ロール系コマンド【ダイスプラグイン】

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

ダイスロールに関するコマンドです。
ダイスを振るときは基本的に「randRoll/乱数ロール」コマンドを使いましょう
（※補足以外のパラメータ解説はチートシートと同じ内容です。）

コマンド一覧

• random/乱数 → 乱数の生成
• roll/ロール → ダイスを振るモーション
• randRoll/乱数ロール → 乱数生成&ロールモーション
• wait/ウェイト → ロール完了まで待機

random/乱数 → 乱数の生成

▷パラメータ：「ダイスID」
簡易例）『dice random 1』
　→ ダイスID1の乱数を生成（変数にもセット）

▷補足
ロールモーションはありません。ダイスは動かず目だけ変わります。
また、紐付いている変数の値も自動で変わります。

roll/ロール → ダイスを振るモーション

▷パラメータ：「ダイスID 高さ 振り下ろしフラグ」
簡易例）『dice roll 1』
　→ ダイスID1をタイプ設定のモーションでロール
詳細例）『dice roll 1 300 true』
　→ ダイスID1を高さ300で「その場から振り下ろし」のロールモーション

▷補足
ダイスの目は変わらずロールモーションのみ行います。
ダイスの登場演出に使ったり、ダイス目は変数で操作してモーションだけ行いたいときに使用してください。

randRoll/乱数ロール → 乱数生成&ロールモーション

▷パラメータ：「ダイスID 高さ 振り下ろしフラグ」
簡易例）『dice randRoll 1』
　→ ダイスID1の乱数を生成してロール
詳細例）『dice randRoll 1 300 true』
　→ ダイスID1の乱数を生成し、高さ300で「その場から振り下ろし」のロールモーション

▷補足
乱数を生成してロールモーションを行います。
「その場から振り下ろし」では繰り返すとどんどんと下がっていくので、showコマンドやmoveコマンドでその都度位置を調整する必要があります。

↓左が「持ち上げ」、左が「その場から振り下ろし」でロールを繰り返した場合

wait/ウェイト → ロール完了まで待機

▷パラメータ：なし
簡易例）『dice wait』
　→ 全てのダイスのロールアニメーション完了まで待機

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

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

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

ここではダイス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コマンドで統計結果を消去しておくことで、セーブデータ容量が多少ですが少なくなります。

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

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

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

コマンド一覧

• 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は縦長＆タッチ操作のスマホならではで色々と工夫のしがいがありますね！

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