暫定版
このセクションのAPIは変更される可能性があります。
CWLには, 内蔵された一連のスクリプト拡張メソッドが付属しています。ここでコードを確認できます。
Dialog.ExpandedActions 設定を有効にする必要があります。デフォルトで有効になっています。
ストーリーテーブルでは, CWLの特別なアクション invoke* / i* を使用して拡張メソッドを呼び出すことができます： 
パラメータ渡し
カンマ区切りで指定：
| action | param | actor |
|---|---|---|
invoke*/i* | honk_honk(arg1, arg2) | pc |
actor 列はターゲットキャラ(pc tg または任意のキャラid)を示します。
jump 列が存在する場合, 拡張メソッドの戻り値が true ならジャンプを実行します。
数値式: +5, *10, =69, !=114 などは, 判定または代入に使用される表現です。
アクション
| メソッド | パラメータ | 説明 | ジャンプ条件 |
|---|---|---|---|
add_item | アイテムid, 素材エイリアス(省略可)(省略可), レベル(省略可), 数量(省略可) | actorに指定されたアイテムを追加します。デフォルトはランダムな素材, 自動レベル, 数量は 1 | 常時 |
equip_item | アイテムid, 材質エイリアス(省略可), レベル(省略可) | actorに指定された物品を装備させる。デフォルトはランダムな材質、レベルは自動 | 常時 |
join_party | actorをパーティに参加させます | 常時 | |
join_faith | 信仰id(省略可) | actorを信仰に参加させます。空の場合は現在の信仰から退出します | 成功時 |
apply_condition | 状態alias, 強度 | actorに状態を適用します | 常時 |
cure_condition | 状態alias | actorの状態を治癒します | 成功時 |
remove_condition | 状態alias | actorから状態を削除します | 常時 |
build_ext | アセンブリ名 | 指定されたアセンブリ内のメソッドを可能な限りストーリー拡張テーブルに追加する | 成功時 |
emit_call | ext.メソッド名 | 外部の静的メソッドを呼び出す | 常時 |
build_ext と emit_call を通じて外部アセンブリメソッドを呼び出すには, Dialog.ExpandedActionsAllowExternal 設定を有効にする必要があります。デフォルトでは有効になっています。
演劇パフォーマンス
| メソッド | パラメータ | 説明 | ジャンプ条件 |
|---|---|---|---|
move_next_to | キャラid | actorを同じマップのキャラクターの隣に移動させる | 常時 |
move_tile | X, Yオフセット | actorを相対座標で移動させる。例えば 1,1 | 常時 |
move_zone | ゾーンid，階層(省略可) | actorを指定されたゾーンに転送する。デフォルトは 0 階層 | 常時 |
play_anime | アニメーションid | actorにアニメーションを実行させる | 常時 |
play_effect | エフェクトid | actorにエフェクトを再生させる | 常時 |
play_emote | 感情id | actorに感情を表示させる | 常時 |
play_screen_effect | 画面エフェクトid | 画面エフェクトを再生する | 常時 |
pop_text | テキスト | actorに叫びのテキスト(吹き出し)を発声させる | 常時 |
portrait_set | 立ち絵id(省略可) | actorの対話立ち絵を設定します。空の場合はリセットされます。Portraitフォルダーのカスタム立ち絵をサポートしています。例えば、UN_myChara_happy.pngはhappyまたはUN_myChara_happyとして使用できます。 | 常時 |
show_book | 書籍id, カテゴリー(Book または Scroll) | 本を開く。LangMod/**/Textフォルダーをサポートする。例えば Text/Book/ok.txt ならば (ok, Book) を使用 | 成功時 |
値を変更する
| メソッド | パラメータ | 説明 | ジャンプ条件 |
|---|---|---|---|
mod_affinity | 数値式(例: +5) | actorの好感度を調整 | 成功時 |
mod_currency | 通貨の種類, 数値式 | 指定された通貨をactorに変更します。money money2 plat medal influence casino_coin ecopo | 常時 |
mod_element | 元素alias, 強度(省略可) | actorの指定された要素(特性/抵抗/スキルなど)を変更し, デフォルトの強度は1であり, 異なるタイプの要素には異なる強度が使用される | 常時 |
mod_element_exp | 元素alias, 数値式 | actorの指定された要素の経験値を変更する | 成功時 |
mod_fame | 数値式 | プレイヤーの名声を変更します | 常時 |
mod_flag | flag, 数値式 | actorのflag値を変更 | 常時 |
mod_keyitem | キーアイテムid, 値式(省略可) | プレイヤーの重要アイテムの値を変更します。デフォルトは =1 | 成功時 |
条件
これらも拡張メソッド(invoke* アクションを通じて呼び出される)ですが, それらの戻り値は jump ジャンプの判定に使用できます。
| メソッド | パラメータ | 説明 | ジャンプ条件 |
|---|---|---|---|
if_affinity | 数値式 | actorの好感度をチェック | 条件が満たされた時 |
if_condition | 状態alias | actorが状態を持っているかチェック | 条件が満たされた時 |
if_currency | 通貨の種類, 数値式 | actorが該当する通貨を所有しているか確認します。money money2 plat medal influence casino_coin ecopo | 条件が満たされた時 |
if_element | 元素alias, 数値式 | actorが条件に合った元素を持っているか確認 | 条件が満たされた時 |
if_faith | 信仰id, レベル(省略可) | actorが特定の信仰に加入しており, 特定のレベル(デフォルトは0レベル)以上であるかを確認 | 条件が満たされた時 |
if_fame | 数値式 | プレイヤーの名声を確認します | 条件が満たされた時 |
if_flag | flag, 数値式 | actorのフラグ値をチェック | 条件が満たされた時 |
if_keyitem | キーアイテムalias, 数値式(省略可) | プレイヤーが表現に合ったキーアイテムの値を持っているかを確認する, デフォルトは >0 | 条件が満たされた時 |
if_race | 種族id | actorが対応する種族であるかを確認 | 条件が満たされた時 |
if_tag | tag | actorがタグを持っているかチェック | 条件が満たされた時 |
if_zone | エリアid, 階層数(省略可) | actorのいるエリアをチェック | 条件が満たされた時 |
三つの特別な複合条件があり, それらは上記の条件をパラメータとして使用します：
| メソッド | 例 | ジャンプ条件 |
|---|---|---|
and | and(if_flag(flag1, >0), if_flag(flag2, <0)) | 全ての条件が満たされた時 |
or | or(if_race(lich), if_race(snail)) | 任意の条件が満たされた時 |
not | not(if_zone(dungeon), if_zone(field), if_zone(underground)) | 全ての条件が満たされなかった時 |
if_flag それとも hasFlag？
if 列にある hasFlag は静的条件であり, シナリオテーブルが読み込まれるときに一度だけ判定されます。これは, その後に変更されたフラグ値が影響を与えないことを意味し, reload アクションを使用するか, シナリオテーブルを再度開くまで続きます。CWL の if_flag() 拡張条件は動的であり, シナリオ分岐にも使用できます。
カスタムメソッド実装
CWLはシンプルなAPIを提供し, 独自のスクリプトDLLに拡張メソッドを追加できます。