スクリプトリファレンス

Last-modified: 2016-12-22 (木) 06:54:30
 

スクリプト

オブジェクトに条件とアクションを指定する事で、マップに様々な変化を与えることができる。
2016/12/8のmoniters bountyアップデートによって、他オブジェクトの指定・プレイヤー特性の変更・変数の操作等、機能が大幅に強化された。

 

条件一覧

  • 条件を満たした際、スクリプトはアクションを発動する
  • 一部項目では、条件を満たす要因となったプレイヤー/オブジェクトをアクティベーターとして取得することができる
  • 一部項目では、条件を満たした全てのオブジェクトをエクストラとして取得することができる

出現時

アクティベーターなし
概要本オブジェクトが出現した際発動する
ラウンド開始時、全てのオブジェクトが再配置された際にも発動する

破壊時/消滅時

アクティベーターなし
概要本オブジェクトが破壊・消滅した際発動する

ライフ:未満

アクティベーターなし
概要本オブジェクトの体力が一定割合未満になった際発動する
体力があるオブジェクトに指定可能だが、
シールド等一部オブジェクトはライフを判定しない

メッセージ:受信時

アクティベーターアクション『メッセージ:送信』のトランスファーに指定されたオブジェクト/プレイヤー
概要指定チャンネルのメッセージが送信された際に発動する

パワー:チェック時

アクティベーターアクション『パワー:セット』のトランスファーに指定されたオブジェクト/プレイヤー
概要指定チャンネルのパワーが切り替えされた際に発動する
パワーが切り替わらない限り発動しないため、
パワーがオンの状態でパワーをオンにセットしても発動することはない

タイマー:チェック時

アクティベーターなし
概要初期遅延経過後、リピートに設定した秒数毎に発動する
スクリプトのオプションで『常に実行』をオフにした場合、再出現の度にタイマーはリセットされる

操作

アクティベーター本オブジェクトを操作・取得したプレイヤー
概要本オブジェクトを操作した際発動する
スイッチ系統は操作した際、
パワーアップ:スクリプト可能系統は取得した際に発動する

マッチ:開始時

アクティベーターなし
概要マッチが開始した際発動する
プレイヤーが動けるようになった段階でなく、イントロの開始時に発動するため注意

ラウンド:開始時

アクティベーターなし
概要ラウンド開始の度発動する
カウントダウンが終了し、プレイヤーが動けるようになったタイミングで発動する

メッセージ/パワー:マルチ

アクティベーターなし
概要指定数以上のメッセージ/パワー条件を満たした際に発動する
判定はいずれかのメッセージが送信されるか、パワーが変更された際のみ行われる

数字:チェック

アクティベーターなし
エクストラ条件を満たした全てのプレイヤー(スコープ:プレイヤーの場合のみ有効)
概要スコープで指定された変数と、チェックで指定された変数を比較し、
条件を満たした際に発動する
変数はアクション『数字:変更』で設定でき、
マップ全体で26個、プレイヤー毎に26個、チーム毎に26個、オブジェクト毎に1個設定可能

スコア:チェック

アクティベーターなし
概要本オブジェクトの所属するチームのスコアが設定値に達した際発動する
周期オプションをオンにした場合、設定値の倍数になる度発動する

ラウンド:タイム

アクティベーターなし
概要ラウンド開始から指定時間経過時に発動する
カウントダウンが終了し、プレイヤーが動けるようになったタイミングでカウントを開始する

境界:チェック

アクティベーター侵入・退出・侵入/退出の場合:
境界を最後に出入りしたオブジェクト/プレイヤー

継続的の場合:
境界内で最もオブジェクト番号が小さい(先にマップに配置された)オブジェクト/プレイヤー
エキストラ境界内の全てのオブジェクト/プレイヤー
概要本オブジェクトに設定した境界にオブジェクト/プレイヤーが干渉した際に発動する

侵入・退出・侵入/退出はオブジェクト/プレイヤーが境界を出入りした際、
継続的は境界内にオブジェクト/プレイヤーが存在する際条件を満たす

ボール・フラッグ等一部オブジェクトはフィルターをALLに設定した場合のみ反応する

一度発動した後は、周期オプションで設定された時間が経過するまで、
条件を満たしても発動しない
周期時間経過後に条件を満たした際、即座に発動する
 
 

アクション一覧

  • 一つの条件にアクションは4個まで設定できる。
  • 『オブジェクト』オプションによって、他の複数のオブジェクト/プレイヤーにもアクションを適用する事ができる。
  • アクションは上から順番に処理され、その行のアクションが完了してから次のアクションに移行する。

出現

対象オブジェクト
概要消滅している本オブジェクトを出現させる
強制オプションがオフの場合、本オブジェクトの近くにプレイヤーが存在する時オブジェクトは出現しない
本オブジェクト以外を出現させる事は出来ない

消滅

対象オブジェクト
概要マップに出現している指定オブジェクトを破壊/消滅させる

位置/回転:リセット

対象オブジェクト
概要指定オブジェクトの位置と向きを指定時間かけて、マッチ開始時の状態に戻す

メッセージ:送信

対象システム
概要指定チャンネルのメッセージを出力する
トランスファーに指定したオブジェクトを、条件『メッセージ:受信時』のアクティベーターとして使用する事ができる
指定がない場合、本オブジェクトがトランスファーに指定される

パワー:セット

対象システム
概要指定チャンネルのパワーを切替える
すでに切替先の値になっている場合、パワーは切替されない

トランスファーに指定したオブジェクトを、
条件『パワー:チェック時』のアクティベーターとして使用する事ができる
指定がない場合、本オブジェクトがトランスファーに指定される

