プラグインコマンド集 – TkoolMV_PluginCommandBook.js

Copyright (c) 2015 Alec
This software is released under the MIT License.
http://opensource.org/licenses/mit-license.php

このプラグインは有志によるプラグインコマンド集です。
商用利用、年齢制限のあるゲームへの使用、改変が可能です。
クレジットは不要です。

■使い方
イベントのコマンド追加からプラグインコマンドを選択し、
以下のプラグインコマンドから好きなモノを選んで入力して下さい。

■パラメータについて
プラグインコマンドの右に空白をつけてパラメータを追記することができます。
パラメータは数字、英数字、日本語、記号など以外にも以下のような制御文字が使えます。
（各数字部分には全角数字も使えます）
\V[n] 変数n番目の値に置き換えられます
\N[n] アクターn番の名前に置き換えられます
\P[n] パーティメンバーn番の値に置き換えられます
\G 　　通貨単位に置き換えられます
\In[n] アイテムn番の名前に置き換えられます
\Ip[n] アイテムn番の価格に置き換えられます
\Sn[n] スキルn番の名前に置き換えられます
\Js[X]\Js XをJavaScriptとして評価した値に置き換えられます

その他使用可能な制御文字や、\Js[X]\Jsで使えるスクリプトについては、下記シートを参照してください。
https://docs.google.com/spreadsheets/d/1rOIzDuhLC6IqJPEFciYOmXWL_O7X9-hMValMs7DpWCk/

■プラグインコマンド

===========================================================================
「名前の変更」
主人公の名前を変更する
製作者 Alec

使用例
名前の変更 1 ライアン　　（アクター0001の名前をライアンに変更
名前の変更 2 \V[1]　　　（アクター0002の名前を変数0001の内容に変更

===========================================================================
呼び出し元アイテム取得
コモンイベントを呼び出したアイテムのIDを変数に入れる
製作者 Alec

使用例
呼び出し元アイテム取得 1　　（変数0001にコモンイベントを呼び出したアイテムIDを入れる

===========================================================================
呼び出し元スキル取得
コモンイベントを呼び出したスキルのIDを変数に入れる
製作者 Alec

使用例
呼び出し元スキル取得 1　　（変数0001にコモンイベントを呼び出したスキルIDを入れる

===========================================================================
レベルの変更
アクターのレベルを変更します。増減ではなく変更後のレベルを指定できます。
製作者 Alec

パラメータ
　アクターのID（もし0なら全員）
変更後のレベル
レベルアップをメッセージで表示するかどうか（表示・非表示）

使用例
レベルの変更 1 50 表示　　（アクター0001のレベルを50に変更
レベルの変更 0 10 非表示　（仲間全員のレベルを10に変更、レベルアップは表示しない

===========================================================================
バイブレーション(English:Vibration)
実行中のAndroid端末を振動させます。
製作者 トリアコンタン

パラメータ
　振動するフレーム数(1/60秒単位)
振動が完了するまでウェイト(ウェイトあり or ウェイトなし)
　デフォルトは「ウェイトなし」

使用例
バイブレーション 60 ウェイトあり
Vibration 120
===========================================================================
指定位置の通行情報取得(English:Get_Location_Pass)
指定した座標のマップ通行情報を取得して、変数に格納します。
製作者 トリアコンタン

以下の法則に従って格納されます。
上方向へ通行可能：千の位が 1、上方向へ通行不可能：千の位が 0
右方向へ通行可能：百の位が 1、右方向へ通行不可能：百の位が 0
下方向へ通行可能：十の位が 1、下方向へ通行不可能：十の位が 0
左方向へ通行可能：一の位が 1、左方向へ通行不可能：一の位が 0

パラメータ
　結果を格納する変数の番号
X座標
Y座標

使用例
指定位置の通行情報取得 1 17 13
Get_Location_Pass 2 \V[1] \V[2]
===========================================================================
変数の初期化(English:Init_Variables)
全ての変数を初期化します。（例外指定可能）
製作者 トリアコンタン

パラメータ
　初期化したくない変数番号（半角スペースで区切って複数指定可能）

