04. よく使う命令

入門に必要な命令だけを抜粋します。完全一覧は 公式マニュアル 第10章 を正としてください。

実演は GameData\data0\scenario\feature_demo.txt の各章にあります（*b_text / *b_bg / *b_chara / *b_sound / *b_select / *b_branch など）。

4.1 背景

bg 0 bg01a
bg 0 bg01c 0 0 fadein 30 sync
clearbg

関連: crossfade bg01b 1000（重ねて切り替え）／wipe bg01b 800 left（方向つき）／fadethrough bg01a 1000（単色を挟む）。

ルール画像（data7\rule の白黒画像）でも切り替えられます。

bg 0 bg01b 0 0 015 60
wipe bg01b 1000 1080p_rule10

trans_begin
bg 0 bg01c
chara_show 0 smile center 0
trans 015 1200

• bg 0 bg01b 0 0 015 60 … ルール画像 015 で、60 フレームかけて背景を替えます。
• trans_begin → 場面を変える → trans 015 1200 … 立ち絵ごと、場面まるごと切り替えます。

キャプチャ差し替え images/04_bg.png

bg 命令で背景が表示された画面

4.2 立ち絵

chara_show 0 smile center 30
chara_change 0 trouble 15
chara_hide 0 30
chara_clear

2 人並べるときは、層の番号を変えます。

chara_show 0 student_smile left 20 sync
chara_show 1 yukata_trouble right 20 sync

横の位置は、左から left（画面の 1/6）・middleleft（1/3）・center（中央）・middleright（2/3）・right（5/6）です。Windows・Android・ブラウザで同じ位置に出ます。

• 表情の名前だけで見つかるのは、キャラのフォルダ（data4\stand\ch01 など）が system\SoundInit.txt の表に登録してあるためです。
• 同じ表情名を 2 人が持つときは、ch02/smile のようにフォルダから書きます。

イベント CG は別系統です。差分の名前だけで出すと、ベースの絵が自動で下に敷かれます（data3\cg01）。

evcg_show "smile" 600
evcg_hide 500

キャプチャ差し替え images/04_chara.png

4.3 メッセージ・名前

msgshow
name "太郎"
	今日はいい天気だ。
name ""
msghide

文章の中で、ふりがな・色・大きさを変えられます。

	<ruby=はる>春</ruby>の光が、石畳に落ちています。
	<color=#ffd45a>色を変えた文字</color>と、<size=34>大きくした文字</size>も置けます。

キャプチャ差し替え images/04_message.png

4.4 ラベルとジャンプ

*start
jump *ending
*ending
end

引数が 1 つで * が無いときは、まずラベルとして探し、無ければファイル名として扱います。同じファイルの中へ飛ぶときは、* を付けると打ち間違いに気づきやすく安全です。

4.5 選択肢

ラベルの * は、付けても付けなくても動きます。

コマンド形式（シンプル）

choice "はい" *yes_label "いいえ" *no_label

*yes_label
	選んだのは「はい」です。
jump *after_choice

*no_label
	選んだのは「いいえ」です。
jump *after_choice

*after_choice

1 つずつ足す形式（デモで多用）

#select_clear
#select_add "元気よく答える", *answer_a
#select_add "だまっている", *answer_b
#select_add "まだ選べない項目", *answer_b, 0
#select_show

• 3 つめの引数に 0 を渡すと、見えているのに選べない項目になります。
• 1 行で書くなら #select "A", *label_a, "B", *label_b も使えます。
• 選択肢を出す前に、自動でオートセーブが 1 件残ります（10章）。

最初は choice の方が読みやすいです。

時間制限付きの選択肢

選択肢の直前の行に select_timeout 制限ms [既定] を書くと、その選択肢に制限時間が付きます（# は付けません）。

select_timeout 5000 *no_answer
choice "はい" *yes_label "いいえ" *no_label

*no_answer
	……答えられないまま、時間が過ぎた。

• 既定 は、時間切れのときに選んだことにする選択肢の番号（1 から）か *ラベル です。ラベルは選択肢に無い飛び先でもかまいません。省くと 1 つ目の選択肢になります。
• 効くのは次の選択肢 1 回だけです。選択肢には残り時間の帯が出ます。
• セーブ画面などを開いている間は時間が止まります。セーブから再開したときやシーン戻りでは、制限時間が付き直ります。

キャプチャ差し替え images/04_choice.png

4.6 BGM / SE

bgm title 800
bgmfade 30 600
bgmfade 100 600
bgm_stop 800

se sysse01
stopse

キャプチャ差し替え（任意） images/04_bgm.png

4.7 画面フェード

fadeout 1000
fadein 1000
fadecolor out 600 255 255 255
fadecolor in 600 255 255 255

• fadeout で黒へ落とし、fadein で明けます。どちらも終わるまで次の行へ進みません。
• fadecolor out|in ミリ秒 R G B は好きな色で覆います（例は白）。
• シーンの区切りでは fadeout → 背景差し替え → fadein の流れが分かりやすいです。

キャプチャ差し替え（任意） images/04_fade.png

4.8 よくある組み合わせ（テンプレ）

*scene_room
fadeout 500
INIT_ALL
scenetitle 広場にて
bg 0 bg01a
chara_show 0 smile center 0
fadein 500

name "ヒロイン"
	ようやく着いたわね。

name ""
choice "話す" *talk "見送る" *leave

場面の終わりは、bgm_stop 800 → fadeout 800 → END_ALL の順に書くと、消えきってから後片付けできます。
区切りの良いところで autosave と書くと、その場所でオートセーブします。オートセーブは、環境設定のオートセーブが入のときだけ残ります。

4.9 コメントと sync

コメントは // がおすすめです（; や # で始まる行もコメントになります）。

// スラッシュコメント（おすすめ）
; セミコロンで始まる行もコメント

bg や chara_show の末尾に sync を付けると、演出が終わるまで次の行に進みません。

bg 0 bg01c 0 0 fadein 30 sync
chara_show 0 smile center 30 sync

fadein / fadeout は、sync を付けなくても終わるまで待ちます。暗転の途中で立ち絵がチラつくときは、前の命令に sync が付いているか確認してください。

4.10 ボイス（入門）

ボイスは data6 の下に、キャラごとのフォルダで置きます（例: data6\vo01\vo01_0001.opus）。シナリオには名前だけを書きます。

vo vo01_0001
	こんにちは。

vo vo02_0001
vo_wait

1 つめは、台詞と一緒に鳴らす形です（文章を読んでいる間に声が流れます）。2 つめは、鳴り終わるまで待ってから次へ進む形です。

キャラ ID の一覧は system\SoundInit.txt の表にあります。実演: feature_demo.txt の *b_sound / *b_sound2。コンフィグのキャラ別ミュートは 08章 を参照。

4.11 動画（入門）

動画は data8 に置き、名前だけで呼びます。

movie logo/lumina_logo

• movie 名前 … 再生が終わるまで待ちます。クリックで飛ばせます。
• movie_play 名前 … 再生を始めて、すぐ次の行へ進みます。
• setmovievolume 80 で、先に音量を決められます。

動画は Windows・ブラウザ・Android のどれでも再生できます。実演: feature_demo.txt の *a_movie。

4.12 次に読む章

Copyright (C) ALC Software Laboratory. All Rights Reserved.