追加機能(その他イベントコマンドの組み込み) - yktsr/Text2Frame-MV GitHub Wiki
メッセージだけでなく、指定の記法を用いることでイベントコマンドを組み込むこともできます。 例えば、
<=: 1, 2>
<CommonEvent: 3>
今日も一日がんばるぞい!
とすることで、「今日も一日がんばるぞい!」というメッセージの前に、「変数の操作(変数1に定数2を代入する)」と「コモンイベント(ID3)」のイベントコマンドが組み込まれます。
以下のように全てのイベントコマンドに対応しています。
- メッセージ
- (1) 選択肢の表示
- (2) 数値入力の処理
- (3) アイテム選択の処理
- (4) 文章のスクロール表示
- ゲーム進行
- (5) スイッチの操作
- (6) 変数の操作
- (7) セルフスイッチの操作
- (8) タイマーの操作
- フロー制御
- (9) 条件分岐
- (10) ループ
- (11) ループの中断
- (12) イベント処理の中断
- (13) コモンイベント
- (14) ラベル
- (15) ラベルジャンプ
- (16) 注釈
- パーティ
- (17) 所持金の増減
- (18) アイテムの増減
- (19) 武器の増減
- (20) 防具の増減
- (21) メンバーの入れ替え
- アクター
- (22) HPの増減
- (23) MPの増減
- (24) TPの増減
- (25) ステートの変更
- (26) 全回復
- (27) 経験値の増減
- (28) レベルの増減
- (29) 能力値の増減
- (30) スキルの増減
- (31) 装備の変更
- (32) 名前の変更
- (33) 職業の変更
- (34) 二つ名の変更
- (35) プロフィールの変更
- 移動
- (36) 場所移動
- (37) 乗り物の位置設定
- (38) イベントの位置設定
- (39) マップのスクロール
- (40) 移動ルートの設定
- (41) 乗り物の乗降
- キャラクター
- (42) 透明状態の変更
- (43) 隊列歩行の変更
- (44) 隊列メンバーの集合
- (45) アニメーションの表示
- (46) フキダシアイコンの表示
- (47) イベントの一時消去
- ピクチャ
- (48) ピクチャの表示
- (49) ピクチャの移動
- (50) ピクチャの回転
- (51) ピクチャの色調変更
- (52) ピクチャの消去
- タイミング
- (53) ウェイト
- 画面
- (54) 画面のフェードアウト
- (55) 画面のフェードイン
- (56) 画面の色調変更
- (57) 画面のフラッシュ
- (58) 画面のシェイク
- (59) 天候の設定
- オーディオ・ビデオ
- (60) BGMの演奏
- (61) BGMのフェードアウト
- (62) BGMの保存
- (63) BGMの再開
- (64) BGSの演奏
- (65) BGSのフェードアウト
- (66) MEの演奏
- (67) SEの演奏
- (68) SEの停止
- (69) ムービーの再生
- シーン制御
- (70) 戦闘の処理
- (71) ショップの処理
- (72) 名前入力の処理
- (73) メニュー画面を開く
- (74) セーブ画面を開く
- (75) ゲームオーバー
- (76) タイトル画面に戻す
- システム設定
- (77) 戦闘BGMの変更
- (78) 勝利MEの変更
- (79) 敗北MEの変更
- (80) 乗り物BGMの変更
- (81) セーブ禁止の変更
- (82) メニュー禁止の変更
- (83) エンカウント禁止の変更
- (84) 並び変え禁止の変更
- (85) ウィンドウカラーの変更
- (86) アクターの画像変更
- (87) 乗り物の画像変更
- マップ
- (88) マップ名表示の変更
- (89) タイルセットの変更
- (90) 戦闘背景の変更
- (91) 遠景の変更
- (92) 指定位置の情報取得
- バトル
- (93) 敵キャラのHP増減
- (94) 敵キャラのMP増減
- (95) 敵キャラのTP増減
- (96) 敵キャラのステート変更
- (97) 敵キャラの全回復
- (98) 敵キャラの出現
- (99) 敵キャラの変身
- (100) 戦闘アニメーションの表示
- (101) 戦闘行動の強制
- (102) バトルの中断
- 上級
- (103) スクリプト
- (104)-1 プラグインコマンド(ツクールMV)
- (104)-2 プラグインコマンド(ツクールMZ, 上級者向け)
「選択肢の表示」は以下の記法で組み込むことができます。
<ShowChoices: 背景, ウィンドウ位置, デフォルト, キャンセル>
<When: 選択肢1の文>
選択肢1を選んだ時の処理
<When: 選択肢2の文>
選択肢2を選んだ時の処理
.
.
.
<When: 選択肢6の文>
選択肢6を選んだ時の処理
<WhenCancel>
選択肢をキャンセルした時の処理
<End>
必須の引数はありません。
全ての引数はオプションとして設定でき、指定しない場合はデフォルト値が設定されます。
引数を設定しない場合、<ShowChoices>
でも<ShowChoices: >
でも記述できます。
<When>
が上から順に選択肢1, 選択肢2と対応しています。
ShowChoices
は選択肢の表示
かSHC
で代替できます。また、When
は選択肢
で、End
は分岐終了
で、WhenCancel
はキャンセルのとき
で代替できます。
引数(オプション)の指定方法を述べる前に、いくつか具体例を示します。
- 例1: 以下の設定で、選択肢を2つ表示する場合
- 背景: ウィンドウ
- ウィンドウ位置: 右
- デフォルト: 選択肢 #1
- キャンセル: 選択肢 #2
長老に会って挨拶は済ませてきたかい?
<ShowChoices: Window, Right, 1, 2>
<When: はい>
そうか。それならよかった。
早速長老の依頼のとおり、北に向かってくれないかい。
<When: いいえ>
それはいけない。
長老は君のような若者を探しているんだ。
挨拶に行って話を聞いてくれないかい。
<End>
また、例1の引数は全てデフォルト値なので、以下のようにも記述できます。2行目だけ異なります。
長老に会って挨拶は済ませてきたかい?
<ShowChoices>
<When: はい>
そうか。それならよかった。
早速長老の依頼のとおり、北に向かってくれないかい。
<When: いいえ>
それはいけない。
長老は君のような若者を探しているんだ。
挨拶に行って話を聞いてくれないかい。
<End>
- 例2: 以下の設定で、選択肢を3つ表示する場合
- 背景: 透明
- ウィンドウ位置: 中
- デフォルト: 選択肢 #1
- キャンセル: 分岐
他にも話したいことがあるんだ。
何が聞きたい?
<ShowChoices: Transparent, Middle, 1, Branch>
<When: 勇者ノーゼンの伝説>
勇者ノーゼンは〜〜(省略
<When: 魔王に挑む冒険者の現状>
魔王に挑む冒険者は〜〜(省略
<When: 魔王について判明している点>
魔王について判明している点は〜〜(省略
<WhenCancel>
・・・え、僕の話、長すぎた?ごめんごめん。
<End>
それぞれの引数に設定できる項目は以下の通りです。ツクールの選択肢に対応しています。
- 背景は以下のリストから指定します。
- ウィンドウ:
Window
orウィンドウ
- 暗くする:
Dim
or暗くする
- 透明:
Transparent
or透明
- ウィンドウ:
- ウィンドウ位置は以下のリストから指定します。
- 左:
Left
or左
- 中:
Middle
or中
- 右:
Right
or右
- 左:
- デフォルトは以下のリストから指定します。
- なし:
None
orなし
- 選択肢 #1:
1
- 選択肢 #2:
2
- ...
- 選択肢 #6:
6
- なし:
- キャンセルは以下のリストから指定します。
- 分岐:
Branch
or分岐
- 禁止:
Disallow
or禁止
- 選択肢 #1:
1
- 選択肢 #2:
2
- ...
- 選択肢 #6:
6
- 分岐:
「数値入力の処理」は以下のいずれかの記法で組み込むことができます。
<InputNumber: 変数番号, 桁数>
<INN: 変数番号, 桁数>
<数値入力の処理: 変数番号, 桁数>
例えば、以下の通りです。
- 例: 変数1に桁数2で数値入力する。
<InputNumber: 1, 2>
<INN: 1, 2>
<数値入力の処理: 1, 2>
「アイテム選択の処理」は以下のいずれかの記法で組み込むことができます。
<SelectItem: 変数番号, アイテムタイプ>
<SI: 変数番号, アイテムタイプ>
<アイテム選択の処理: 変数番号, アイテムタイプ>
アイテムタイプを指定するための項目は以下の通りです。
- 通常アイテム:
Regular Item
,通常アイテム
- 大事なもの:
Key Item
,大事なもの
- 隠しアイテムA:
Hidden Item A
,隠しアイテムA
- 隠しアイテムB:
Hidden Item B
,隠しアイテムB
なお、アイテムタイプの大文字小文字は問いません。例えば、Regular Item
はregular item
と指定しても、REGULAR ITEM
と指定しても大丈夫です。
アイテム選択の処理の具体例は、以下の通りです。
- 例1: 通常アイテムの一覧を表示し、選択されたアイテムのIDを変数1に代入する。
<SelectItem: 1, Regular Item>
<SI: 1, REGULAR ITEM>
<アイテム選択の処理: 1, 通常アイテム>
- 例2: 隠しアイテムAの一覧を表示し、選択されたアイテムのIDを変数20に代入する。
<SelectItem: 20, Hidden Item A>
<SI: 20, hidden item A>
<アイテム選択の処理: 20, 隠しアイテムA>
「文章のスクロール表示」は、以下のように二つのタグで挟み込む記法で指定します。
<ShowScrollingText: 速度(整数), 早送りなしフラグ(`ON` or `OFF`)>
スクロールさせたい文章
</ShowScrollingText>
ShowScrollingText
は、SST
か、文章のスクロール表示
としても記述できます。
速度が2
で早送りを許可する場合(早送りなしフラグがOFF
)の具体例は以下のとおりです。
<ShowScrollingText: 2, OFF>
世界は魔王によって滅ぼされた。
しかし、勇者は立ち上がった。
</ShowScrollingText>
速度と早送りなしフラグは、省略することが可能です。
省略した場合、速度は2
が、早送りなしフラグはOFF
が設定されます。
また、両方を省略したときに限り:
も省略可能です。
例えば、以下のように記述できます。
<ShowScrollingText>
世界は魔王によって滅ぼされた。
しかし、勇者は立ち上がった。
</ShowScrollingText>
早送りなしフラグだけを省略し(早送りを許可する)、速度を5
に設定する場合は以下のようになります。
<ShowScrollingText: 5>
世界は魔王によって滅ぼされた。
しかし、勇者は立ち上がった。
</ShowScrollingText>
以下の対応関係で早送りなしフラグのON
とOFF
は代替できます。
-
ON
:オン
,true
,1
,No Fast Forward
-
OFF
:オフ
,false
,0
あまりないかもしれませんが、
<ShowScrollingText>世界は魔王によって滅ぼされた。</ShowScrollingText>
というように1行で記述することもできます。
「スイッチの操作」は以下の記法で組み込むことができます。
<Switch: スイッチ番号, 代入値("ON" or "OFF")>
Switch
はSW
, スイッチ
でも代替できます。
例えば、以下の通りです。
- 例1: 番号1のスイッチをONにする。
<Switch: 1, ON>
<SW: 1, ON>
<スイッチ: 1, ON>
- 例2: 番号1-10のスイッチをすべてOFFにする。
<Switch: 1-10, OFF>
<SW: 1-10, OFF>
<スイッチ: 1-10, OFF>
スイッチ番号は単一か範囲で指定します。範囲の場合は1-10
のようにハイフンで始端と終端をつなげます。
代入値は基本的にON
かOFF
で指定します。
ON
はオン
, true
, 1
として、
OFF
はオフ
, false
, 0
でも代替できます。
「変数の操作」は、代入・加算・減算・乗算・除算・除算・余剰をそれぞれ以下の記法で組み込みます。
- 代入
<Set: 変数番号, オペランド>
<=: 変数番号, オペランド>
<代入: 変数番号, オペランド>
- 加算(足し算)
<Add: 変数番号, オペランド>
<+: 変数番号, オペランド>
<加算: 変数番号, オペランド>
- 減算(引き算)
<Sub: 変数番号, オペランド>
<-: 変数番号, オペランド>
<減算: 変数番号, オペランド>
- 乗算(掛け算)
<Mul: 変数番号, オペランド>
<*: 変数番号, オペランド>
<乗算: 変数番号, オペランド>
- 除算(割り算)
<Div: 変数番号, オペランド>
</: 変数番号, オペランド>
<除算: 変数番号, オペランド>
- 剰余(割り算のあまり)
<Mod: 変数番号, オペランド>
<%: 変数番号, オペランド>
<剰余: 変数番号, オペランド>
変数番号は単一か範囲で指定します。範囲の場合は1-10
のようにハイフンで始端と終端をつなげます。
オペランドでは演算対象の値を定数・変数・乱数・ゲームデータ・スクリプトで指定します。
指定方法の詳細を述べる前に、以下にいくつか具体例を記します。
-
例1: 変数1に定数2を代入する。
<Set: 1, 2>
<=: 1, 2>
<代入: 1, 2>
-
例2: 1から10の変数すべてに変数2の値を加算する。
<Add: 1-10, variables[2]>
<+: 1-10, V[2]>
<加算: 1-10, 変数[2]>
-
例3: 変数1に50から100の乱数を減算する。
<Sub: 1, random[50][100]>
<-: 1, r[50][100]>
<減算: 1, 乱数[50][100]>
-
例4: 1から10の変数すべてにゲームデータのアクター2のレベルを乗算する。
<Mul: 1-10, GameData[actor][2][level]>
<*: 1-10, gd[actor][2][level]>
<乗算: 1-10, ゲームデータ[アクター][2][レベル]>
-
例5: 変数1にゲームデータのパーティ人数を除算する。
<Div: 1, GameData[PartyMembers]>
</: 1, gd[PartyMembers]>
<除算: 1, ゲームデータ[パーティ人数]>
-
例6: 変数1にスクリプト"$gameVariables.value(1)"の値との剰余を代入する。
<Mod: 1, Script[$gameVariables.value(1)]>
<%: 1, sc[$gameVariables.value(1)]>
<剰余: 1, スクリプト[$gameVariables.value(1)]>
1
,2
のように数値をそのままお書きください。
Variables[変数番号]
で指定します。Variables
はV
か変数
で代替できます。例えば、変数2の場合はVariables[2]
とお書きください。
Random[最小値][最大値]
で指定します。RandomはR
か乱数
で代替できます。例えば、最小値50, 最大値50の乱数の場合はRandom[50][100]
とお書きください。
Script[スクリプト本文(Javascript)]
で指定します。ScriptはSC
かスクリプト
で代替できます。例えば、$gameVariables.value(1)の場合は、Script[$gameVariables.value(1)]
とお書きください。
GameData[引数1][引数2][引数3]
で指定します。GameDataはgd
かゲームデータ
で代替できます。
引数1,2,3で使用するゲームデータの値を指定します。 引数1にはアイテム・武器・防具・アクター・敵キャラ・キャラクター・パーティ・直前・その他のいずれかを指定します。どれを指定するかで引数2,3の扱いも変わるので、ケースにわけて説明します。
-
アイテム:
GameData[Item][アイテムID]
例: IDが5のアイテムの所持数を変数1に代入する。:
<Set: 1, GameData[Item][5]>
引数1の
Item
はアイテム
でも代替できます。引数3は使用しません。 -
武器:
GameData[Weapon][武器ID]
例: IDが5の武器の所持数を変数1に代入する。:
<Set: 1, GameData[Weapon][5]>
引数1の
Weapon
は武器
でも代替できます。引数3は使用しません。 -
防具:
GameData[Armor][防具ID]
例: IDが5の防具の所持数を変数1に代入する。:
<Set: 1, GameData[Armor][5]>
引数1の
Armor
は防具
でも代替できます。引数3は使用しません。 -
アクター:
GameData[Actor][アクターID][パラメータ名]
例: IDが4のアクターのレベルを変数1に代入する。:
<Set: 1, GameData[actor][4][Level]>
引数3のパラメータ名は以下のリストからご指定ください。
- レベル:
Level
,レベル
- 経験値:
Exp
,経験値
- HP:
HP
- MP:
MP
- 最大HP:
MaxHp
,最大HP
- 最大MP:
MaxMP
,最大MP
- 攻撃力:
Attack
,攻撃力
- 防御力:
Defense
,防御力
- 魔法攻撃力:
M.Attack
,魔法攻撃力
- 魔法防御力:
M.Defense
,魔法防御力
- 敏捷性:
Agility
,敏捷性
- 運:
Luck
,運
- TP:
TP
- レベル:
-
敵キャラ:
GameData[Enemy][(戦闘中の)敵キャラID][パラメータ名]
例: 戦闘中の2番目の敵キャラのHPを変数1に代入する。
<Set: 1, GameData[Enemy][2][HP]>
パラメータ名は、上述したゲームデータのアクターのパラメータ名のリストを参照してください。ただし、レベルと経験値は設定出来ません。
-
キャラクター:
GameData[Character][イベントの指定][参照値]
- 例1: プレイヤーのマップX座標を変数1に代入する。:
<Set: 1, GameData[Character][Player][MapX]>
- 例2: このイベントの方向を変数1に代入する。:
<Set: 1, GameData[Character][ThisEvent][Direction]>
- 例3: ID2のイベントの画面Y座標を変数1に代入する。
<Set: 1, GameData[Character][2][ScreenY]>
引数のイベントの指定は以下のリストからご指定ください。
- プレイヤー:
Player
,プレイヤー
,-1
- このイベント:
ThisEvent
,このイベント
,0
- イベントID指定:
1
,2
, ...
引数3の参照値は以下のリストからご指定ください。
- マップX座標:
MapX
,マップX
- マップY座標:
MapY
,マップY
- 方向:
Direction
,方向
- 画面X座標:
ScreenX
,画面X
- 画面Y座標:
ScreenY
,画面Y
引数1の
Character
はキャラクター
でも代替できます。 - 例1: プレイヤーのマップX座標を変数1に代入する。:
-
パーティ:
GameData[party][並び順]
例: パーティの先頭のアクターIDを変数1に代入する。
<Set: 1, gamedata[party][1]>
<Set: 1, gamedata[パーティ][1]>
並び順は整数で指定します。 引数1の
party
はパーティ
でも代替できます。 -
直前:
GameData[Last][項目]
例: 直前に使用したスキルのIDを変数1に代入する。
<Set: 1, gamedata[Last][Last Used Skill ID]>
<Set: 1, gamedata[直前][直前に使用したスキルのID]>
<Set: 1, gamedata[Last][Used Skill ID]>
項目は以下のリストからご指定ください。
- 直前に使用したスキルのID:
Last Used Skill ID
,直前に使用したスキルのID
,Used Skill ID
- 直前に使用したアイテムのID:
Last Used Item ID
,直前に使用したアイテムのID
,Used Item ID
- 直前に行動したアクターのID:
Last Actor ID to Act
,直前に行動したアクターのID
,Actor ID to Act
- 直前に行動した敵キャラのインデックス:
Last Enemy Index to Act
,直前に行動した敵キャラのインデックス
,Enemy Index to Act
- 直前に対象となったアクターのID:
Last Target Actor ID
,直前に対象となったアクターのID
,Target Actor ID
- 直前に対象となった敵キャラのインデックス:
Last Target Enemy Index
,直前に対象となった敵キャラのインデックス
,Target Enemy Index
引数1の
Last
は直前
でも代替できます。 -
その他
その他では、引数1のみを使用します。以下のリストから指定してください。
- パーティ人数:
PartyMembers
,パーティ人数
- 所持金:
gold
,所持金
, - 歩数:
steps
,歩数
- プレイ時間:
PlayTime
,プレイ時間
- タイマー:
timer
,タイマー
- セーブ回数:
SaveCount
,セーブ回数
- 戦闘回数:
BattleCount
,戦闘回数
- 勝利回数:
WinCount
,勝利回数
- 逃走回数:
EscapeCount
,逃走回数
例: パーティ人数を変数1に代入する。
<Set: 1, gamedata[PartyMembers]>
<Set: 1, gamedata[パーティ人数]>
- パーティ人数:
「セルフスイッチの操作」は以下のいずれかの記法で組み込むことができます。
<SelfSwitch: セルフスイッチ記号, 代入値("ON" or "OFF")>
<SSW: セルフスイッチ記号, 代入値("ON" or "OFF")>
<セルフスイッチ: セルフスイッチ記号, 代入値("ON" or "OFF")>
例えば、以下の通りです。
- 例1: セルフスイッチAをONにする。
<SelfSwitch: A, ON>
<SSW: A, true>
<セルフスイッチ: A, オフ>
- 例2: セルフスイッチBをOFFにする。
<SelfSwitch: B, OFF>
<SSW: B, false>
<セルフスイッチ: B, オフ>
代入値は基本的にON
かOFF
で指定します。
ON
はオン
, true
, 1
として、
OFF
はオフ
, false
, 0
でも代替できます。
「タイマーの操作」は以下のいずれか記法で組み込みます。
<Timer: 操作, 分, 秒>
<タイマー: 操作, 分, 秒>
操作ではスタートするかストップするかを以下の記法で指定する。
- スタート:
Start
,始動
,スタート
- ストップ:
Stop
,停止
,ストップ
スタートの場合は分と秒を数値で指定してください。ストップでは分と秒は指定しないでください。
例えば、以下の通りです。
- 例1: 1分10秒のタイマーをスタートする
<Timer: Start, 1, 10>
<タイマー: 始動, 1, 10>
<タイマー: スタート, 1, 10>
- 例2: タイマーをストップする
<Timer: Stop>
<タイマー: 停止>
<タイマー: ストップ>
「条件分岐」は、以下の記法で組み込みます。
<If: 条件の対象, 引数1, 引数2, 引数3>
条件を満たしている時の処理
<Else>
条件を満たしていない時の処理
<End>
詳細を述べる前に、いくつか具体例を記します。 いずれの例も、条件が満たされているときは「私もずっと前から好きでした。」というメッセージを、条件を満たさないときは「ごめんなさい。お友達でいましょう。」とメッセージを表示します。
- 例1: スイッチ1がONのとき
<If: Switches[1], ON>
私もずっと前から好きでした。
<Else>
ごめんなさい。お友達でいましょう。
<End>
- 例2: 変数1が定数2と等しいとき
<If: Variables[1], ==, 2>
私もずっと前から好きでした。
<Else>
ごめんなさい。お友達でいましょう。
<End>
- 例3: ID1のアクターがパーティにいるとき
<If: Actors[1], in the party>
私もずっと前から好きでした。
<Else>
ごめんなさい。お友達でいましょう。
<End>
条件の対象毎に引数の記法が異なり、引数2,引数3を使わないものもあります。
以降、条件の対象毎に記法を説明します。
スイッチを条件に使うときは、以下のように条件を書きます。
<If: Switches[スイッチID], 値("ON" or "OFF")>
Switches
はSW
やスイッチ
で代替できます。
また、代入値は基本的にON
かOFF
で指定しますが、以下のような代替記号でも指定できます。
-
ON
:オン
,true
,1
-
OFF
:オフ
,false
,0
例えば、以下の通りです。
- 例1 スイッチ1が
ON
のとき<If: Switches[1], ON>
<If: SW[1], true>
<If: スイッチ[1], オン>
- 例2: スイッチ1が
OFF
のとき<If: Switches[1], OFF>
<If: SW[1], false>
<If: スイッチ[1], オフ>
変数を条件に使うときは、以下のように条件を書きます。
<If: Variables[変数ID], 条件式(記号), オペランド(定数 or 変数)>
Variables
はV
や変数
でも代替できます。
条件式に使える記号は以下の通りです。
- 等しい:
==
,=
(全角のイコールです) - 以上:
>=
,≧
- 以下:
<=
,≦
- 大きい:
>
,>
- 小さい:
<
,<
- 等しくない:
!=
,≠
オペランドの指定方法は以下の通りです。
- 定数:
1
,2
など数値をそのまま記入 - 変数:
Variables[変数ID]
,V[変数ID]
,変数[変数ID]
例えば、以下の通りです。
- 例1: 変数1が定数2と等しいとき
<If: Variables[1], ==, 2>
<If: V[1], ==, 2>
<If: 変数[1], =, 2>
- 例2: 変数1が変数2の値以上のとき
<If: Variables[1], >=, Variables[2]>
<If: V[1], >=, V[2]>
<If: 変数[1], >=, 変数[2]>
セルフスイッチを条件に使うときは、以下のように条件を書きます。
<If: SelfSwitches[セルフスイッチ記号("A", "B", "C", or "D")], 代入値("ON" or "OFF")>
SelfSwitches
はSSW
やセルフスイッチ
でも代替できます。
また、代入値は基本的にON
かOFF
で指定しますが、以下のような代替記号でも指定できます。
-
ON
:オン
,true
,1
-
OFF
:オフ
,false
,0
例えば、以下の通りです。
- 例1: セルフスイッチAがONのとき
<If: SelfSwitches[A], ON>
<If: SSW[A], true>
<If: セルフスイッチ[A], オフ>
- 例2: セルフスイッチBがOFFのとき
<If: SelfSwitches[B], OFF>
<If: SSW[B], false>
<If: セルフスイッチ[B], オフ>
タイマーを条件に使うときは、以下のように条件を書きます。
<If: Timer, 条件式(">=" or "<="), 分, 秒>
Timer
はタイマー
でも代替できます。
また、条件式>=
は≧
で、<=
は≦
で代替できます。
例えば、以下の通りです。
- 例1: タイマーが1分10秒以上のとき
<If: Timer, >=, 1, 10>
<If: タイマー, ≧, 1, 10>
- 例2: タイマーが1分10秒以下のとき
<If: Timer, <=, 1, 10>
<If: タイマー, ≦, 1, 10>
アクターに関する情報を条件に使うときは、以下のように書きます。
<If: Actors[アクターID], 条件1, 条件2>
Actors
はアクター
でも代替できます。
条件1で対象を指定します。
- パーティにいる
- 名前
- 職業
- スキル
- 武器
- 防具
- ステート を指定できます。
条件2は条件1で指定した対象によって使い方が異なります。 以下に、条件1での対象毎に説明します。
アクターがパーティにいるかどうかを判定するときは以下のように指定します。
<If: Actors[アクターID], in the party>
in the party
はパーティにいる
という文字列でも代替できます。
条件2は使用しません。
例えば、ID1のアクターがパーティにいるかどうかを条件に使うときは以下のように書きます。
<If: Actors[1], in the party>
<If: アクター[1], パーティにいる>
アクターの名前を条件式に使うときは以下のように指定します。
<If: Actors[アクターID], Name, 名前(自由記述)>
Name
は名前
でも代替できます。
例えば、ID1のアクターの名前がハロルド
かどうかは以下のように書きます。
<If: Actors[アクターID], Name, ハロルド>
<If: アクター[アクターID], 名前, ハロルド>
職業、スキル、武器、防具、ステートは以下のように指定します。
<If: Actors[アクターID], テーブル名, テーブルID(1,2,...などの整数)>
テーブル名では、アクターに紐付いた情報のテーブル名を指定します。 指定方法は以下のとおりです。
- 職業:
Class
,職業
- スキル:
Skill
,スキル
- 武器:
Weapon
,武器
- 防具:
Armor
,防具
- ステート:
State
,ステート
例えば、以下の通りです。
- 例1: ID1のアクターの職業が、ID2の職業のとき
<If: Actors[1], Class, 2>
<If: アクター[1], 職業, 2>
- 例2: ID1のアクターがID2のスキルを習得しているとき
<If: Actors[1], Skill, 2>
<If: アクター[1], スキル, 2>
- 例3: ID1のアクターがID2の武器を装備しているとき
<If: Actors[1], Weapon, 2>
<If: アクター[1], 武器, 2>
- 例4: ID1のアクターがID2の防具を装備しているとき
<If: Actors[1], Armor, 2>
<If: アクター[1], 防具, 2>
- 例5: ID1のアクターがID2のステートを付与されているとき
<If: Actors[1], State, 2>
<If: アクター[1], ステート, 2>
敵キャラに関する情報を条件に使うときは、以下のように書きます。
<If: Enemies[戦闘中の敵キャラの番号], 条件1, 条件2>
Enemies
は敵キャラ
, エネミー
でも代替できます。
条件1は以下いずれかで設定します。
- 出現している:
Appeared
or出現している
- ステート:
State
orステート
また、ステートを指定した場合は、条件2でステートのIDを指定します。
例えば以下の通りです。
- 例1: 1体目の敵キャラが出現しているとき
<If: Enemies[1], Appeared>
<If: 敵キャラ[1], 出現している>
<If: エネミー[1], 出現している>
- 例2: 1体目の敵キャラがID2のステートにかかっているとき
<If: Enemies[1], State, 2>
<If: 敵キャラ[1], ステート, 2>
<If: エネミー[1], ステート, 2>
キャラクターの向きを条件に使うときは、以下のように書きます。
<If: Characters[イベントの指定], 向き(下, 左, 右, 上)>
Characters
はキャラクター
でも代替できます。
引数のイベントの指定は以下のリストからご指定ください。
- プレイヤー:
Player
,プレイヤー
,-1
- このイベント:
ThisEvent
,このイベント
,0
- イベントID指定:
1
,2
, ...
向きは以下のリストからご指定ください。
- 下:
Down
,下
,2
- 左:
Left
,左
,4
- 右:
Right
,右
,6
- 上:
Up
,上
,8
例えば、以下の通りです。
- 例1: プレイヤーが下向きの時
<If: Characters[Player], Down>
<If: キャラクター[プレイヤー], 下>
<If: Characters[-1], 2>
- 例2: このイベントが左向きのとき
<If: Characters[ThisEvent], Left>
<If: キャラクター[このイベント], 左>
<If: Characters[0], 4>
- 例3: ID1のイベントが右向きのとき
<If: Characters[1], Right>
<If: キャラクター[1], 右>
<If: Characters[1], 6>
乗り物に乗っていることを条件に使うときは、以下のように書きます。
<If: Vehicle, 乗り物の種類(小型船、大型船、飛行船)>
Vehicle
は乗り物
でも代替できます。
乗り物の種類は以下のリストからご指定ください。
- 小型船:
Boat
,小型船
- 大型船:
Ship
,大型船
- 飛行船:
Airship
,飛行船
例えば以下の通りです。
- 例1: 小型船に乗っている時
<If: Vehicle, Boat>
<If: 乗り物, 小型船>
- 例2: 大型船に乗っている時
<If: Vehicle, Ship>
<If: 乗り物, 大型船>
- 例3: 飛行船に乗っている時
<If: Vehicle, Airsip>
<If: 乗り物, 飛行船>
お金を条件に使うときは、いかのようにかきます
<If: Gold, 条件式(≧, ≦, <), 数値(定数)
Gold
はお金
でも代替出来ます。
条件式に使える記号は以下の通りです。
- 以上:
>=
,≧
- 以下:
<=
,≦
- 小さい:
<
,<
例えば以下の通りです。
- 例1: お金を500以上所持しているとき
<If: Gold, >=, 500>
<If: お金, ≧, 500>
- 例2: 500以下しかお金を所持していないとき
<If: Gold, <=, 500>
<If: お金, ≦, 500>
- 例2: 500未満しかお金を所持していないとき
<If: Gold, <, 500>
<If: お金, <, 500>
アイテムを条件に使うときは以下のように書きます。
<If: Items[ID]>
Items
はアイテム
でも代替できます。
例えば、以下の通りです。
- 例1: IDが1のアイテムを所持しているとき
<If: Items[1]>
<If: アイテム[1]>
武器を条件に使うときは以下のように書きます。
<If: Weapons[ID], 装備品を含むか>
Weapons
は武器
でも代替できます。
装備品を含む場合は、2つ目の引数の部分にInclude Equipment
もしくは装備品を含む
と記載してください。
含まない場合は、省略してください。
例えば、以下の通りです。
- 例1: IDが1の武器を所持しているとき(装備品は含まない)
<If: Weapons[1]>
<If: 武器[1]>
- 例2: IDが1の武器を所持しているとき(装備品は含む)
<If: Weapons[1], Include Equipment>
<If: 武器[1], 装備品を含む>
防具を条件に使うときは以下のように書きます。
<If: Armors[ID], 装備品を含むか>
Armors
は防具
でも代替できます。
装備品を含む場合は、2つ目の引数の部分にInclude Equipment
もしくは装備品を含む
と記載してください。
含まない場合は、省略してください。
例えば、以下の通りです。
- 例1: IDが1の防具を所持しているとき(装備品は含まない)
<If: Armors[1]>
<If: 防具[1]>
- 例2: IDが1の防具を所持しているとき(装備品は含む)
<If: Armors[1], Include Equipment>
<If: 防具[1], 装備品を含む>
ボタンを条件に使うときは以下のように書きます。
<If: Button, ボタンの種類, 押され方(省略可能)>
Button
はボタン
でも代替できます。
以下のリストからボタンの種類を指定してください。
- 決定:
OK
,決定
- キャンセル:
Cancel
,キャンセル
- シフト:
Shift
,シフト
- 下:
Down
,下
- 左:
Left
,左
- 右:
Right
,右
- 上:
Up
,上
- ページアップ:
Pageup
,ページアップ
- ページダウン:
Pagedown
,ページダウン
押され方は以下のリストから指定してください。
- が押されている:
is being pressed
,が押されている
,pressed
- がトリガーされている:
is being triggered
,がトリガーされている
,triggered
- がリピートされている:
is being repeated
,がリピートされている
,repeated
押され方は省略が可能です。その場合はis being pressed
が設定されます。
例えば以下の通りです。
- 例1: 決定ボタンが押されているとき
<If: Button, OK, is being pressed>
<If: ボタン, 決定, が押されている>
<If: ボタン, 決定, pressed>
<If: Button, OK>
- 例2: シフトボタンがトリガーされているとき
<If: Button, Shift, is being triggered>
<If: ボタン, シフト, がトリガーされている>
<If: Button, Shift, triggered>
- 例3: 下ボタンがリピートされているとき
<If: Button, Down, is being repeated>
<If: ボタン, 下, がリピートされている>
<If: Button, Down, repeated>
スクリプトを条件に使うときは以下のように書きます。
<If: Script, スクリプト本文(Javascript)>
Script
はスクリプト
かSC
でも代替できます。
例えば、$gameParty._gold < $gameVariables.value(1)
を条件にするときは以下のように書けます。
<If: Script, $gameParty._gold == $gameVariables.value(1)>
<If: スクリプト, $gameParty._gold == $gameVariables.value(1)>
<If: SC, $gameParty._gold == $gameVariables.value(1)>
- 別記法として、以下の対応関係で日本語表記もできます。
- If:
条件分岐
- Else:
それ以外のとき
- End:
分岐修了
- If:
- とその処理は省略することができます。
- 入れ子にすることができます。例えば以下のようにすることもできます。
<If: Switches[1], ON>
<If: Switches[2], ON>
1つ目と2つ目の条件が満たされているときの処理
<End>
<Else>
1つ目の条件が満たされていないときの処理
<End>
- 条件分岐の中は「変数の操作」や「コモンイベント」など、その他のイベントコマンドも組み込むことができます。
<If: Switches[1], ON>
<Set: 1, 2>
<CommonEvent: 3>
私もずっと前から好きでした。
<Else>
<Set: 3, 4>
<CommonEvent: 4>
ごめんなさい。お友達でいましょう。
<End>
-
<End>
を書かなかった場合は、以降のメッセージやタグが全てIfもしくはElseの処理として組み込まれます。 - タグ(If, Else, END)の直後は可能な限り改行してください。改行せずに次のイベントやメッセージを入力した場合の動作は保証されていません。
「ループ」は以下の記法で組み込みます。
<Loop>
ループしたい処理
<RepeatAbove>
Loop
はループ
、
RepeatAbove
は以上繰り返し
やRA
で代替できます。
ループしたい処理は、メッセージの表示や他のタグを自由に組み込めます。
以下の具体例は、今日も一日がんばるぞい!
というメッセージが無限ループします。
<Loop>
今日も一日がんばるぞい!
<RepeatAbove>
以下の例では、他のタグと組み合わせることで、今日も一日がんばるぞい!
を5回表示させる処理になります。
<Set: 1, 0>
<Loop>
<If: Variables[1], ==, 5>
<BreakLoop>
<End>
今日も一日がんばるぞい!
<Add: 1, 1>
<RepeatAbove>
Set
とAdd
は「変数の操作」を、If
とEnd
は「条件分岐」を、BreakLoop
はループの中断の説明をご覧ください。
「ループの中断」は以下のいずれかの記法で組み込みます。
<BreakLoop>
<ループの中断>
<BL>
「イベント処理の中断」は以下のいずれかの記法で組み込みます。
<ExitEventProcessing>
<イベント処理の中断>
<EEP>
「コモンイベント」は以下のいずれかの記法で組み込みます。
<CommonEvent: コモンイベントID>
<CE: コモンイベントID>
<コモンイベント: コモンイベントID>
例えば以下のように記述すると、ID2のコモンイベントが組み込まれます。
<CommonEvent: 2>
<CE: 2>
<コモンイベント: 2>
「ラベル」は以下のいずれかの記法で指定します。
<Label: ラベル名>
<ラベル: ラベル名>
例えば以下のように記述するとStart
というラベルが組み込まれます。
<Label: Start>
<ラベル: Start>
「ラベルジャンプ」は以下のいずれかの記法で指定します。
<JumpToLabel: ジャンプ先のラベル名>
<ラベルジャンプ: ジャンプ先のラベル名>
<JTL: ジャンプ先のラベル名>
例えば以下のように記述するとStart
と名付けられたラベルへのラベルジャンプが組み込まれます。
<JumpToLabel: Start>
<ラベルジャンプ: Start>
<JumpToLabel: Start>
注釈のイベントコマンドは、以下のように<comment>
と</comment>
で挟み込む記法で指定します。
<comment>
注釈の内容
</comment>
例えば以下のとおりです。
<comment>
この辺からいい感じのBGMを再生する。
選曲しないと・・・。
</comment>
別記法として<CO>
か、<注釈>
としても記述できます。また、
<comment>この辺からいい感じのBGMを再生する。</comment>
というように1行で記述することもできます。
「所持金の増減」は以下のいずれかの記法で組み込むことができます。
<ChangeGold: 操作, オペランド>
<所持金の増減: 操作, オペランド>
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: 所持金を1増やす
<ChangeGold: Increase, 1>
<ChangeGold: +, 1>
<所持金の増減: 増やす, 1>
例2: 所持金を変数5の値分減らす
<ChangeGold: Decrease, Variables[5]>
<ChangeGold: -, V[5]>
<所持金の増減: 減らす, 変数[5]>
「アイテムの増減」は以下のいずれかの記法で組み込むことができます。
<ChangeItems: アイテムID, 操作, オペランド>
<アイテムの増減: アイテムID, 操作, オペランド>
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: IDが3のアイテムを4つ増やす
<ChangeItems: 3, Increase, 4>
<ChangeItems: 3, +, 4>
<アイテムの増減: 3, 増やす, 4>
例2: IDが3のアイテムを変数2の値だけ減らす
<ChangeItems: 3, Decrease, Variables[2]>
<ChangeItems: 3, -, Variables[2]>
<アイテムの増減: 3, 減らす, 変数[2]>
「武器の増減」は以下のいずれかの記法で組み込むことができます。
<ChangeWeapons: 武器ID, 操作, オペランド, 装備品を含む>
<武器の増減: 武器ID, 操作, オペランド, 装備品を含む>
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
装備品を含むリスト(ツクールMV/MZでは、減らす時のみのオプション)
- チェックオン:
Include Equipment
,装備品を含む
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: ID1の武器を2つ増やす
<ChangeWeapons: 1, Increase, 2>
<武器の増減: 1, +, 2>
<武器の増減: 1, 増やす, 2>
例2: ID2の武器を3つ減らす。装備品を含む
<ChangeWeapons: 2, Decrease, 3, Include Equipment>
<ChangeWeapons: 2, -, 3, true>
<武器の増減: 2, 減らす, 3, 装備品を含む>
例3: ID3の武器を変数4の値だけ減らす。 装備品を含まない
<ChangeWeapons: 3, Decrease, Variables[4]>
<ChangeWeapons: 3, -, V[4], false>
<武器の増減: 3, 減らす, 変数[4], オフ>
「防具の増減」は以下のいずれかの記法で組み込むことができます。
<ChangeArmors: 防具ID, 操作, オペランド, 装備品を含む>
<防具の増減: 防具ID, 操作, オペランド, 装備品を含む>
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
装備品を含むリスト (ツクールMV/MZでは、減らす時のみのオプション)
- チェックオン:
Include Equipment
,装備品を含む
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: ID1の防具を2つ増やす
<ChangeArmors: 1, Increase, 2>
<防具の増減: 1, +, 2>
<防具の増減: 1, 増やす, 2>
例2: ID2の防具を3つ減らす。 装備品を含む
<ChangeArmors: 2, Decrease, 3, Include Equipment>
<ChangeArmors: 2, -, 3, true>
<防具の増減: 2, 減らす, 3, 装備品を含む>
例3: ID3の防具を変数4の値だけ減らす。 装備品を含まない
<ChangeArmors: 3, Decrease, Variables[4]>
<ChangeArmors: 3, -, V[4], false>
<防具の増減: 3, 減らす, 変数[4], オフ>
「メンバーの入れ替え」は以下のいずれかの記法で組み込むことができます。
<ChangePartyMember: アクターID, 操作, 初期化>
<メンバーの入れ替え: アクターID, 操作, 初期化>
操作リスト
- 加える:
Add
,+
,加える
- 外す:
Remove
,-
,外す
初期化リスト
- チェックオン:
Initialize
,初期化
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: ID6のアクターをパーティに加える。 初期化
<ChangePartyMember: 6, Add, Initialize>
<ChangePartyMember: 6, +, true>
<メンバーの入れ替え: 6, 加える, 初期化>
例2: ID2のアクターをパーティから外す。
<ChangePartyMember: 2, Remove>
<ChangePartyMember: 2, ->
<メンバーの入れ替え: 2, 外す>
「HPの増減」は以下のいずれかの記法で組み込むことができます。
<ChangeHp: アクター, 操作, オペランド, 戦闘不能を許可>
<HPの増減: アクター, 操作, オペランド, 戦闘不能を許可>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
戦闘不能を許可リスト
- チェックオン:
Allow Knockout
,戦闘不能を許可
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: ID4のアクターのHPを2増やす
<ChangeHp: 4, Increase, 2>
<ChangeHp: 4, +, 2>
<HPの増減: 4, 増やす, 2>
例2: IDが変数5の値のアクターのHPを変数2の値だけ減らす。 戦闘不能を許可
<ChangeHp: Variables[5], Decrease, Variables[2], Allow Knockout>
<ChangeHp: Variables[5], -, V[2], true>
<HPの増減: 変数[5], 減らす, 変数[2], 戦闘不能を許可>
「MPの増減」は以下のいずれかの記法で組み込むことができます。
<ChangeMp: アクター, 操作, オペランド>
<MPの増減: アクター, 操作, オペランド>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: ID4のアクターのMPを2増やす
<ChangeMp: 4, Increase, 2>
<ChangeMp: 4, +, 2>
<MPの増減: 4, 増やす, 2>
例2: IDが変数5の値のアクターのMPを変数2の値だけ減らす
<ChangeMp: Variables[5], Decrease, Variables[2]>
<ChangeMp: V[5], -, V[2]>
<MPの増減: 変数[5], 減らす, 変数[2]>
「TPの増減」は以下のいずれかの記法で組み込むことができます。
<ChangeTp: アクター, 操作, オペランド>
<TPの増減: アクター, 操作, オペランド>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: IDが4のアクターのTPを2増やす
<ChangeTp: 4, Increase, 2>
<ChangeTp: 4, +, 2>
<TPの増減: 4, 増やす, 2>
例2: IDが変数5の値のアクターのTPを変数2の値だけ減らす
<ChangeTp: Variables[5], Decrease, Variables[2]>
<ChangeTp: V[5], -, V[2]>
<TPの増減: 変数[5], 減らす, 変数[2]>
「ステートの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeState: アクター, 操作, ステートID>
<ステートの変更: アクター, 操作, ステートID>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
操作リスト
- 付加:
Add
,+
,付加
- 解除:
Remove
,-
,解除
例1: IDが1のアクターにIDが4のステートを付加する
<ChangeState: 1, Add, 4>
<ChangeState: 1, +, 4>
<ステートの変更: 1, 付加, 4>
例2: IDが変数3のアクターのIDが2のステートを解除する
<ChangeState: Variables[3], remove, 2>
<ChangeState: V[3], Remove, 2>
<ステートの変更: 変数[3], 解除, 2>
「全回復」は以下のいずれかの記法で組み込むことができます。
<RecoverAll: アクター>
<全回復: アクター>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: IDが1のアクターを全回復
<RecoverAll: 1>
<全回復: 1>
例2: パーティ全体を全回復
<RecoverAll: Entire Party>
<RecoverAll: 0>
<全回復: パーティ全体>
「経験値の増減」は以下のいずれかの記法で組み込むことができます。
<ChangeExp: アクター, 操作, オペランド, レベルアップを表示>
<経験値の増減: アクター, 操作, オペランド, レベルアップを表示>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,V[変数ID]
,変数[変数ID]
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
レベルアップを表示リスト
- チェックオン:
Show Level Up
,レベルアップを表示
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: IDが3のアクターの経験値を1増やす。 レベルアップを表示
<ChangeExp: 3, Increase, 1, Show Level Up>
<ChangeExp: 3, +, 1, true>
<経験値の増減: 3, 増やす, 1, レベルアップを表示>
例2: IDが変数1のアクターの経験値を変数3の値だけ減らす
<ChangeExp: Variables[1], Decrease, Variables[3]>
<ChangeExp: V[1], -, V[3]>
<経験値の増減: 変数[1], 減らす, 変数[3]>
「レベルの増減」は以下のいずれかの記法で組み込むことができます。
<ChangeLevel: アクター, 操作, オペランド, レベルアップを表示>
<レベルの増減: アクター, 操作, オペランド, レベルアップを表示>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
レベルアップを表示リスト
- チェックオン:
Show Level Up
,レベルアップを表示
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
例1: IDが3のアクターのレベルを1増やす。 レベルアップを表示
<ChangeLevel: 3, Increase, 1, Show Level Up>
<ChangeLevel: 3, +, 1, true>
<レベルの増減: 3, 増やす, 1, レベルアップを表示>
例2: IDが変数1のアクターのレベルを変数3の値だけ減らす
<ChangeLevel: Variables[1], Decrease, Variables[3]>
<ChangeLevel: V[1], -, V[3]>
<レベルの増減: 変数[1], 減らす, 変数[3]>
「能力値の増減」は以下のいずれかの記法で組み込むことができます。
<ChangeParameter: アクター, 能力値, 操作, オペランド>
<能力値の増減: アクター, 能力値, 操作, オペランド>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
能力値リスト
- 最大HP:
MaxHP
,0
,最大HP
- 最大MP:
MaxMP
,1
,最大MP
- 攻撃力:
Attack
,2
,攻撃力
- 防御力:
Defense
,3
,防御力
- 魔法力:
M.Attack
,4
,魔法力
- 魔法防御:
M.Defense
,5
,魔法防御
- 敏捷性:
Agility
,6
,敏捷性
- 運:
Luck
,7
,運
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: IDが5のアクターの最大HPを10増やす
<ChangeParameter: 5, MaxHp, Increase, 10>
<ChangeParameter: 5, 0, +, 10>
<能力値の増減: 5, 最大HP, 増やす, 10>
例2: IDが変数2のアクターの魔法力を変数4の値だけ減らす
<ChangeParameter: Variables[2], M.Attack, Decrease, Variables[4]>
<ChangeParameter: Variables[2], 4, -, Variables[4]>
<能力値の増減: 変数[2], 魔法力, 減らす, 変数[4]>
「スキルの増減」は以下のいずれかの記法で組み込むことができます。
<ChangeSkill: アクター, 操作, スキルID>
<スキルの増減: アクター, 操作, スキルID>
アクターリスト
- パーティ全体:
Entire Party
,パーティ全体
,0
- アクターIDを指定:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
操作リスト
- 覚える:
Learn
,+
,覚える
- 忘れる:
Forget
,-
,忘れる
例1: IDが1のアクターがIDが2のスキルを覚える
<ChangeSkill: 1, Learn, 2>
<スキルの増減: 1, 覚える, 2>
例2: IDが変数4のアクターがIDが1のスキルを忘れる
<ChangeSkill: Variables[4], Forget, 1>
<スキルの増減: 変数[4], 忘れる, 1>
「装備の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeEquipment: アクターID, 装備タイプID, 装備品ID>
<装備の変更: アクターID, 装備タイプID, 装備品ID>
装備品IDの補足:武器IDもしくは防具ID
装備品を外したい場合は、None
, なし
, 0
のいずれかを設定してください。
例: IDが1のアクターに、IDが2の装備タイプの、IDが6の装備品を装備
<ChangeEquipment: 1, 2, 6>
<装備の変更: 1, 2, 6>
「名前の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeName: アクターID, 名前>
<名前の変更: アクターID, 名前>
名前は省略可能で、省略した場合は空欄で組み込まれます。
例: IDが1のアクターの名前を「ハロルド」に変更
<ChangeName: 1, ハロルド>
<名前の変更: 1, ハロルド>
「職業の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeClass: アクターID, 職業ID, レベル/経験値の保存>
<職業の変更: アクターID, 職業ID, レベル/経験値の保存>
レベル/経験値の保存リスト
- チェックオン:
Save EXP
,経験値の保存
,Save Level
,レベルの保存
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: IDが3のアクターの職業をIDが2の職業に変更。 レベル/経験値の保存をしない
<ChangeClass: 3, 2>
<職業の変更: 3, 2, オフ>
例2: IDが3のアクターの職業をIDが2の職業に変更。 レベル/経験値の保存をする
<ChangeClass: 3, 2, Save EXP>
<職業の変更: 3, 2, 経験値の保存>
「二つ名の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeNickname: アクターID, 二つ名>
<二つ名の変更: アクターID, 二つ名>
二つ名は省略可能で、省略した場合は空欄で組み込まれます。
例: IDが3のアクターの二つ名を「三人目のアクター」に変更
<ChangeNickname: 3, 三人目のアクター>
<二つ名の変更: 3, 三人目のアクター>
「プロフィールの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeProfile: アクターID, 1行目, 2行目>
<プロフィールの変更: アクターID, 1行目, 2行目>
1行目と2行目はどちらも省略可能です。
両方省略した場合は空欄で組み込まれます。
1行目内に\n
を記述することでプロフィールの改行も可能です。
例: IDが3のアクターのプロフィールを変更 プロフィール1行目:アクター3 プロフィール2行目:初期キャラクター
<ChangeProfile: 3, アクター3, 初期キャラクター>
<プロフィールの変更: 3, アクター3, 初期キャラクター>
「場所移動」は以下のいずれかの記法で組み込むことができます。
<TransferPlayer: 位置, 向き, フェード>
<場所移動: 位置, 向き, フェード>
位置
は、以下の記法で組み込みます。
- 直接指定: 以下のいずれか
Direct[マップID][X座標][Y座標]
直接指定[マップID][X座標][Y座標]
- 変数で指定: 以下のいずれか
WithVariables[マップIDを指定する変数のID][X座標を指定する変数のID][Y座標を指定する変数のID]
変数で指定[マップIDを指定する変数のID][X座標を指定する変数のID][Y座標を指定する変数のID]
向きリスト
- そのまま:
Retain
,0
,そのまま
- 下:
Down
,2
,下
- 左:
Left
,4
,左
- 右:
Right
,6
,右
- 上:
Up
,8
,上
フェードリスト
- 黒:
Black
,0
,黒
- 白:
White
,1
,白
- なし:
None
,2
,なし
例1: IDが1のマップのX座標10,Y座標20に移動。 向き:そのまま フェード:黒
<TransferPlayer: Direct[1][10][20], Retain, Black>
<場所移動: 直接指定[1][10][20], 1, 10, 20, そのまま, 黒>
例2: IDが変数1のマップの、X座標が変数2, Y座標が変数3に移動。 向き:下 フェード:白
<TransferPlayer: WithVariables[1][2][3], Down, White>
<場所移動: 変数の指定[1][2][3], 下, 白>
「乗り物の位置設定」は以下のいずれかの記法で組み込むことができます。
<SetVehicleLocation: 乗り物, 位置>
<乗り物の位置設定: 乗り物, 位置>
乗り物リスト
- 小型船:
Boat
,0
,小型船
- 大型船:
Ship
,1
,大型船
- 飛行船:
Airship
,2
,飛行船
位置
は、以下の記法で組み込みます。
- 直接指定: 以下のいずれか
Direct[マップID][X座標][Y座標]
直接指定[マップID][X座標][Y座標]
- 変数で指定: 以下のいずれか
WithVariables[マップIDを指定する変数のID][X座標を指定する変数のID][Y座標を指定する変数のID]
変数で指定[マップIDを指定する変数のID][X座標を指定する変数のID][Y座標を指定する変数のID]
例1: IDが1のマップのX座標10,Y座標20に小型船を配置
<SetVehicleLocation: Boat, Direct[1][10][20]>
<乗り物の位置設定: 小型船, 直接指定[1][10][20]>
例2: IDが変数1のマップの、X座標が変数2, Y座標が変数3に大型船を配置
<SetVehicleLocation: Ship, WithVariables[1][2][3]>
<乗り物の位置設定: 大型船, WithVariables[1][2][3]>
「イベントの位置設定」は以下のいずれかの記法で組み込むことができます。
<SetEventLocation: イベント, 位置, 向き>
<イベントの位置設定: イベント, 位置, 向き>
イベント
- このイベント:
This Event
,0
,このイベント
- イベントIDで指定:
1以上の整数
位置
は、以下の記法で組み込みます。
- 直接指定: 以下のいずれか
Direct[マップID][X座標][Y座標]
直接指定[マップID][X座標][Y座標]
- 変数で指定: 以下のいずれか
WithVariables[X座標を指定する変数のID][Y座標を指定する変数のID]
変数で指定[X座標を指定する変数のID][Y座標を指定する変数のID]
- 他のイベントと交換: 以下のいずれか。イベントは上述したイベントの指定方法と同じ引数を使えます。
Exchange[イベント]
交換[イベント]
向きリスト
- そのまま:
Retain
,0
,そのまま
- 下:
Down
,2
,下
- 左:
Left
,4
,左
- 右:
Right
,6
,右
- 上:
Up
,8
,上
例1: このイベントをX座標10,Y座標20に設定。 向き:そのまま
<SetEventLocation: This Event, Direct[10][20], Retain>
<イベントの位置設定: このイベント, 直接指定[10][20], そのまま>
例2: IDが12のイベントを、X座標が変数2の値,Y座標が変数3の値に設定。 向き:上
<SetEventLocation: 12, WithVariables[2][3], Up>
<イベントの位置設定: 12, 変数で指定[2][3], 上>
例3: IDが12のイベントをこのイベントと交換。 向き:上
<SetEventLocation: 12, Exchange[This Event], Up>
<イベントの位置設定: 12, 交換[このイベント], 上>
「マップのスクロール」は以下のいずれかの記法で組み込むことができます。
<ScrollMap: 方向, 距離, 速度, 完了までウェイト>
<マップのスクロール: 方向, 距離, 速度, 完了までウェイト>
向きリスト
- 下:
down
,2
,下
- 左:
left
,4
,左
- 右:
right
,6
,右
- 上:
up
,8
,上
距離リスト
1以上の整数
速度
- 1/8倍速:
x8 slower
,1
,1/8倍速
- 1/4倍速:
x4 slower
,2
,1/4倍速
- 1/2倍速:
x2 slower
,3
,1/2倍速
- 標準速:
normal
,4
,標準速
- 2倍速:
x2 faster
,5
,2倍速
- 4倍速:
x4 faster
,6
,4倍速
完了までウェイトリスト(省略可能)
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
完了までウェイト
は省略可能です。その場合は、チェックオフとなります。
また、完了までウェイト
をオンにするのはツクールMZの機能です。
例1: 下方向の距離100、標準速でマップをスクロール。 完了までウェイトしない
<ScrollMap: down, 100, normal>
<マップのスクロール: 下, 100, 標準速>
<ScrollMap: down, 100, normal, false>
<マップのスクロール: 下, 100, 標準速, オフ>
例2: 右方向の距離50、1/2倍速でマップをスクロール。 完了までウェイト
<ScrollMap: right, 50, x2 slower, Wait for Completion>
<ScrollMap: right, 50, x2 slower, Wait>
<ScrollMap: right, 50, x2 slower, ON>
<マップのスクロール: 右, 50, 1/2倍速, true>
<ScrollMap: right, 50, x2slower, オン>
<マップのスクロール: 右, 50, 1/2倍速, オン>
「移動ルートの設定」は以下の記法で組み込めます。
<SetMovementRoute: 対象, リピート, スキップ, 完了までウェイト>
<移動コマンド>
<移動コマンド>
・・・
<移動コマンド>
とは、キャラクター(イベント)の移動方法を指示するタグです。
移動コマンドの一覧は、後述しています。
移動コマンドの羅列の終了を示すタグは必要ありません。
なおSetMovementRoute
は移動ルートの設定
で代替できます。
対象リスト
- プレイヤー:
player
,-1
,プレイヤー
- このイベント:
This Event
,0
,このイベント
- イベントIDで指定:
1以上の整数
リピートリスト
- チェックオン:
Repeat
,Repeat Movements
,動作を繰り返す
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
スキップリスト
- チェックオン:
Skip
,Skip If Cannot Move
,移動できない場合は飛ばす
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
完了までウェイトリスト
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
移動コマンドの記法について示す前に、具体例を示します。
例: 移動ルートの設定 対象をプレイヤー リピートしない スキップしない 完了までウェイトする
- x10,y20にジャンプ
- 60フレームウェイト
- スイッチID1をスイッチON
- 移動速度を「標準速」に変更
- Actor1.pngの三つ目のIDに画像を変更
- 不透明度を255に変更
- 合成方法を通常に変更
- SEを「Attack1.ogg」の音量90,ピッチ100%,位相0に変更
- スクリプトにconsole.log("今日も一日がんばるぞい!")を設定
【英語のタグ】
<SetMovementRoute: player, false, false, true>
<Jump: 10, 20>
<McWait: 60>
<SwitchOn: 1>
<ChangeSpeed: normal>
<ChangeImage: Actor1, 2>
<ChangeOpacity: 255>
<ChangeBlendMode: normal>
<McPlaySe: Attack1, 90, 100, 0>
<McScript: console.log("今日も一日がんばるぞい!");>
【日本語のタグ】
<移動ルートの設定: プレイヤー, オフ, オフ, オン>
<ジャンプ: 10, 20>
<移動コマンドウェイト: 60>
<スイッチON: 1>
<移動速度の変更: 標準速>
<画像の変更: Actor1, 2>
<不透明度の変更: 255>
<合成方法の変更: 通常>
<移動コマンドSEの演奏: Attack1, 90, 100, 0>
<移動コマンドスクリプト: console.log("今日も一日がんばるぞい!");>
以下に、移動コマンドの詳細について示します。
引数なしの移動コマンドの一覧を示します。
<MoveDown> <下に移動>
<MoveLeft> <左に移動>
<MoveRight> <右に移動>
<MoveUp> <上に移動>
<MoveLowerLeft> <左下に移動>
<MoveLowerRight> <右下に移動>
<MoveUpperLeft> <左上に移動>
<MoveUpperRight> <右上に移動>
<MoveAtRandom> <ランダムに移動>
<MoveTowardPlayer> <プレイヤーに近づく>
<MoveAwayFromPlayer> <プレイヤーから遠ざかる>
<OneStepForward> <一歩前進>
<OneStepBackward> <一歩後退>
<TurnDown> <下を向く>
<TurnLeft> <左を向く>
<TurnRight> <右を向く>
<TurnUp> <上を向く>
<Turn90Right> <右に90度回転>
<Turn90Left> <左に90度回転>
<Turn180> <180度回転>
<Turn90RightorLeft> <右か左に90度回転>
<TurnAtRandom> <ランダムに方向転換>
<TurnTowardPlayer> <プレイヤーの方を向く>
<TurnAwayFromPlayer> <プレイヤーの逆を向く>
<WalkingAnimationOn> <歩行アニメON>
<WalkingAnimationOff> <歩行アニメOFF>
<SteppingAnimationOn> <足踏みアニメON>
<SteppingAnimationOff> <足踏みアニメOFF>
<DirectionFixOn> <向き固定ON>
<DirectionFixOff> <向き固定OFF>
<ThroughOn> <すり抜けON>
<ThroughOff> <すり抜けOFF>
<TransparentOn> <透明化ON>
<TransparentOff> <透明化OFF>
「ジャンプ」は以下のいずれかの記法で組み込みます。
<Jump: x, y>
-
<ジャンプ: x, y>
x
,y
は整数値を指定してださ
移動コマンドの「ウェイト」は以下のいずれかの記法で組み込みます。
<McWait: ウェイト>
<移動コマンドウェイト: ウェイト>
ウェイト
は1以上の整数値で指定してください。
「スイッチオンON」は以下のいずれかの記法で組み込みます。
<SwitchOn: スイッチID>
<スイッチON: スイッチID>
「スイッチOFF」は以下のいずれかの記法で組み込みます。
<SwitchOff: スイッチID>
<スイッチOFF: スイッチID>
スイッチID
では、対象とするスイッチのIDを整数値で指定してください。
「移動速度の変更」は以下のいずれかの記法で組み込みます。
<ChangeSpeed: 移動速度>
<移動速度の変更: 移動速度>
移動速度リスト
- 1/8倍速:
x8 Slower
,1
,1/8倍速
- 1/4倍速:
x4 Slower
,2
,1/4倍速
- 1/2倍速:
x2 Slower
,3
,1/2倍速
- 標準速:
Normal
,4
,標準速
- 2倍速:
x2 Faster
,5
,2倍速
- 4倍速:
x4 Faster
,6
,4倍速
「移動頻度の変更」は以下のいずれかの記法で組み込みます。
<ChangeFrequency: 移動頻度>
<移動頻度の変更: 移動頻度>
移動頻度リスト
- 最低:
Lowest
,1
,最低
- 低:
Lower
,2
,低
- 標準:
Normal
,3
,標準
- 高:
Higher
,4
,高
- 最高:
Highest
,5
,最高
「画像の変更」は以下のいずれかの記法で組み込みます。
<ChangeImage: 画像, 画像ID>
<画像の変更: 画像, 画像ID>
画像
は、変更したい画像の、拡張子(.png)を除いたファイル名を指定してください。
画像ID
は、画像ファイル内のどの位置を指定するかを設定します。
RPGツクールの仕様では、縦軸を2分割、横軸を4分割した合計8つのエリアに画像を分割して考えます。
その分割したエリア毎に、以下のように数字が割り振られます。
画像ID
は省略可能です。省略した場合は、0
になります。
|0|1|2|3|
|4|5|6|7|
画像を「なし」に設定したい場合は、None
かなし
に設定してください。
「不透明度の変更」は以下のいずれかの記法で組み込みます。
<ChangeOpacity: 不透明度>
<不透明度の変更: 不透明度>
不透明度
には、0
以上255
以下の整数値を入力してください。
「合成方法の変更」は以下のいずれかの記法で組み込みます
<ChangeBlendMode: 合成方法>
<合成方法の変更: 合成方法>
合成方法リスト
- 通常:
Normal
,0
,通常
- 加算:
Additive
,1
,加算
- 乗算:
Multiply
,2
,乗算
- スクリーン:
Screen
,3
,スクリーン
移動コマンドの「SEの演奏」は以下のいずれかの記法で組み込みます。
<McPlaySe: ファイル名, 音量, ピッチ, 位相>
<移動コマンドSEの演奏: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
ファイル名を「なし」にしたいときはNone
かなし
と記述してください。
移動コマンドの「スクリプト」は以下のいずれかの記法で組み込みます。
<McScript: スクリプト>
<移動コマンドスクリプト: スクリプト>
「乗り物の乗降」は以下のいずれかの記法で組み込むことができます。
<GetOnOffVehicle>
<乗り物の乗降>
「透明状態の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeTransparency: 透明状態>
<透明状態の変更: 透明状態>
透明状態リスト
- ラジオボタンオン:
ON
,true
,オン
,0
, - ラジオボタンオフ:
OFF
,false
,オフ
,1
例: 透明状態をオンに変更
<ChangeTransparency: ON>
<透明状態の変更: オン>
「隊列歩行の変更」は以下のいずれかの記法で組み込むことができます。
<ChangePlayerFollowers: 隊列歩行>
<隊列歩行の変更: 隊列歩行>
隊列歩行リスト
- ラジオボタンオン:
ON
,true
,オン
,0
, - ラジオボタンオフ:
OFF
,false
,オフ
,1
例: 隊列歩行をオンに変更
<ChangePlayerFollowers: ON>
<隊列歩行の変更: ON>
「隊列メンバーの集合」は以下のいずれかの記法で組み込むことができます。
<GatherFollowers>
<隊列メンバーの集合>
「アニメーションの表示」は以下のいずれかの記法で組み込むことができます。
<ShowAnimation: キャラクター, アニメーションID, 完了までウェイト>
<アニメーションの表示: キャラクター, アニメーションID, 完了までウェイト>
キャラクターリスト
- プレイヤー:
Player
,-1
,プレイヤー
- このイベント:
This Event
,0
,このイベント
- イベントIDで指定:
1以上の整数
完了までウェイトリスト
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
完了までウェイト
は省略可能です。その場合は、チェックオフとなります。
例1: プレイヤーを対象にID2のアニメーションを表示。 完了までウェイト
<ShowAnimation: player, 2, Wait for Completion>
<アニメーションの表示: プレイヤー, 2, 完了までウェイト>
例2: IDが3のイベントを対象にIDが4のアニメーションを表示。 完了までウェイトしない
<ShowAnimation: 3, 4>
<アニメーションの表示: 3, 4, オフ>
「フキダシアイコンの表示」は以下のいずれかの記法で組み込むことができます。
<ShowBalloonIcon: キャラクター, フキダシアイコン, 完了までウェイト>
<フキダシアイコンの表示: キャラクター, フキダシアイコン, 完了までウェイト>
キャラクターリスト
- プレイヤー:
Player
,-1
,プレイヤー
- このイベント:
This Event
,0
,このイベント
- イベントID:
1以上の整数
フキダシアイコンリスト
- びっくり:
Exclamation
,1
,びっくり
- はてな:
Question
,2
,はてな
- 音符:
Music Note
,3
,音符
- ハート:
Heart
,4
,ハート
- 怒り:
Anger
,5
,怒り
- 汗:
Sweat
,6
,汗
- くしゃくしゃ:
Flustration
,Cobweb
,7
,くしゃくしゃ
- 沈黙:
Silence
,8
,沈黙
- 電球:
Light Bulb
,9
,電球
- zzz:
zzz
,10
- ユーザー定義1:
user-defined1
,11
,ユーザー定義1
- ユーザー定義2:
user-defined2
,12
,ユーザー定義2
- ユーザー定義3:
user-defined3
,13
,ユーザー定義3
- ユーザー定義4:
user-defined4
,14
,ユーザー定義4
- ユーザー定義5:
user-defined5
,15
,ユーザー定義5
完了までウェイトリスト
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
完了までウェイト
は省略可能です。その場合は、チェックオフとなります。
例1: プレイヤーを対象にびっくりアイコンを表示。 完了までウェイトしない
<ShowBalloonIcon: Player, Exclamation, false>
<フキダシアイコンの表示:, プレイヤー, びっくり, オフ>
<showballoonicon: -1, 1, 0>
例2: IDが2のイベントを対象にハートアイコンを表示。 完了までウェイトする
<ShowBalloonIcon: 22, Heart, Wait for Completion>
<フキダシアイコンの表示: 22, ハート, 完了までウェイト>
<ShowBalloonIcon: 22, 4, Wait>
「イベントの一時消去」は以下のいずれかの記法で組み込むことができます。
<EraseEvent>
<イベントの一時消去>
ピクチャの表示は、以下の記法で指定します。
<ShowPicture: ピクチャ番号(整数), ファイル名, オプション1, オプション2, オプション3>
必須の引数はピクチャ番号(整数)とファイル名だけです。 位置・拡大率・合成はオプションとして指定でき、指定しない場合はデフォルト値が設定されます。
ShowPicture
はピクチャの表示
かSP
で代替できます。
オプションの指定方法を述べる前に、いくつか具体例を記します。
- 例1: 以下のデフォルト設定でピクチャを表示する。
- ピクチャ番号: 1
- 画像ファイル名: Castle.png
- 位置: 原点は左上でX座標0, Y座標0(デフォルト設定)
- 拡大率: 幅100%, 高さ100%(デフォルト設定)
- 合成: 不透明度は255, 合成方法は通常(デフォルト設定)
<ShowPicture: 1, Castle>
<ピクチャの表示: 1, Castle>
<SP: 1, Castle>
- 例2: 以下の設定(拡大率だけ指定)でピクチャを表示
- ピクチャ番号: 2
- 画像ファイル名: Castle.png
- 位置: 原点は左上でX座標0, Y座標0(デフォルト設定)
- 拡大率: 幅50%, 高さ55%
- 合成: 不透明度は255, 合成方法は通常(デフォルト設定)
<ShowPicture: 2, Castle, Scale[50][55]>
<ピクチャの表示: 2, Castle, 拡大率[50][55]>
<SP: 2, Castle, Scale[50][55]>
- 例3: 以下の設定でピクチャを表示
- ピクチャ番号: 3
- 画像ファイル名: Castle.png
- 位置: 原点は中央で、X座標は変数2,Y座標は変数3
- 拡大率:幅90%, 高さ95%
- 合成: 不透明度は235, 合成方法はスクリーン
<ShowPicture: 3, Castle, Position[Center][Variables[2]][Variables[3]], Scale[90][95], Blend[235][Screen]>
<ピクチャの表示: 3, Castle, 位置[中央][変数[2]][変数[3]], 拡大率[90][95], 合成[235][スクリーン]>
<SP: 3, Castle, Position[Center][V[2]][V[3]], Scale[90][95], Blend[235][Screen]>
オプションは順不同です。ピクチャ番号とファイル名は引数の位置は固定ですが、オプション1,2,3はどのような順番で指定しても大丈夫です。
ピクチャの位置は、以下の記法で指定します。
Position[原点("Upper Left" or "Center")][X座標(定数or変数)][Y座標(定数or変数)]
Position
は位置
でも代替できます。
X,Y座標は定数か変数で指定できます。
定数は整数値をそのまま入力し、変数の場合はVariables[変数ID]
というように指定します。
Variables
は変数
かV
でも代替できます。
例えば以下の通りです。
- 例1: 原点は左上, X座標は100, Y座標は200,
Position[Upper Left][100][200]
位置[左上][100][200]
- 例2: X座標は変数2の値, 変数3の値
Position[Center][Variables[2]][Variables[3]]
位置[中央][変数[2]][変数[3]]
Position[Center][V[2]][V[3]]
位置を指定しなかった場合のデフォルト値はPosition[Upper Left][0][0]
となります。
ピクチャの拡大率は、以下の記法で指定します。
Scale[幅(%)][高さ(%)]
Scale
は拡大率
でも代替できます。
例えば幅90%, 高さ95%は以下のように指定します。
Scale[90][95]
拡大率[90][95]
拡大率を指定しなかった場合のデフォルト値はScale[100][100]
となります。
ピクチャの合成は、以下の記法で指定します。
Blend[不透明度(0~255の整数)][合成方法(通常, 加算, 乗算, or スクリーン)]
Blend
は合成で代替できます。
不透明度は以下のリストから指定します。
- 通常:
Normal
,通常
- 加算:
Additive
,加算
- 乗算:
Multiply
,乗算
- スクリーン:
Screen
,スクリーン
例えば不透明度が200で、加算を指定する場合は以下のように指定します。
Blend[200][Additive]
合成[200][加算]
合成を指定しなかった場合のデフォルト値はBlend[255][Normal]
となります。
ピクチャの移動は、以下の記法で指定します。
<MovePicture: ピクチャ番号(整数), オプション1, オプション2, オプション3, オプション4, オプション5>
必須の引数はピクチャ番号だけです。 移動にかける時間と、位置・拡大率・合成・イージングはオプションとして指定でき、指定しない場合はデフォルト値が設定されます。
MovePictures
はピクチャの移動
かMP
で代替できます。
オプションの指定方法を述べる前に、いくつか具体例を記します。
- 例1: 以下のデフォルト設定でピクチャを移動する。
- ピクチャ番号: 1
- 時間: 60フレーム, 完了までウェイト(デフォルト設定)
- 位置: 原点は左上でX座標0, Y座標0(デフォルト設定)
- 拡大率: 幅100%, 高さ100%(デフォルト設定)
- 合成: 不透明度は255, 合成方法は通常(デフォルト設定)
- イージング: 一定速度(デフォルト値)
<MovePicture: 1>
<ピクチャの移動: 1>
<MP: 1>
- 例2: 以下の設定でピクチャを移動(縮小だけ)
- ピクチャ番号:2
- 時間: 60フレーム, 完了までウェイト(デフォルト設定)
- 位置: 原点は左上でX座標0, Y座標0(デフォルト設定)
- 拡大率: 幅50%, 高さ55%
- 合成: 不透明度は255, 合成方法は通常(デフォルト設定)
- イージング: 一定速度(デフォルト値)
<MovePicture: 2, Scale[50][55]>
<ピクチャの移動: 2, Scale[50][55]>
<MP: 2, Scale[50][55]>
- 例3: 以下の設定でピクチャを移動
- ピクチャ番号: 3
- 時間: 45フレーム, 完了までウェイトする
- 位置: 原点は中央で、X座標は変数2,Y座標は変数3
- 拡大率:幅90%, 高さ95%
- 合成: 不透明度は235, 合成方法はスクリーン
- イージング: ゆっくり始まる
<MovePicture: 3, Duration[45][Wait for Completion], Position[Center][Variables[2]][Variables[3]], Scale[90][95], Blend[235][Screen], Easing[Slow start]>
<ピクチャの移動: 3, 時間[45][完了までウェイト], 位置[中央][変数[2]][変数[3]], 拡大率[90][95], 合成[235][スクリーン], イージング[ゆっくり始まる]>
<MP: 3, Duration[45][Wait], Position[Center][V[2]][V[3]], Scale[90][95], Blend[235][Screen], Easing[Slow start]>
オプションは順不同です。ピクチャ番号の引数の位置は固定ですが、オプション1,2,3,4はどのような順番で指定しても大丈夫です。
また、
- 位置
- 拡大率
- 合成
については、「ピクチャの表示」イベントタグのオプションの記法と同一なので、そちらをご覧ください。 ここでは、時間の指定方法とイージングについて記します。
ピクチャの移動時間は、以下の記法で指定します。
Duration[フレーム数(1/60秒)][完了するまでウェイトするか否か("Wait for Completion" or 省略)]
Duration
は時間
で、Wait for Completion
は完了までウェイト
かWait
で代替できます。
例えば、以下の通りです。
- 例1: 45フレームで完了するまでウェイトする
Duration[45][Wait for Completion]
時間[45][完了までウェイト]
時間[45][Wait]
- 例2: 60フレームで完了するまでウェイトしない
Duration[60]
時間[60]
Duration[60][]
時間を指定しなかった場合のデフォルト値はDuration[60][Wait for Completion]
となります。
イージングは、以下の記法で指定します。
Easing[モード(Constant speed, Slow start, Slow end, Slow start and end)]
Easing
はイージング
でも代替できます。
モードは以下の対応関係で代替できます。
-
Constant speed
:一定速度
,Linear
-
Slow start
:ゆっくり始まる
,Ease-in
-
Slow end
:ゆっくり終わる
,Ease-out
-
Slow start and end
:ゆっくり始まってゆっくり終わる
,Ease-in-out
例えば、以下の通りです。
- 例1: 一定速度
Easing[Constant speed]
イージング[一定速度]
Easing[Linear]
- 例2: ゆっくり始まってゆっくり終わる
Easing[Slow start and end]
イージング[ゆっくり始まってゆっくり終わる]
Easing[Ease-in-out]
イージングを指定しなかった場合のデフォルト値はEasing[Constant speed]
となります。
ピクチャの回転は以下の記法で指定します。
<RotatePicture: ピクチャ番号(整数), 回転速度(-90~90の整数)>
RotatePicture
はピクチャの回転
かRP
でも代替できます。
例えば、速度が-30で番号1のピクチャを回転するのは、以下の通りとなります。
<RotatePicture: 1, -30>
<ピクチャの回転: 1, -30>
<RP: 1, -30>
ピクチャの色調変更は以下の記法で指定します。
<TintPicture: ピクチャ番号(整数), オプション1, オプション2>
必須の引数はピクチャ番号だけです。 色調変更にかける時間と色調はオプションとして指定でき、指定しない場合はデフォルト値が設定されます。
TintPicture
はピクチャの色調変更
かTP
で代替できます。
オプションの指定方法を述べる前にいくつか具体例を記します。
- 例1: 以下のデフォルト設定でピクチャの色調を変更する。
- ピクチャ番号: 1
- 時間: 60フレーム, 完了までウェイト(デフォルト設定)
- 色調: 赤0, 緑0, 青0, グレイ0(デフォルト設定)
<TintPicture: 1>
<ピクチャの色調変更: 1>
<TP: 1>
- 例2: 以下の設定でピクチャの色調を変更する。
- ピクチャ番号: 2
- 時間: 60フレーム, 完了までウェイト(デフォルト設定)
- 色調: 赤0, 緑255, 青255, グレイ0
<TintPicture: 2, ColorTone[0][255][255][0]>
<ピクチャの色調変更: 2, 色調[0][255][255][0]>
<TP: 2, CT[0][255][255][0]>
- 例3: 以下の設定でピクチャの色調を変更する。
- ピクチャ番号: 3
- 時間: 30フレーム, 完了までウェイト
- 色調: ダーク(赤-68, 緑-68, 青-68, グレイ0)
<TintPicture: 3, Duration[30][Wait for Completion], ColorTone[Dark]>
<ピクチャの色調変更: 3, 時間[30][完了までウェイト], 色調[ダーク]>
<TP: 3, Duration[30][Wait], CT[Dark]>
オプションは順不同です。ピクチャ番号は固定ですが、オプション1,2はどのような順番で指定しても大丈夫です。
また、時間については、「ピクチャの移動」イベントタグのオプションの記法と同一なので、そちらをご覧ください。 ここでは、色調の指定方法について記します。
ピクチャの色調は、以下の記法で指定します。
ColorTone[赤の強さ][緑の強さ][青の強さ][グレイの強さ]>
ColorTone
は色調
かCT
で代替できます。
例えば、以下のように設定できます。
ColorTone[-68][68][100][0]
色調[-68][68][100][0]
CT[-68][68][100][0]
[赤の強さ]の部分に指定の文字列を入力することで、RPGツクールMVの機能と同様に「通常」, 「ダーク」, 「セピア」, 「夕暮れ」,「夜」で設定することができます。以下のように色調が対応しています。
-
通常
orNormal
:ColorTone[0][0][0][0]
-
ダーク
orDark
:ColorTone[-68][-68][-68][0]
-
セピア
orSepia
:ColorTone[34][-34][-68][170]
-
夕暮れ
orSunset
:ColorTone[68][-34][-34][0]
-
夜
orNight
:ColorTone[-68][-68][0][68]
例えば、番号4のピクチャを1秒でセピアに変更する場合は以下のように書けます。 1秒(60フレーム)はデフォルト設定です。
<TintPicture: 4, ColorTone[Sepia]>
<ピクチャの色調変更: 4, ColorTone[セピア]>
<TP: 4, CT[Sepia]>
ピクチャの消去は以下の記法で指定します。
<ErasePicture: ピクチャ番号(整数)>
ErasePicture
はピクチャの消去
かEP
でも代替できます。
例えば、以下のように書くと番号1のピクチャを削除できます。
<ErasePicture: 1>
<ピクチャの消去: 1>
<EP: 1>
ウェイトのイベントコマンドは、以下のいずれかの記法でしていします。
<wait: フレーム数(1/60秒)>
<ウェイト: フレーム数(1/60秒)>
例えば以下のように記述すると60フレーム(1秒)のウェイトが組み込まれます。
<wait: 60>
画面フェードアウトは以下のいずれかの記法で組み込めます。
<fadeout>
<FO>
<フェードアウト>
画面のフェードインは以下のいずれかの記法で組み込めます。
<fadein>
<FI>
<フェードイン>
ピクチャの色調変更は以下の記法で指定します。
<TintScreen: オプション1, オプション2>
色調変更にかける時間と色調はオプションとして指定でき、指定しない場合はデフォルト値が設定されます。
TintScreen
は画面の色調変更
で代替できます。
オプションの指定方法を述べる前にいくつか具体例を記します。
- 例1: 以下のデフォルト設定でピクチャの色調を変更する。
- 色調: 赤0, 緑0, 青0, グレイ0(デフォルト設定)
- 時間: 60フレーム, 完了までウェイト(デフォルト設定)
<TintScreen>
<画面の色調変更>
- 例2: 以下の設定で画面の色調を変更する。
- 色調: カラーはダーク
- 時間: 30フレーム、完了までウェイト
<TintScreen: ColorTone[Dark], Duration[30][Wait for Completion]>
<画面の色調変更: 色調[Dark], 時間[30][完了までウェイト]>
- 例3: 以下の設定で画面の色調を変更する。
- 色調: は赤12, 緑34, 青56, グレイ0
- 時間: が45フレーム、完了までウェイトしない
<TintScreen: ColorTone[12][34][56][0], Duration[45]>
<画面の色調変更: 色調[12][34][56][0], 時間[45]>
オプションは順不同です。オプション1,2はどのような順番で指定しても大丈夫です。
画面の色調は、以下の記法で指定します。
ColorTone[赤の強さ][緑の強さ][青の強さ][グレイの強さ]>
ColorTone
は色調
かCT
で代替できます。
例えば、以下のように設定できます。
ColorTone[-68][68][100][0]
色調[-68][68][100][0]
CT[-68][68][100][0]
[赤の強さ]の部分に指定の文字列を入力することで、RPGツクールMV/MZの機能と同様に「通常」, 「ダーク」, 「セピア」, 「夕暮れ」,「夜」で設定することができます。以下のように色調が対応しています。
-
通常
orNormal
:ColorTone[0][0][0][0]
-
ダーク
orDark
:ColorTone[-68][-68][-68][0]
-
セピア
orSepia
:ColorTone[34][-34][-68][170]
-
夕暮れ
orSunset
:ColorTone[68][-34][-34][0]
-
夜
orNight
:ColorTone[-68][-68][0][68]
例えば、画面を1秒でセピアに変更する場合は以下のように書けます。 1秒(60フレーム)はデフォルト設定です。
<TintScreen: ColorTone[Sepia]>
<画面の色調変更: 4, ColorTone[セピア]>
画面の色調変更の時間は、以下の記法で指定します。
Duration[フレーム数(1/60秒)][完了するまでウェイトするか否か("Wait for Completion" or 省略)]
Duration
は時間
で、Wait for Completion
は完了までウェイト
かWait
で代替できます。
例えば、以下の通りです。
- 例1: 45フレームで完了するまでウェイトする
Duration[45][Wait for Completion]
時間[45][完了までウェイト]
時間[45][Wait]
- 例2: 60フレームで完了するまでウェイトしない
Duration[60]
時間[60]
Duration[60][]
時間を指定しなかった場合のデフォルト値はDuration[60][Wait for Completion]
となります。
「画面のフラッシュ」は以下のいずれかの記法で組み込むことができます。
<FlashScreen: 赤, 緑, 青, 強さ, 時間, 完了までウェイト>
<画面のフラッシュ: 赤, 緑, 青, 強さ, 時間, 完了までウェイト>
完了までウェイトリスト
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例: 画面を以下の設定でフラッシュさせる
- 赤: 50
- 緑: 100
- 青: 150
- 強さ: 170
- 時間: 60フレーム
- 完了までウェイトさせる
<FlashScreen: 50, 100, 150, 170, 60, Wait for Completion>
<画面のフラッシュ: 50, 100, 150, 170, 60, 完了までウェイト>
「画面のシェイク」は以下のいずれかの記法で組み込むことができます。
<ShakeScreen: 強さ, 速さ, 時間, 完了までウェイト>
<画面のシェイク: 強さ, 速さ, 時間, 完了までウェイト>
完了までウェイトリスト
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例: 強さ5、速さ8で60フレームかけて画面をシェイクする。 完了までウェイト
<ShakeScreen: 5, 8, 60, Wait for Completion>
<画面のシェイク: 5, 8, 60, 完了までウェイト>
「天候の設定」は以下のいずれかの記法で組み込むことができます。
<SetWeatherEffect: 種類, 強さ, 時間, 完了までウェイト>
<天候の設定: 種類, 強さ, 時間, 完了までウェイト>
種類リスト
- なし:
None
,なし
- 雨:
Rain
,雨
- 嵐:
Storm
,嵐
- 雪:
Snow
,雪
完了までウェイトリスト
- チェックオン:
Wait for Completion
,完了までウェイト
,Wait
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
例: 天候は雨、強さ5、60フレームかけて天候を変更する。完了までウェイト
<SetWeatherEffect: Rain, 5, 60, Wait for Completion>
<天候の設定: 雨, 5, 60, 完了までウェイト>
BGMの演奏は、以下のいずれかの記法で指定します。
<PlayBGM: ファイル名, 音量, ピッチ, 位相>
<BGMの演奏: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
-
例1: Castle1をデフォルト設定で演奏:
<PlayBGM: Castle1>
-
例2: Castle2を音量50, ピッチ80, 位相30で演奏:
<PlayBGM: Castle2, 50, 80, 30>
BGMを「なし」に設定したい場合は以下のいずれかの記法で指定してください。
<PlayBGM: None>
<PlayBGM: なし>
<StopBGM>
本プラグインを使用する場合は、「None」「なし」というファイル名のBGMは利用できないことにご注意ください。
BGMのフェードアウトは以下のいずれかの記法で組み込みます。
<FadeoutBGM: 時間(秒)>
<BGMのフェードアウト: 時間(秒)>
例えば、以下のように記述すると3秒でBGMがフェードアウトします。
<FadeoutBGM: 3>
<BGMのフェードアウト: 3>
BGMの保存は以下のいずれかの記法で組み込みます。
<SaveBGM>
<BGMの保存>
BGMの再開は以下のいずれかの記法で組み込みます。
<ReplayBGM>
<BGMの再開>
BGSの演奏は、以下のいずれかの記法で指定します。
<PlayBGS: ファイル名, 音量, ピッチ, 位相>
<BGSの演奏: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
-
例1: Cityをデフォルト設定で演奏:
<PlayBGS: City>
-
例2: Darknessを音量50, ピッチ80, 位相30で演奏:
<PlayBGS: Darkness, 50, 80, 30>
BGSを「なし」に設定したい場合は以下のいずれかの記法で指定してください。
<PlayBGS: None>
<PlayBGS: なし>
<StopBGS>
本プラグインを使用する場合は、「None」「なし」というファイル名のBGSは利用できないことにご注意ください。
BGSのフェードアウトは以下のいずれかの記法で組み込みます。
<FadeoutBGS: 時間(秒)>
<BGSのフェードアウト: 時間(秒)>
例えば、以下のように記述すると3秒でBGSがフェードアウトします。
<FadeoutBGS: 3>
<BGSのフェードアウト: 3>
MEの演奏は、以下のいずれかの記法で指定します。
<PlayME: ファイル名, 音量, ピッチ, 位相>
<MEの演奏: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
-
例1: Innをデフォルト設定で演奏:
<PlayME: Inn>
-
例2: Mysteryを音量50, ピッチ80, 位相30で演奏
<PlayME: Mystery, 50, 80, 30>
MEを「なし」に設定したい場合は以下のいずれかの記法で指定してください。
<PlayME: None>
<PlayME: なし>
<StopME>
本プラグインを使用する場合は、「None」「なし」というファイル名のMEは利用できないことにご注意ください。
SEの演奏は、以下のいずれかの記法で指定します。
<PlaySE: ファイル名, 音量, ピッチ, 位相>
<SEの演奏: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
-
例1: Attack1をデフォルト設定で演奏:
<PlaySE: Attack1>
-
例2: Attack2を音量50, ピッチ80, 位相30で演奏:
<PlaySE: Attack2, 50, 80, 30>
SEを「なし」に設定したい場合は以下のいずれかの記法で指定してください。
<PlaySE: None>
<PlaySE: なし>
本プラグインを使用する場合は、「None」「なし」というファイル名のSEは利用できないことにご注意ください。
SEの停止は以下のいずれかの記法で指定します。
<StopSE>
<SEの停止>
「ムービーの再生」は以下のいずれかの記法で組み込むことができます。
<PlayMovie: ファイル名>
<ムービーの再生: ファイル名>
ファイル名を「なし」に設定したい場合はファイル名にNone
かなし
と設定してください。
例: SampleMovie.webmを再生する場合
<PlayMovie: SampleMovie>
<ムービーの再生: SampleMovie>
「戦闘の処理」は以下の記法で組み込むことができます。
<BattleProcessing: 敵グループ>
<IfWin>
勝利した時の処理
<IfEscape>
逃走したときの処理
<IfLose>
敗北したときの処理
<End>
BattleProcessing
は戦闘の処理
でも代替できます。
また、IfWin
は勝ったとき
、IfEscape
は逃げたとき
、IfLose
は負けたとき
、End
は分岐終了
で代替できます。
敵グループは、以下の3種類の指定方法があります。
- 直接指定:
敵グループID
- 変数の指定:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
- ランダムエンカウント:
Random
,ランダム
<IfWin>
タグ、<IfEscape>
タグ、<IfLose>
タグは省略可能です。
また、これら3つをすべて省略したときに限り、<End>
タグも省略可能です。
以下に具体例を示します。
例1: 敵グループID1とエンカウント。 逃走不可, 敗北不可
<BattleProcessing: 1>
<戦闘の処理: 1>
例2: 変数ID5の敵グループとエンカウント。 逃走可, 敗北可
<BattleProcessing: Variables[5]>
<IfWin>
勝った!
<IfEscape>
逃げた!
<IfLose>
負けた!
<End>
または
<戦闘の処理: 変数[5]>
<勝ったとき>
勝った!
<逃げたとき>
逃げた!
<負けたとき>
負けた!
<分岐終了>
例3: ランダムな敵グループとエンカウント。 敗北可
<BattleProcessing: Random>
<IfWin>
勝った!
<IfLose>
負けた!
<End>
または
<戦闘の処理: ランダム>
<勝ったとき>
勝った!
<負けたとき>
負けた!
<分岐終了>
「ショップの処理」は以下のいずれかの記法で組み込むことができます。
<ShopProcessing: 購入のみ>
<Merchandise: 商品タイプ, 商品ID, 価格>
・・・以下任意の数の商品を示すタグ
ShopProcessing
は、ショップの処理
で、Merchandise
は、商品
で代替できます。
Merchandise
タグは、販売するアイテム・装備品を示すタグであり、任意の数を続けて指定できます。なしということも可能です。
購入のみリスト
- チェックオン:
Purchase Only
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
購入のみ引数は、省略が可能です。省略した場合は、チェックオフとして扱われます。
商品タイプリスト
- アイテム:
item
,0
,アイテム
- 武器:
weapon
,1
,武器
- 防具:
armor
,2
,防具
価格リスト
- 標準:
standard
,標準
- 指定: 整数値をそのまま指定
価格リストは、省略が可能です。省略した場合は、標準として扱われます。
例1: アイテムID1を標準価格に設定。購入のみではない
<ShopProcessing>
<Merchandise: Item, 1, standard>
または
<ショップの処理: オフ>
<商品: アイテム, 1, 標準>
例2: 複数の商品を設定。購入のみ 武器ID4 価格500 防具ID6 価格1200
<ShopProcessing: Purchase Only>
<Merchandise: weapon, 4, 500>
<Merchandise: armor, 6, 1200>
または
<ショップの処理: 購入のみ>
<商品: 武器, 4, 500>
<商品: 防具, 6, 1200>
「名前入力の処理」は以下のいずれかの記法で組み込むことができます。
<NameInputProcessing: アクター, 最大文字数>
<名前入力の処理: アクター, 最大文字数>
例: IDが1のアクターの名前入力を最大文字数8で行う
<NameInputProcessing: 1, 8>
<名前入力の処理: 1, 8>
「メニュー画面を開く」は以下のいずれかの記法で組み込むことができます。
<OpenMenuScreen>
<メニュー画面を開く>
「セーブ画面を開く」は以下のいずれかの記法で組み込むことができます。
<OpenSaveScreen>
<セーブ画面を開く>
「ゲームオーバー」は以下のいずれかの記法で組み込むことができます。
<GameOver>
<ゲームオーバー>
「タイトル画面に戻す」は以下のいずれかの記法で組み込むことができます。
<ReturnToTitleScreen>
<タイトル画面に戻す>
 戦闘BGMの変更 /raw.githubusercontent.com/wiki/yktsr/Text2Frame-MV/img/ex_funcs/ChangeBattleBGM.png)
戦闘BGMの変更は、以下のいずれかの記法で指定します。
<ChangeBattleBGM: ファイル名, 音量, ピッチ, 位相>
<戦闘曲の変更: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
-
例1: Battle1をデフォルト設定で演奏:
<ChangeBattleBGM: Battle1>
-
例2: Battle2を音量50, ピッチ80, 位相30で演奏:
<ChangeBattleBGM: Battle2, 50, 80, 30>
「なし」に設定したい場合は以下のいずれかの方法で指定してください。
<ChangeBattleBGM: None>
<ChangeBattleBGM: なし>
「勝利MEの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeVictoryMe: ファイル名, 音量, ピッチ, 位相>
<勝利MEの変更: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
例: 勝利MEをファイル名「Victory1.ogg」,音量90,ピッチ100,位相0に変更
<ChangeVictoryMe: Victory1, 90, 100, 0>
<勝利MEの変更: Victory1, 90, 100, 0>
<ChangeVictoryMe: Victory1>
「なし」に設定したい場合は以下のいずれかの方法で指定してください。
<ChangeVictoryMe: None>
<勝利MEの変更: なし>
「敗北MEの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeDefeatMe: ファイル名, 音量, ピッチ, 位相>
<敗北MEの変更: ファイル名, 音量, ピッチ, 位相>
必須の引数はファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
例: 敗北MEをファイル名「Defeat1.ogg」,音量90,ピッチ100,位相0に変更
<ChangeDefeatMe: Defeat1, 90, 100, 0>
<敗北MEの変更: Defeat1, 90, 100, 0>
「なし」に設定したい場合は以下のいずれかの方法で指定してください。
<ChangeDefeatMe: None>
<敗北MEの変更: なし>
「乗り物BGMの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeVehicleBgm: 乗り物, ファイル名, 音量, ピッチ, 位相>
<乗り物BGMの変更: 乗り物, ファイル名, 音量, ピッチ, 位相>
必須の引数は乗り物とファイル名のみです。音量・ピッチ・位相は任意で指定します。 指定しない場合は音量は90, ピッチは100, 位相は0として組み込まれます。
乗り物リスト
- 小型船:
Boat
,0
,小型船
- 大型船:
Ship
,1
,大型船
- 飛行船:
Airship
,2
,飛行船
例: 小型船のBGMをファイル名「Ship1.ogg」,音量90,ピッチ100,位相0に変更
<ChangeVehicleBgm: boat, Ship1, 90, 100, 0>
<乗り物BGMの変更: 小型船, Ship1, 90, 100, 0>
「なし」に設定したい場合はファイル名にNone
かなし
と指定してください。
「セーブ禁止の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeSaveAccess: セーブ>
<セーブ禁止の変更: セーブ>
セーブリスト
- 禁止:
Disable
,0
,禁止
- 許可:
Enable
,1
,許可
例: セーブ禁止に変更
<ChangeSaveAccess: Disable>
<セーブ禁止の変更: 禁止>
エンカウント禁止の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeMenuAccess: セーブ>
<メニュー禁止の変更: セーブ>
セーブリスト
- 禁止:
Disable
,0
,禁止
- 許可:
Enable
,1
,許可
例: メニュー禁止に変更
<ChangeMenuAccess: Disable>
<メニュー禁止の変更: 禁止>
「エンカウント禁止の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeEncounter: セーブ>
<エンカウント禁止の変更: セーブ>
セーブリスト
- 禁止:
Disable
,0
,禁止
- 許可:
Enable
,1
,許可
例: エンカウント禁止に変更
<ChangeEncounter: Disable>
<エンカウント禁止の変更: 禁止>
「並び変え禁止の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeFormationAccess: セーブ>
<並び変え禁止の変更: セーブ>
セーブリスト
- 禁止:
Disable
,0
,禁止
- 許可:
Enable
,1
,許可
例: 並び変え禁止に変更
<ChangeFormationAccess: Disable>
<並び変え禁止の変更: 禁止>
「ウィンドウカラーの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeWindowColor: 赤, 緑, 青>
<ウィンドウカラーの変更: 赤, 緑, 青>
例: ウィンドウカラーを赤-255,緑100,青150に変更
<ChangeWindowColor: -255, 100, 150>
<ウィンドウカラーの変更: -255, 100, 150>
「アクターの画像変更」は以下のいずれかの記法で組み込むことができます。
<ChangeActorImages: アクターID, 顔のファイル名, 顔のID, 歩行キャラのファイル名, 歩行キャラのID, 戦闘キャラのファイル名>
<アクターの画像変更: アクターID, 顔のファイル名, 顔のID, 歩行キャラのファイル名, 歩行キャラのID, 戦闘キャラのファイル名>
例: IDが1のアクターの画像を以下に変更
・「Actor1.png」の2番目の顔
・「Actor2.png」の4番目の歩行キャラ
・「Actor1_1.png」の戦闘キャラ
<ChangeActorImages: 1, Actor1, 2, Actor2, 4, Actor1_1>
<アクターの画像変更: 1, Actor1, 2, Actor2, 4, Actor1_1>
各ファイル名で「なし」に設定したい場合は、当該引数をNone
かなし
と記述してください。
「なし」に設定した場合、画像のID引数は無視されます。迷う場合は0
を入力してください。
「乗り物の画像変更」は以下のいずれかの記法で組み込むことができます。
<ChangeVehicleImage: 乗り物, 乗り物のファイル名, 乗り物のID>
<乗り物の画像変更: 乗り物, 乗り物のファイル名, 乗り物のID>
乗り物リスト
- 小型船:
Boat
,0
,小型船
- 大型船:
Ship
,1
,大型船
- 飛行船:
Airship
,2
,飛行船
例: 小型船の画像を「Vehicle.png」の5番目に変更
<ChangeVehicleImage: boat, Vehicle, 5>
<乗り物の画像変更: 小型船, Vehicle, 5>
「なし」に設定したい場合は、乗り物のファイル名ををNone
かなし
と記述してください。
乗り物のIDは省略可能です。省略した場合0
が代入されます。
「マップ名表示の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeMapNameDisplay: マップ名表示>
<マップ名表示の変更: マップ名表示>
マップ名表示リスト
- ラジオボタンオン:
true
,0
,オン
,ON
- ラジオボタンオフ:
false
,1
,オフ
,OFF
例: マップ名表示をONに変更
<ChangeMapNameDisplay: ON>
<マップ名表示の変更: オン>
「タイルセットの変更」は以下のいずれかの記法で組み込むことができます。
<ChangeTileset: タイルセットID>
<タイルセットの変更: タイルセットID>
例: IDが1のタイルセットに変更
<ChangeTileset: 1>
<タイルセットの変更: 1>
「戦闘背景の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeBattleBackGround: 戦闘背景1, 戦闘背景2>
<戦闘背景の変更: 戦闘背景1, 戦闘背景2>
例: 戦闘背景1(下半分)を「Desert.png」,戦闘背景2(上半分)を「Cliff.png」に戦闘背景を変更する
<ChangeBattleBackGround: Desert, Cliff>
<戦闘背景の変更: Desert, Cliff>
それぞれの戦闘背景を「なし」に設定したい場合は、None
かなし
と記述してください。
「遠景の変更」は以下のいずれかの記法で組み込むことができます。
<ChangeParallax: 遠景画像ファイル名, オプション1, オプション2>
<遠景の変更: 遠景画像ファイル名, オプション1, オプション2>
オプション1とオプション2は遠景をループさせたい時に任意で設定する引数であり、省略が可能です。 両方を省略した場合、横方向と盾方向のどちらもループしません。
横方向にループさせたい場合は、以下のいずれかの記法でオプション1もしくはオプション2に記述してください。
LoopHorizontally[スクロール速度]
横方向にループする[スクロール速度]
スクロール速度は、-32
~32
の整数を入力してください。
盾方向にループさせたい場合は、以下のいずれかの記法でオプション1もしくはオプション2に記述してください。
LoopVertically[スクロール速度]
縦方向にループする[スクロール速度]
スクロール速度は、-32
~32
の整数を入力してください。
例1: 遠景背景を「BlueSky.png」に変更する。ループはしない
<ChangeParallax: BlueSky>
<遠景の変更: BlueSky>
例2: 遠景背景を「BlueSky.png」に変更する。 横方向にスクロール速度10 縦方向にスクロール速度-25
<ChangeParallax: BlueSky, LoopHorizontally[10], LoopVertically[-25]>
<遠景の変更: BlueSky, 横方向にループする[10], 縦方向にループする[-25]>
遠景画像ファイル名を「なし」に設定したい場合は、None
かなし
と記述してください。
「指定位置の情報取得」は以下のいずれかの記法で組み込むことができます。
<GetLocationInfo: 変数ID, 情報タイプ, 位置>
<指定位置の情報取得: 変数ID, 情報タイプ, 位置>
情報タイプリスト
- 地形タグ:
Terrain Tag
,地形タグ
,0
- イベントID:
Event ID
,イベントID
,1
- レイヤー1:
Layer 1
,レイヤー1
,2
- レイヤー2:
Layer 2
,レイヤー2
,3
- レイヤー3:
Layer 3
,レイヤー3
,4
- レイヤー4:
Layer 4
,レイヤー4
,5
- リージョンID:
Region ID
,リージョンID
,6
位置
は、以下の記法で組み込みます。
- 直接指定: 以下のいずれか
Direct[X座標][Y座標]
直接指定[X座標][Y座標]
- 変数で指定: 以下のいずれか
WithVariables[X座標を指定する変数のID][Y座標を指定する変数のID]
変数で指定[X座標を指定する変数のID][Y座標を指定する変数のID]
- キャラクターで指定: 以下のいずれか
Character[イベントID]
キャラクター[イベントID]
キャラクターで指定する場合のイベントIDリスト
- プレイヤー:
Player
,プレイヤー
,-1
- このイベント:
This Event
,このイベント
,0
- イベントIDで指定:
1以上の整数
なお、キャラクターで指定するのはツクールMZのみの機能です。
例1: 変数1に、現在のマップのX座標10,Y座標20の地形タグの値を保存する
<GetLocationInfo: 1, Terrain Tag, Direct[10][20]>
<指定位置の情報取得: 1, 地形タグ, 直接指定[10][20]>
例2: 変数2に、現在のマップのX座標を変数4で、Y座標を5で指定しレイヤー1のタイルIDを保存する。
<GetLocationInfo: 2, Layer 1, WithVariables[4][5]>
<指定位置の情報取得: 2, レイヤー1, 変数で指定[4][5]>
例3: 変数3に、このイベントのリージョンIDの値を保存する
<GetLocationInfo: 3, Region ID, Character[This Event]>
<指定位置の情報取得: 3, リージョンID, キャラクター[このイベント]>
「敵キャラのHP増減」は以下のいずれかの記法で組み込むことができます。
<ChangeEnemyHp: 敵キャラ, 操作, オペランド, 戦闘不能を許可>
<敵キャラのHP増減: 敵キャラ, 操作, オペランド, 戦闘不能を許可>
敵キャラリスト
- 敵グループ全体:
Entire Troop
,敵グループ全体
- #1~#8:
1
~8
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
戦闘不能を許可リスト
- チェックオン:
Allow Knockout
,戦闘不能を許可
,true
,1
,オン
,ON
- チェックオフ:
false
,0
,オフ
,OFF
, 省略
例1: #1の敵のHPを10増やす
<ChangeEnemyHp: 1, Increase, 10>
<敵キャラのHP増減: 1, 増やす, 10>
<ChangeEnemyHp: 1, +, 10>
例2: 敵グループ全体のHPを変数20の値分減らす。戦闘不能を許可
<ChangeEnemyHp: Entire Troop, Decrease, Variables[20], Allow Knockout>
<敵キャラのHP増減: 敵グループ全体, 減らす, 変数[20], 戦闘不能を許可>
<ChangeEnemyHp: Entire Troop, -, V[20], true>
「敵キャラのMP増減」は以下のいずれかの記法で組み込むことができます。
<ChangeEnemyMp: 敵キャラ, 操作, オペランド>
<敵キャラのMP増減: 敵キャラ, 操作, オペランド>
敵キャラリスト
- 敵グループ全体:
Entire Troop
,敵グループ全体
- #1~#8:
1
~8
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: #1の敵のMPを10増やす
<ChangeEnemyMp: 1, Increase, 10>
<敵キャラのMP増減: 1, 増やす, 10>
<ChangeEnemyMp: 1, +, 10>
例2: 敵グループ全体のMPを20減らす
<ChangeEnemyMp: Entire Troop, Decrease, Variables[20]>
<敵キャラのMP増減: 敵グループ全体, 減らす, 変数[20]>
<ChangeEnemyMp: Entire Troop, -, V[20]>
「敵キャラのTP増減」は以下のいずれかの記法で組み込むことができます。
<ChangeEnemyTp: 敵キャラ, 操作, オペランド>
<敵キャラのTP増減: 敵キャラ, 操作, オペランド>
敵キャラリスト
- 敵グループ全体:
Entire Troop
,敵グループ全体
- #1~#8:
1
~8
操作リスト
- 増やす:
Increase
,+
,増やす
- 減らす:
Decrease
,-
,減らす
オペランドリスト
- 定数:
1以上の整数
- 変数:
Variables[変数ID]
,変数[変数ID]
,V[変数ID]
例1: #1の敵のTPを10増やす
<ChangeEnemyTp: 1, Increase, 10>
<敵キャラのTP増減: 1, 増やす, 10>
<ChangeEnemyTp: 1, +, 10>
例2: 敵グループ全体のTPを20減らす
<ChangeEnemyTp: Entire Troop, Decrease, Variables[20]>
<敵キャラのTP増減: 敵グループ全体, 減らす, 変数[20]>
<ChangeEnemyTp: Entire Troop, -, V[20]>
「敵キャラのステート変更」は以下のいずれかの記法で組み込むことができます。
<ChangeEnemyState: 敵キャラ, 操作, ステートID>
<敵キャラのステート変更: 敵キャラ, 操作, ステートID>
敵キャラリスト
- 敵グループ全体:
Entire Troop
,敵グループ全体
- #1~#8:
1
~8
操作リスト
- 付加:
Add
,+
,付加
- 解除:
Remove
,-
,解除
例1: #1の敵にIDが4のステートを付加する
<ChangeEnemyState: 1, Add, 4>
<敵キャラのステート変更: 1, 付加, 4>
<ChangeEnemyState: 1, +, 4>
例2: 敵グループ全体のIDが4のステートを解除する
<ChangeEnemyState: Entire Troop, Remove, 6>
<敵キャラのステート変更: 敵グループ全体, 解除, 6>
<ChangeEnemyState: Entire Troop, -, 6>
「敵キャラの全回復」は以下のいずれかの記法で組み込むことができます。
<EnemyRecoverAll: 敵キャラ>
<敵キャラの全回復: 敵キャラ>
敵キャラリスト
- 敵グループ全体:
Entire Troop
,敵グループ全体
- #1~#8:
1
~8
例1: #1の敵キャラを全回復
<EnemyRecoverAll: 1>
<敵キャラの全回復: 1>
例2: すべての敵キャラを全回復
<EnemyRecoverAll: Entire Troop>
<敵キャラの全回復: 敵グループ全体>
「敵キャラの全回復」は以下のいずれかの記法で組み込むことができます。
<EnemyAppear: 敵キャラ>
<敵キャラの出現: 敵キャラ>
敵キャラリスト
- #1~#8:
1
~8
例: #1の敵を出現
<EnemyAppear: 1>
<敵キャラの出現: 1>
「敵キャラの変身」は以下のいずれかの記法で組み込むことができます。
<EnemyTransform: 敵キャラ, エネミーID>
<敵キャラの変身: 敵キャラ, エネミーID>
敵キャラリスト
- #1~#8:
1
~8
例: #1の敵をIDが2のエネミーに変身
<EnemyTransform: 1, 2>
<敵キャラの変身: 1, 2>
「戦闘アニメーションの表示」は以下のいずれかの記法で組み込むことができます。
<ShowBattleAnimation: 敵キャラ, アニメーションID>
<戦闘アニメーションの表示: 敵キャラ, アニメーションID>
敵キャラリスト
- 敵グループ全体:
Entire Troop
,敵グループ全体
- #1~#8:
1
,2
, ~8
例1: #1の敵にIDが2のアニメーションを表示
<ShowBattleAnimation: 1, 2>
<戦闘アニメーションの表示: 1, 2>
例2: 敵グループ全体にIDが2のアニメーションを表示
<ShowBattleAnimation: Entire Troop, 2>
<戦闘アニメーションの表示: 敵グループ全体, 2>
「戦闘行動の強制」は以下のいずれかの記法で組み込むことができます。
<ForceAction: 行動主体, スキルID, 対象>
<戦闘行動の強制: 行動主体, スキルID, 対象>
行動主体リスト
- 敵#1~#8:
1
~8
- アクター:
Actors[アクターID]
,アクター[アクターID]
対象リスト
- ラストターゲット:
Last Target
,-1
,ラストターゲット
- ランダム:
Random
,0
,ランダム
- インデックス1:
Index 1
,1
,インデックス1
- インデックス2:
Index 2
,2
,インデックス2
- インデックス3:
Index 3
,3
,インデックス3
- インデックス4:
Index 4
,4
,インデックス4
- インデックス5:
Index 5
,5
,インデックス5
- インデックス6:
Index 6
,6
,インデックス6
- インデックス7:
Index 7
,7
,インデックス7
- インデックス8:
Index 8
,8
,インデックス8
例1: #1の敵にIDが2のスキルを、インデックス3を対象に強制する
<ForceAction: 1, 2, Index 3>
<戦闘行動の強制: 1, 2, インデックス3>
例2: IDが4のアクターにIDが7のスキルをラストターゲットを対象に強制する
<ForceAction: Actors[4], 7, Last Target>
<戦闘行動の強制: アクター[4], 7, ラストターゲット>
例3: IDが10のアクターにIDが20のスキルをランダムなターゲットを対象に強制する
<ForceAction: Actors[10], 20, Random>
<戦闘行動の強制: アクター[10], 20, ランダム>
「バトルの中断」は以下のいずれかの記法で組み込むことができます。
<AbortBattle>
<バトルの中断>
スクリプトのイベントコマンドは、以下のように<script>
と</script>
で挟み込む記法で指定します。
<script>
処理させたいスクリプト
</script>
例えば以下のとおりです。
<script>
for(let i = 0; i < 10; i++) {
console.log("今日も一日がんばるぞい!");
}
</script>
このようにテキストファイル中に記載することで、console.log("今日も一日がんばるぞい!");
という内容のスクリプト
のイベントコマンドが組み込まれます。
ツクールMVのエディタ上からは12行を超えるスクリプトは記述出来ませんが、
本プラグインの機能では13行以上のスクリプトも組み込めます。
ただし、ツクールMV上から一度開いて保存してしまうと、13行目以降はロストしてしまいます。
別記法として<SC>
か、<スクリプト>
としても記述できます。
また、
<script>console.log("今日も一日がんばるぞい!");</script>
というように1行で記述することもできます。
プラグインコマンドのイベントコマンドは、以下のいずれかの記法で指定します。
<plugincommand: プラグインコマンドの内容>
<PC: プラグインコマンドの内容>
<プラグインコマンド: プラグインコマンドの内容>
例えば以下のように記述すると、ItemBook openと入ったプラグインコマンドが 組み込まれます。
<plugincommand: ItemBook open>
<PC: ItemBook open>
<プラグインコマンド: ItemBook open>
プラグインコマンドのイベントコマンドは、以下の記法で指定します。
<PluginCommandMZ: プラグイン名, 内部関数名, コマンド名, 引数の名前[値][注釈(任意)],...>`
プラグイン名はプラグインファイルの名前です。○○.jsの○○を記入してください。
Text2Frame.jsの場合はText2Frame
となります。
内部関数名はプラグイン内で設定されている関数名を指定してください。 ただし、対応しているプラグイン本体であるJavascriptファイルかdataフォルダ内のJSONファイルから直接確認する必要がある可能性が高いです。 そのため、このタグはある程度プラグインを開発する能力がある方向けとなります。
コマンド名はプラグインコマンド設定ウィンドウで、呼び出すコマンドの名前を記述してください。
プラグインコマンドのパラメータは、コマンド名以降にカンマ区切りで引数の名前[値]
として記述してください。
数に制限はありません。
例えば、引数の名前がFileFolder
, 値がtext
の場合はFileFolder[text]
と記述してください。
引数の名前は、「プラグインコマンド」ウィンドウの、指定したい引数の「パラメータ」ウィンドウから確認できます。
薄い灰色文字で書かれた括弧書きされている文字が引数の名前です。
注釈は、ツクールMZ上での表示を正式なものにするために使います。
指定しない場合は、自動で補完します。実行上の違いはありませんが、ツクールMZ上から設定した場合の表記とは異なります。
PluginCommandMZ
はPCZ
,プラグインコマンドMZ
でも代替できます。
例えば、Text2Frameのプラグインコマンドを例にすると以下のように記述します。 textフォルダのmessage.txtの内容をマップID1, イベントID2, ページID3に上書きせずに書き込むプラグインコマンドです。
<PluginCommandMZ: Text2Frame, IMPORT_MESSAGE_TO_EVENT, イベントにインポート, FileFolder[text], FileName[message.txt], MapID[1], EventID[2], PageID[3], IsOverwrite[false]>
引数の値として、基本的には以下の5つを入力することが可能です。
- 数値:
例えば
-1
,0
,1
,1.1
,2
,... - 文字列:
例えば
今日も一日がんばるぞい!
- ブーリアン:
例えば
true
orfalse
(他のタグにあるようなONやOFFのような代替記法はありません) - 配列:
例えば
[1, 2, 3]
や["a", "b", "c", "d"]
- オブジェクト:
例えば
{"a": 1, "b": "hoge"}
このうち、配列とオブジェクトのみ、JSONの記法に乗っ取って記入します。 例えば、以下の通りです。
- 例1: 引数array_argの値に文字列の配列を設定 :
array_arg[["今日も", "一日", "がんばるぞい!"]]
- 例2: 引数struct_arg の値に
{"a": 1, "b": "hoge"}
:struct_arg[{"a": 1, "b": "hoge"}]