使用例
変数の初期化
Init_Variables 1 2 \V[3]
===========================================================================
スイッチの初期化(English:Init_Switches)
全てのスイッチを初期化します。（例外指定可能）
製作者 トリアコンタン

パラメータ
　初期化したくないスイッチ番号（半角スペースで区切って複数指定可能）

使用例
スイッチの初期化
Init_Switches 1 2 \V[3]
===========================================================================
セルフスイッチの初期化(English:Init_Self_Switch)
全てのセルフスイッチを初期化します。
製作者 トリアコンタン

パラメータ
　なし

使用例
セルフスイッチの初期化
Init_Self_Switch
===========================================================================
セルフスイッチの遠隔操作(English:Remote_Control_Self_Switch)
マップID、イベントID、種別（A, B, C, D）を指定してセルフスイッチを操作します。
製作者 トリアコンタン

パラメータ
　マップID
　イベントID
　種別（A, B, C, D）
　設定値（ON or OFF）

使用例
セルフスイッチの遠隔操作 1 3 A ON
Remote_Control_Self_Switch 1 3 D OFF
===========================================================================
ピクチャの読み込み(English:Load_Picture)
指定したファイル名のピクチャを事前に読み込んでキャッシュに保存します。
製作者 トリアコンタン

パラメータ
　ファイル名（拡張子は指定しないでください）

使用例
ピクチャの読み込み filename
Load_Picture filename
===========================================================================
戦闘アニメの読み込み(English:Load_Animation)
指定したファイル名の戦闘アニメを事前に読み込んでキャッシュに保存します。
製作者 トリアコンタン

パラメータ
　ファイル名（拡張子は指定しないでください）
　色相（0-360）

使用例
戦闘アニメの読み込み filename
Load_Animation filename
===========================================================================
シャットダウン(English:Shutdown)
ゲームウィンドウを閉じて強制終了します。
この操作はブラウザ実行、スマホ実行では無効です。
製作者 トリアコンタン

パラメータ
　なし

使用例
シャットダウン
Shutdown
===========================================================================
ウェブサイト起動(English:Startup_Website)
既定のブラウザもしくは起動中のブラウザで、指定されたURLのウェブサイトを起動します。
製作者 トリアコンタン

パラメータ
　表示したいサイトのURL

使用例
ウェブサイト起動 https://www.google.co.jp/
Startup_Website https://www.google.co.jp/
===========================================================================
変数の操作(English:ControlVariable)
指定の変数の値を操作(代入、加算、減算、乗算、除算、剰余)します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
プラグインコマンドで[変数の操作]もしくは[ControlVariable]か[ConVar]を記述して使用します。

パラメータ：
引数1：操作する変数
引数2：操作する内容 [代入：= 加算:+= 減算：-= 乗算：= 除算：/= 剰余：%=]
or
[代入：set 加算:add 減算：sub 乗算：mult 除算：div 剰余：mod]
引数3：操作用の値
引数4：値の型(省略可) [数字優先(省略値)：0 文字優先:1]

使用例：
変数の操作 #0001 += \V[2] //変数1に変数2の値を加算
変数の操作 \V[2] = \V[3] //変数2の値と同番号の変数に変数3の値を代入
変数の操作 1 mod \V[2] //変数1を変数2の値で除算した余りを代入
変数の操作 1 = \In[\V[2]] //変数1に変数2のアイテム番号の名前を代入
変数の操作 #0001 = 10 1 //変数1に'10'(文字)を代入
変数の操作 5 = \Js[$dataMap.note] //変数5に個別マップのメモを代入
ControlVariable 1 += 2 //変数1に2を加算
ConVar 1 mult \V[5] //変数1を変数5の値で乗算

===========================================================================
タッチ座標の取得(English:Get_Touch_Info)
タッチ位置のX座標とY座標を指定された変数に格納します。
画面上の実座標とマップ上のタイル座標の二種類が取得できます。
製作者 トリアコンタン

パラメータ
　X座標が格納される変数の番号（1-5000）
　Y座標が格納される変数の番号（1-5000）
　取得タイプ（画面座標 or マップ座標）※指定しない場合は画面座標

