コンテンツにスキップ

コマンドリファレンス

VNStudio 0.92.0-beta のスクリプトコマンドの一覧です。書き方の基本は スクリプトの基本構文、ランタイムごとの対応状況は ランタイム対応表 を参照してください。

テキスト・待機

コマンド 説明
say [名前] "テキスト" メッセージを表示し、クリックまたはオートモードの待機後に次へ進みます。
wait <秒数> 指定した秒数だけ待機します。
wait input 決定キーまたはクリック入力があるまで待機します。
clear 背景、立ち絵、メッセージ、ui_anim などの表示をクリアします。
end 現在のスクリプト実行を終了します。

背景

コマンド 説明
bg <画像名> 最背面の背景レイヤーに画像を表示します。
bg1 <画像名> 指定した背景レイヤー (1〜3) に画像を重ねて表示します。
bg_scroll <bg0|bg1> <画像名> <scale> <up|down|left|right> <秒数> 背景を指定倍率で表示し、指定方向へ非同期でスクロールします。

キャラクター

コマンド 説明
show <キャラID> <差分...> [x] [y] [scale] キャラクターを表示、または表情差分を変更します。
hide <キャラID> キャラクター、または ui_anim の表示を消します。
move <キャラID> <x> <y> <秒数> [ease] キャラクターを指定位置へ移動します。

画面演出

コマンド 説明
fade <in|out> [対象] [秒数] 画面、テキストウィンドウ、背景レイヤー、立ち絵をフェードします。
white <in|out> [秒数] 白からのフェードイン/白へのフェードアウトを行います。
shake screen <秒数> 画面を指定時間揺らします。
ui_anim <画像名> <X> <Y> <scale> [mode] [秒数] 画像または文字を UI レイヤーに表示し、アニメーションさせます。

サウンド

コマンド 説明
bgm play <曲名> Resources/Audio/BGM のサンプリング音源 (mp3 / ogg / wav) を BGM として再生・停止します。
se play <音名> Resources/Audio/SE の効果音を再生します。
voice play <キャラ名> <音名> [音量0〜100] キャラクター別のボイスを再生します。
fm play <MMLファイル名> [opna|opll] Resources/Audio/BGM の MML を FM 音源でループ再生・停止します。

フロー制御・変数

コマンド 説明
label <名前> ジャンプ先のラベルを定義します。
jump <ラベル名> 指定したラベルへ移動します。
call <ファイル名> 別スクリプトを呼び出し、return で呼び出し元へ戻ります。
int <変数> = <式> 整数変数を宣言・代入・加算します。
if <変数> <演算子> <値> <ラベル> 条件が成立したときに指定ラベルへ移動します。
switch <変数> 変数の値と一致する case へ分岐します。

選択肢

コマンド 説明
choice 縦並びの選択肢を表示し、選ばれた項目のラベルへ移動します。
ui_choice 座標・文字サイズ・色を指定できる選択肢を表示します。

セーブ・メニュー・CG

コマンド 説明
save <スロット> 指定スロットへセーブ、または指定スロットからロードします。
savegrid [列] [行] セーブまたはロード画面を表示します。
settingsmenu オートモード、文字速度、音量などの共通設定画面を表示します。
menu exit メニューを閉じ、呼び出し元へ戻ります。
cg<番号> "<表示テキスト>" <画像名> CG スロットを登録、解放 (攻略済み)、または未解放に設定します。
call cgmode 登録済み CG の一覧 (CG ギャラリー) を表示します。
call savemode 組み込みのセーブ画面またはロード画面を呼び出します。
setactive <on|off> textwindow テキストウィンドウの表示・非表示を切り替えます。
menuwindow bg <画像名> [フェード秒数] カスタムメニュー画面の背景や表示状態を制御します。
sysmenu <on|off> システムメニューボタン、オートモードボタンの表示を切り替えます。

設定 (config)

コマンド 説明
config text font <フォント名> メッセージと選択肢のフォントを変更します。
config text size <サイズ> メッセージと選択肢の文字サイズを変更します。
config text speed <秒数> 1 文字あたりの表示時間を設定します。
config text wait <秒数> オートモード時の読み終わり待機時間を設定します。
config text color <#RRGGBB> 本文と選択肢の既定の文字色を設定します。
config char_text size <サイズ> キャラクター名の文字サイズを変更します。
config textwindow image <画像名> [alpha] Resources/UI の画像をテキストウィンドウの背景に設定します。
config textwindow mode <0〜3> テキストウィンドウの角丸と枠線のスタイルを設定します。
config choicewindow <画像名> <alpha> 選択肢ウィンドウの背景画像と透明度を設定します。
config menuwindow <画像名> [alpha] システムメニュー画面の背景画像を設定します。
config uisound <choice|choiceshow|textskip|textadvance> <SE名> 選択肢やテキスト操作のときに鳴らす効果音を設定します。
config automode <on|off> メッセージ表示後の自動進行を切り替えます。
config volume <bgm|se|voice|fm|system> <0〜100> 音声カテゴリごとの音量を設定します。
config background color <#RRGGBB> 背景がない部分の色を設定します。
config fullscreen <on|off> フルスクリーン表示の切り替えと、ウィンドウサイズの指定を行います。
config savedata slots <数> 使用するセーブスロット数を設定します (既定 100)。
config sysmenu <on|off> [text] [x] [y] [size] [scale] 画面右下のメニューボタンやオートボタンの表示と位置を設定します。
config menu mode <0|1> 標準/カスタムのメニューモードと、メニュー画面の遷移演出を設定します。
config rightclick <sysmenu|textoff> 右クリックでメニューを開くか、UI を隠すかを設定します。

XZ80 専用設定 (configXZ80)

コマンド 説明
configXZ80 screenmode <1〜4> XZ80 の解像度と色形式を切り替えます。
configXZ80 combiMode <0〜15> 複数画面の論理配置と出力方式を設定します。
configXZ80 speed <1|2|4|8> ランタイム全体の早送り倍率を設定します。

旧コマンド・実験的機能

コマンド 説明
OPNAPlay <MMLファイル名> 旧コマンドです。fm play / fm stop を使ってください。
call 8puzzle <画像名> [シャッフル回数] 指定画像を使った 8 パズルを呼び出します。
float <変数> = <式> 小数・文字列の変数を宣言または代入します。
mode <shooting|adventure> 実験中のシューティングモードに関するコマンドです。