戦闘関数

戦闘関数は戦闘時のみ使用できる関数です。マップ中などでは使用できません

関数一覧

BtlCharaHP	戦闘キャラのHPを取得・設定する
BtlCharaMaxHP	戦闘キャラの最大HPを取得する
BtlCharaSP	戦闘キャラのSPを取得・設定する
BtlCharaMaxSP	戦闘キャラの最大SPを取得する
BtlCharaEP	戦闘キャラのEPを取得・設定する
BtlAddStatus	戦闘キャラにステータス効果を付与する
BtlHasStatus	戦闘キャラが指定したステータス効果を持っているかを確認する
BtlRemoveStatus	戦闘キャラのステータス効果を解除する
BtlShowChara	戦闘キャラを表示する
BtlHideChara	戦闘キャラを非表示にする
BtlShowParam	戦闘キャラのパラメータを表示する
BtlHideParam	戦闘キャラのパラメータを非表示にする
BtlShowMsgWnd	戦闘メッセージウィンドウを表示する
BtlHideMsgWnd	戦闘メッセージウィンドウを非表示にする
BtlMiniGame	戦闘内ミニゲームを開始する

関数詳細

BtlCharaHP()

機能

戦闘キャラのHPを取得します。hp を指定した場合はその値を設定します

書式

int BtlCharaHP( btlChara, hp, message, popup )

引数

引数

型

省略

規定値

詳細

btlChara

列挙型

―

戦闘キャラを示す以下のいずれかの列挙子

整数

◯

現在値

message

文字列

◯

null

表示メッセージ。不要な場合は null を設定してください。メッセージは以下の複合書式指定が使用できます

0	キャラクター名 (表示名)
1	HPの変化量
2	設定後のHP

popup

文字列

◯

null

ポップアップ文。不要な場合は null を設定してください。ポップアップ文には以下の複合書式指定が使用できます

0	キャラクター名 (表示名)
1	HPの変化量
2	設定後のHP

戻り値

戦闘キャラのHP

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlCharaMaxHP()

機能

戦闘キャラの最大HPを取得します

書式

int BtlCharaMaxHP( btlChara )

引数

引数	型	省略	規定値	詳細
btlChara	列挙型	×	―	戦闘キャラを示す以下のいずれかの列挙子

戻り値

戦闘キャラの最大HP

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlCharaSP()

機能

戦闘キャラのSPを取得します。sp を指定した場合はその値を設定します

書式

int BtlCharaSP( btlChara, sp, message, popup )

引数

引数

型

省略

規定値

詳細

btlChara

列挙型

―

戦闘キャラを示す以下のいずれかの列挙子

整数

◯

現在値

message

文字列

◯

null

表示メッセージ。不要な場合は null を設定してください。メッセージは以下の複合書式指定が使用できます

0	キャラクター名 (表示名)
1	SPの変化量
2	設定後のSP

popup

文字列

◯

null

ポップアップ文。不要な場合は null を設定してください。ポップアップ文には以下の複合書式指定が使用できます

0	キャラクター名 (表示名)
1	SPの変化量
2	設定後のSP

戻り値

戦闘キャラのSP

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlCharaMaxSP()

機能

戦闘キャラの最大SPを取得します

書式

int BtlCharaMaxSP( btlChara )

引数

引数	型	省略	規定値	詳細
btlChara	列挙型	×	―	戦闘キャラを示す以下のいずれかの列挙子

戻り値

戦闘キャラの最大SP

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlCharaEP()

機能

戦闘キャラのEPを取得します。ep を指定した場合はその値を設定します

書式

int BtlCharaEP()

引数

引数

型

省略

規定値

詳細

btlChara

列挙型

―

戦闘キャラを示す以下のいずれかの列挙子

整数

◯

現在値

message

文字列

◯

null

表示メッセージ。不要な場合は null を設定してください。メッセージは以下の複合書式指定が使用できます

0	キャラクター名 (表示名)
1	EPの変化量
2	設定後のEP

popup

文字列

◯

null

ポップアップ文。不要な場合は null を設定してください。ポップアップ文には以下の複合書式指定が使用できます

0	キャラクター名 (表示名)
1	EPの変化量
2	設定後のEP

戻り値

戦闘キャラのEP

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlAddStatus()

機能

戦闘キャラにステータス効果を付与します

書式

void BtlAddStatus( btlChara, statusId )

引数

引数	型	省略	規定値	詳細
btlChara	列挙型	×	―	戦闘キャラを示す以下のいずれかの列挙子
statusId	文字列	×	―	ステータスID

戻り値

なし

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlHasStatus()

機能

戦闘キャラが指定したステータス効果を持っているかを確認します

書式

bool BtlHasStatus( btlChara, statusId )

引数

引数	型	省略	規定値	詳細
btlChara	列挙型	×	―	戦闘キャラを示す以下のいずれかの列挙子
statusId	文字列	×	―	ステータスID

戻り値

ステータスを付与されている場合は true を返す

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlRemoveStatus()

機能

戦闘キャラのステータス効果を解除します

書式

void BtlRemoveStatus( btlChara, statusId )

引数

引数	型	省略	規定値	詳細
btlChara	列挙型	×	―	戦闘キャラを示す以下のいずれかの列挙子
statusId	文字列	×	―	ステータスID

戻り値

なし

列挙型

戦闘キャラ

列挙子	説明
Player	プレーヤー
Assistant	アシスタント
Enemy	敵

BtlShowChara()

機能: 戦闘キャラを表示します
書式: void BtlShowChara()
引数: なし
戻り値: なし

BtlHideChara()

機能: 戦闘キャラを非表示にします
書式: void BtlHideChara()
引数: なし
戻り値: なし

BtlShowParam()

機能: 戦闘キャラのパラメータを表示します
書式: void BtlShowParam()
引数: なし
戻り値: なし

BtlHideParam()

機能: 戦闘キャラのパラメータを非表示にします
書式: void BtlHideParam()
引数: なし
戻り値: なし

BtlShowMsgWnd()

機能: 戦闘メッセージウィンドウを表示します
書式: void BtlShowMsgWnd()
引数: なし
戻り値: なし

BtlHideMsgWnd()

機能: 戦闘メッセージウィンドウを非表示にします
書式: void BtlHideMsgWnd()
引数: なし
戻り値: なし

BtlMiniGame()

機能

戦闘内ミニゲームを開始します。ミニゲームの成敗は $mgResult 変数で取得することが出来ます。
この関数はミニゲームが終了するまで待機する点に注意してください (ショップが閉じられるまで次の命令は実行されません)

書式

void BtlMiniGame( barRange, speed, count )

引数

引数	型	省略	規定値	詳細
barRange	実数	◯	0.5	成功エリアの範囲 (0.0～1.0)
speed	実数	◯	1.0	マーカーの移動速度 (秒間ループ回数)
count	整数	◯	8	ループ回数

戻り値

なし