使用例
タッチ座標の取得 1 2
Get_Touch_Info \V[1] \V[2] マップ座標
===========================================================================
マップタッチ禁止の変更(English:Change_Map_Touch)
マップタッチによるプレイヤーの移動禁止を変更します。
製作者 トリアコンタン

パラメータ
　設定値（禁止 or 許可）

使用例
マップタッチ禁止の変更 禁止
Change_Map_Touch 許可
===========================================================================
マップタッチ移動中判定(English:Get_Map_Touch_Moving)
マップタッチによるプレイヤーの移動中かどうかを
指定されたスイッチに格納します。
製作者 トリアコンタン

パラメータ
　結果が格納されるスイッチの番号（1-5000）

使用例
マップタッチ移動中判定 1
Get_Map_Touch_Moving \V[1]
===========================================================================
マップタッチ移動(English:Map_Touch_Move)
マップをタッチしたのと同じ要領で指定位置にプレイヤーを移動します。
障害物やキー入力により移動は中断されます。
製作者 トリアコンタン

パラメータ
　移動先X座標
　移動先Y座標

使用例
マップタッチ移動 17 13
Map_Touch_Move \V[1] \V[2]
===========================================================================
ピクチャの移動(English:Move_Picture)
イベントコマンド「ピクチャの移動」と同じ動作をします。
それぞれのパラメータを制御文字で変数指定できるのが特徴で減算合成も可能です。
製作者 トリアコンタン

パラメータ
　ピクチャ番号（1-100）
　原点（左上 or 中央）
　移動先X座標
　移動先Y座標
　X方向拡大率（マイナス値で画像反転）
　Y方向拡大率（マイナス値で画像反転）
　不透明度（0-255）
　合成方法（通常 or 加算 or 減算）
　移動フレーム数
　移動完了までウェイト（指定する場合「ウェイトあり」）

使用例
ピクチャの移動 1 左上 300 200 200 200 128 減算 240 ウェイトあり
Move_Picture \V[1] 中央 \V[2] \V[3] \V[4] \V[5] \V[6] 減算 \V[7]
===========================================================================
数値入力範囲の設定(English:Set_Input_Num_Range)
イベントコマンド「数値入力の処理」で入力可能な値の最小値と最大値を設定します。
入力可能桁数と併せて考慮されます。
この設定は解除忘れ防止のため、数値入力の処理を終えた時点で初期化されます。

製作者 トリアコンタン

パラメータ
　入力可能最小値（0-99999999）
　入力可能最大値（0-99999999）

使用例
数値入力範囲の設定 0 500
Set_Input_Num_Range \V[1] \V[2]
===========================================================================
数値入力ウィンドウの設定(English:Set_Num_Input_Window)
イベントコマンド「数値入力の処理」で表示されるウィンドウの背景と位置を設定します。
製作者 トリアコンタン

パラメータ
　背景（ウィンドウ or 暗くする or 透明）
　位置（左 or 中 or 右）

使用例
数値入力ウィンドウの設定 ウィンドウ 左
Set_Num_Input_Window 暗くする 中
===========================================================================
数値入力有効桁の設定(English:Set_Num_Input_Valid_Digit)
イベントコマンド「数値入力の処理」で入力可能な有効桁を設定します。
有効桁より小さい桁は変更できなくなります。(1桁目を0で固定したい場合などに使用)
1を指定すると通常通り、全ての桁を入力できます。
この設定は解除忘れ防止のため、数値入力の処理を終えた時点で初期化されます。
製作者 トリアコンタン

パラメータ
　有効桁（1-8）

使用例
数値入力有効桁の設定 2
Set_Num_Input_Valid_Digit \v[1]
===========================================================================
ピクチャの有効判定(English:Get_Picture_Valid)
指定された番号のピクチャが現在、使われているかを判定して結果をスイッチに格納します。
「ピクチャの表示」で使用状態になり、「ピクチャの消去」で非使用状態になります。
製作者 トリアコンタン

パラメータ
　結果が格納されるスイッチの番号（1-5000）
　ピクチャ番号（1-100）