同チャンネルのパワーが同時に切り替えされた場合、先に処理された方が優先される
アクティベーターを持つ条件によって発動された場合、次のフレームでそのチャンネルのパワーは変更されない

アニメーション:再生

対象オブジェクト
概要アニメーション可能な指定オブジェクトのアニメーションを指定位置まで再生する
デフォルトでアニメーションするオブジェクトの場合、指定位置は機能せず、停止から再生状態への移行のみ行う。

アニメーション:停止

対象オブジェクト
概要アニメーション可能な指定オブジェクトのアニメーションを停止する

ダメージ:比率

対象オブジェクト/プレイヤー
概要指定オブジェクト/プレイヤーのライフに指定比率ダメージを与える
シールドにダメージを与えることはできない

一部の破壊可能オブジェクトで機能しない

移動:オフセット

対象オブジェクト
概要指定オブジェクトを、単一の指定ターゲットにXYZ座標の補正を加えた位置まで、指定時間かけて移動する
ターゲットを『なし』にした場合、本オブジェクトがターゲットとなる
ローカルをオンにした場合、XYZ座標の補正はターゲットから見た前方/水平/垂直方向に置き換えられる

オブジェクトの位置座標は始点/根源が指定されており、プレイヤーの場合は腰付近にある

回転:オフセット

対象オブジェクト
概要指定オブジェクトを指定方向に指定時間かけて回転させる

速度:設定

対象オブジェクト
概要指定オブジェクトに指定方向への加速度を加える
物理特性をノーマルにしたオブジェクトにのみ設定できる

色:設定

対象オブジェクト
概要指定オブジェクトの色を変更する

数字:変更

対象オブジェクト/プレイヤー/システム
概要対象の変数を変更する
変数は、マップ全体で26個、プレイヤー毎に26個、チーム毎に26個、オブジェクト毎に1個設定できる

ソースには固定値以外に、他の変数、カウントで指定されたオブジェクトの個数、
ライフ値やスコア等ゲーム内の値を指定する事ができる。

特性:適用

対象プレイヤー
概要対象のプレイヤーにゲームモード『ミニゲーム』のオプションで設定した特性を設定する

特性:クリア

対象プレイヤー
概要対象のプレイヤーの特性をルールのデフォルトの状態に戻す

ウェイト

対象システム
概要指定時間ウェイトを入れ、次の行のアクションの開始を遅らせる

スコア:変更

対象プレイヤー/システム
概要対象の所属するチームまたはプレイヤーのスコアを設定する

ラウンド:終了

対象システム
概要強制的にそのラウンドを終了する

スクリーン効果:セット

対象プレイヤー
概要対象のプレイヤーの画面に任意のFX/フィルターを適用する

スイッチ:操作

対象オブジェクト
概要操作可能な指定オブジェクトを操作不可にする

サウンド:再生

対象プレイヤー
概要対象のプレイヤーに対して任意のサウンドを再生する。

物理特性:セット

対象プレイヤー
概要対象のオブジェクトの物理特性を変更する

ナビマーカー:変更

対象オブジェクト/プレイヤー
概要対象のオブジェクト/プレイヤーに、指定したプレイヤーからのみ見えるマーカーをセットする
すでにマーカーが設定されているオブジェクトに再度設定した場合、マーカーは上書きされる

出現順序:変更

対象オブジェクト/プレイヤー
概要対象のオブジェクト/プレイヤーの出現順序を変更する
プレイヤーに設定した場合、設定した数値未満の出現地点からは出現しなくなる

ラベル:変更

対象オブジェクト/プレイヤー
概要対象のオブジェクト/プレイヤーのラベルを追加/削除する
 
 

スクリプトオプション

  • スクリプト一つ毎に設定できる。オンオフで特定状況での処理を行うかの選択が可能
     
条件割り込みオンの場合、アクション処理中に再度スクリプトの条件を満たしたとき、アクション処理をキャンセルして最初の行から処理を行う
オフの場合、アクション処理中は条件を満たしても処理は行わない
ラウンド割り込みオンの場合、ラウンド終了時にアクション処理をキャンセルする
常に実行オンの場合、オブジェクトが消滅していても条件・アクションの処理を行う
オフの場合、オブジェクトが消滅している間は処理を行わない
enabledオンの場合、このスクリプトを有効にする
 
 

オブジェクトの指定

  • ほとんどのアクションは、適用オブジェクトのリストを作ることで、他の複数のオブジェクト/プレイヤーにも効果を適用できる
  • modに条件を指定することで、上から順番にリストへの追加または除外を行うことができる
     
    例えばチーム1のプレイヤーのみを選択したい場合、
    mod1:プレイヤー
    mod2:チーム[含む] チーム1[防衛側]
    と指定すればいい
    『チーム[含む]』はリストから除外する処理のため、mod1でプレイヤー全体をリストに入れておく必要があることに注意
     
アクティベーター[追加]起動者(発動者)。条件を満たす原因となった単一のオブジェクト/プレイヤーをリストに加える
modに指定する事でオブジェクトの操作を行ったプレイヤーや、範囲に最後に入ったプレイヤー等を特定できる
エキストラ[追加]条件を満たした複数のオブジェクト/プレイヤーをリストに加える
modに指定する事で、範囲内にあるオブジェクトや、
特定の変数値を持つ全てのプレイヤーを特定できる
数値[含む]系統特定の変数値を持つオブジェクト/プレイヤー以外をリストから除外する
プレイヤーの場合はチャンネル:アルファの変数で判定される