使用例
ピクチャの有効判定 2 1
Get_Picture_Valid \v[1] \v[2]
===========================================================================
ピクチャの表示優先度設定(English:Set_Picture_Priority)
指定した番号のピクチャの表示優先度を設定します。表示優先度の高いピクチャほど
画面の前面に表示されます。この設定はピクチャ番号よりも優先されます。
デフォルト値は100です。
製作者 トリアコンタン

パラメータ
　ピクチャ番号（1-100）
　表示優先度の値（デフォルト100）

使用例
ピクチャの表示優先度設定 1 101
Set_Picture_Priority \v[1] \v[2]
===========================================================================
ピクチャの表示優先度設定(English:Set_Picture_Priority)
指定した番号のピクチャの表示優先度を設定します。表示優先度の高いピクチャほど
画面の前面に表示されます。この設定はピクチャ番号よりも優先されます。
デフォルト値は100です。
製作者 トリアコンタン

パラメータ
　ピクチャ番号（1-100）
　表示優先度の値（デフォルト100）

使用例
ピクチャの表示優先度設定 1 101
Set_Picture_Priority \v[1] \v[2]
===========================================================================
ピクチャのトリミング(English:Trimming_Picture)
指定した矩形（X座標、Y座標、横幅、高さ）でピクチャを切り出します。
製作者 トリアコンタン

パラメータ
　ピクチャ番号（1-100）
　X座標
　Y座標
　横幅
　高さ

使用例
ピクチャのトリミング 1 0 0 320 240
Trimming_Picture \v[1] \v[2] \v[3] \v[4] \v[5]
===========================================================================
ピクチャの回転角設定(English:Angle_Picture)
指定した角度で時計回りにピクチャを回転させます。
「ピクチャの回転」とは異なり回転させた状態のまま保たれます。
製作者 トリアコンタン

パラメータ
　ピクチャ番号（1-100）
　回転角（0-360）

使用例
ピクチャの回転角設定 1 90
Angle_Picture \v[1] \v[2]
===========================================================================
文字の連結(English：ConcatenStrings)
文字を連結し、指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
プラグインコマンドで[文字の連結]もしくは[ConcatenStrings]か[CatStr]を記述して使用します。

パラメータ：
引数1：結果を代入する変数
引数2：連結する文字1
引数3：連結する文字2
引数4：結果が数値として評価できる場合(省略可)
[0:文字として評価(省略値) 1：数値として評価]
使用例
文字の連結 1 /N[1] は天才！ //ハロルドは天才！
文字の連結 #0001 \JS[$dataMapInfos[1].name]\JS は綺麗 //王都は綺麗
ConcatenStrings 1 TEST OK //TESTOK
CatStr 1 2 1 1 21(数値)
===========================================================================
文字の置換(English：ReplaceStrings)
文字を置換し、指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
特殊文字\と置き換えることにより、指定文字の削除も可能です。
プラグインコマンドで[文字の置換]もしくは[ReplaceStrings]か[RepStr]を記述して使用します。

パラメータ：
引数1：結果を代入する変数
引数2：置換対象の文字列
引数3：置換前文字
引数4：置換後文字
引数5：置換方法(省略可) [前方 後方 全て(省略値)]
or
[front back all(省略値)]
使用例
文字列の置換 1 ハロルドかっこいいよハロルド ハ Ｈ 全て //ＨロルドかっこいいよＨロルド
文字列の置換 1 \V[1] ハロルド \ 全て //変数1の文字列からハロルドを取り除く
ReplaceStrings 1 ハロルドとハロルドがお見合い ハ Ｈ Front //Ｈロルドとハロルドがお見合い
RepStr 1 ハロルドとハロルドがお見合い ハロルド Ｔレーゼ Back //ハロルドとＴレーゼがお見合い
===========================================================================
文字の切取(English：CutString)
文字を切り取って指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
プラグインコマンドで[文字の切取]もしくは[CutStrings]か[CutStr]を記述して使用します。

パラメータ：
引数1：結果を代入する変数
引数2：対象の文字列
引数3：開始位置
引数4：終了位置(End か 最後 の指定で最後まで切り取り)
引数5：開始方向(省略可)[前方(省略値) 後方]
or
[front(省略値) back]
使用例
文字の切取 1 \JS[$dataMap.note]\JS 1 10 前方
文字の切取 1 \JS[$dataMap.note]\JS 10 最後 後方
CutStrings 1 \[V] 2 end back
CutStr 1 \[V] 2
===========================================================================
文字一致カウント(English：CountMatchString)
文字列内で特定の文字に一致した数をカウントし指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
プラグインコマンドで[文字一致カウント]もしくは[CountMatchString]か[CntStr]を記述して使用します。

パラメータ：
引数1：結果を代入する変数
引数2：対象の文字列
引数3：検索する文字
引数4：比較方法[0:一致したら一致下部分から先を比較(省略値) 1:1文字ずつ比較]
使用例
文字一致カウント 1 あああああ ああ 0 //2文字一致
文字一致カウント 1 あああああ ああ 1 //4文字一致
CountMatchString 1 \[V] OK
CntStr 1 \N[1] Ｈロルド 0
===========================================================================
文字の検索(English：CountMatchString)
文字列内で特定の文字を検索し、最初に一致した位置を指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
プラグインコマンドで[文字の検索]もしくは[SearchString]か[SchStr]を記述して使用します。

パラメータ：
引数1：結果を代入する変数
引数2：対象の文字列
引数3：検索する文字
引数4：開始方向(省略可)[前方(省略値) 後方]
or
[front(省略値) back]
使用例
文字の探索 1 あああああ ああ 前方
SearchString 1 \[V] test back
SchStr 1 \N[1] Ｈロルド
===========================================================================
文字数カウント(English：CountStringlength)
文字数をカウントし指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
プラグインコマンドで[文字数カウント]もしくは[CountStringlength]か[CntLen]を記述して使用します。

パラメータ：
引数1：結果を代入する変数
引数2：対象の文字列

使用例
文字数カウント 1 \N[1]
CountStringlength 1 hahaha
CntLen 1
===========================================================================
文字の反転(English：ReverseString)
対象の文字列を逆転させ、指定の変数に代入します。
変数の指定について、イベントエディタのコマンドと同じ#0001なども使用できます。
もちろん\[V]や\JS[X]\JSなどの制御文字も使用可能です。
プラグインコマンドで[文字の反転]もしくは[ReverseString]か[RevStr]を記述して使用します。
パラメータ：
引数1：結果を代入する変数
引数2：対象の文字列
使用例
文字の反転 1 \N[1]
ReverseString 1 逆読みできるかな？
RevStr 1 できると思うよ？
===========================================================================
強制セーブ(English：Force_Save)
セーブ画面を介さずに強制的に状態をセーブします。
更新されるセーブファイルは、最後にセーブ or ロードしたファイルになります。
ニューゲームから直接セーブした場合は空きを探しますが、空きがなければ
もっとも古いファイルを上書きします。
パラメータ：
なし
使用例
強制セーブ
Force_Save
===========================================================================
指定位置にアニメーション表示(English：Show_Animation)
画面上の座標を指定してアニメーションを再生します。
パラメータ：
引数1：X座標
引数2：Y座標
引数3：アニメーションID
引数4：ウェイトフラグ（指定する場合「ウェイトあり」）
使用例
指定位置にアニメーション表示 320 240 1 ウェイトあり
Show_Animation \v[1] \v[2] 1
===========================================================================
指定位置にループアニメーション表示(English：Show_Loop_Animation)
画面上の座標を指定してアニメーションを再生します。
消去するか新たなアニメーションを指定するまでループ再生されます。
パラメータ：
引数1：X座標
引数2：Y座標
引数3：アニメーションID
使用例
指定位置にループアニメーション表示 320 240 1
Show_Loop_Animation \v[1] \v[2] 1
===========================================================================
ループアニメーション消去(English：Erase_Loop_Animation)
ループ再生しているアニメーションを消去します。
パラメータ：
なし
使用例
ループアニメーション消去
Erase_Loop_Animation
===========================================================================