コマンド説明

初めに

シナリオに記述する、コマンド共通の注意点や、『フラグ』等の記述方法を説明します

シナリオは、ゲームのメッセージを表示したり、画像を表示させる為のものです

シナリオは基本的に、上から書かれた順に実行しますが
コマンドによって、『実行位置を飛ばしたり』、『ループさせる』事が可能です

「初めに」一覧

・(前作との互換性)
・(前作のシナリオフォルダ移植)
・シナリオで使用する画像ファイル
・コマンドの書式
・コマンドのパラメータ(値指定)
・コマンドのパラメータ(ファイル名指定)
・シナリオファイル
・ラベル
・フラグファイル
・フラグ名の記述方法
・汎用フラグ
・フラグのパラメータ指定
・予約語ファイル
・フラグ値＆予約語のメッセージ埋め込み
・色指定

(前作との互換性)

今作(nh_ミケ02.exe)は前バージョン(nh_ミケ00.exe)で使っていたコマンドが一部未使用(または変更)となっています。
それ以外のコマンドについては互換性が有りますので、前バージョンのシナリオは以下のように対処する事で、
今作でも使用する事が出来ます。

↓（未使用、または変更になったコマンド）↓
・フラグ値＆予約語埋め込み([@fg:XXX]、[@fn:XXX]、[@tx:XXX])
　フラグの記述方法や予約語埋め込みの記述方法が変更になりました。
　詳しくは下記の『フラグ、予約語』の記述を参照して下さい。
・キャラ画像移動設定(@zmset_char_move)、キャラ画像移動実行(@zm_char_piston_go)
　未使用となりました　→コマンド行を『コメント』にしてください。
・フラグ系コマンド全般
　フラグの記述方法が変更になりました。
　詳しくは下記の『フラグ、予約語』の記述や、本マニュアルの『フラグ系』を参照して下さい。
・フラグ分岐(@flg_sel)
　フラグ値比較分岐(@flg_comp_sel)で同様の処理を行える為に削除しました。
　「@flg_sel」を　→「@flg_comp_sel」と書き換え、符号パラメータを追加して下さい。
・フラグ比較分岐(@flgflg_comp_sel)
　フラグの記述方法変更により、フラグ値比較分岐(@flg_comp_sel)で行えるようになりました。
　「@flgflg_comp_sel」を　→「@flg_comp_sel」と書き換えて下さい。
・サブウィンドウ情報ファイルのグラフコマンド(GRP)
　新しくBGH(棒グラフ横)コマンドが出来たので、未使用となりました。
　「GRP」を　→「BGH」と書き換えて下さい。

(前作のシナリオフォルダ移植)

前バージョン(nh_ミケ00.exe)で作成したシナリオフォルダを『usercustom』にコピーするだけです。
但しその時、そのシナリオに対応するシナリオ情報ファイル(01シナリオ追加XX.txt)をシナリオフォルダ内にコピーし、
『01シナリオ追加.txt』とファイル名をリネームして下さい。
『XX』は(00～99)
※シナリオに対応する『XX』はシナリオフォルダ名の『XX』と同じファイル名のものです。

また、新たにシナリオフォルダの下に固定フォルダが必要です。
以下のようにフォルダを作成し、ファイルを移動させて下さい。
・フラグファイルは「flgフォルダ」
・メニューファイルは「menuフォルダ」
・予約語ファイルは「reserveフォルダ」
・サブウィンドウ用ファイルは「winsubフォルダ」

・シナリオで使用する画像ファイル

画像の一部を透明にしたい個所は『LIME』で描いて下さい。
※ただし背景画面には透明色は有りません。

↓「透明色」の有るキャラ画像の例です

・コマンドの書式

・コマンドの書式： @XXXXX(パラメータ)
　シナリオテキストファイルの行の先頭に半角'@'を書くと「コマンド」と認識されます
　※その他は「シナリオ表示メッセージ」または「コメント行」と見なされます。
　XXXXXはコマンド名称で、()が続きます。
　コマンド名称と()は全て半角です。
　パラメータはコマンドにより複数設定する必要が有ります。

・コマンドのパラメータ(値指定)

・コマンドのパラメータ(値指定)
コマンドのパラメータで『値指定』をするものが有ります。(※数値指定の事です)
その場合、2種類の指定方法が有ります。
(1)数値指定
　そのままパラメータに数値を記述します。
(2)フラグ指定
　先にフラグに値を設定しておき、パラメータにそのフラグ名を指定する方法です。
場合に応じて、好きな方法で『値指定』を行ってください。

・コマンドのパラメータ(ファイル名指定)

・コマンドのパラメータ(ファイル名指定)
コマンドのパラメータで『ファイル名指定』をするものが有ります。

・シナリオファイル

「sinフォルダ」がシナリオフォルダになり、シナリオファイルを置きます。
また、シナリオに『コマンド』を記述した場合は、このコマンドを実行します。


・シナリオのコメント
　コメント行はシナリオに何も影響を及ぼさず、たた読み飛ばします。
　シナリオファイル内を見やすくする為の「説明」や「忘備録」として使ってください。
　
例)
@@コメント
↑でコメントになります(@を2個以上つなげる)

・シナリオ内の改行のみ行
　改行のみの行は、読み飛ばします

・ラベル

・ラベル
　行の先頭に「*」(半角アスタリスク)が付いている行は、『ラベル行』です。
　ラベルは、シナリオ内を移動させる時に使う『目印』です。
　ラベル行はシナリオのメッセージに表示されません。
　1つのシナリオファイル内には、同じ名前のラベルを使用しないでください。誤動作の原因となります。

・フラグファイル

フラグとは、シナリオ内で使用できる『変数』の事です。
コマンドによって値を設定したり、値によってラベル移動を行ったりする事が出来ます。
フラグファイルは、「各シナリオフォルダ」下の「flg」フォルダ内に置いて下さい。

※フラグは使用しなくてもゲーム作成は可能です
　難しいと感じたら無理に使用しなくても構いません
　ですがフラグを使用すれば、より複雑なゲームが作成可能になります

・フラグファイル
　「flg」フォルダ内に最大1000個のファイルを作成可能
　　ファイル名の形式は「flg_xxxx.txt」「xxxxはID名：4文字の半角英数字」
　
　・各ファイル内にフラグ名を記述
　　1つのフラグ名は最大半角20文字です。
　
　　フラグには「配列要素数」を指定可能
　
　　例）配列無しのフラグ名「gold」と、1次元配列(要素数2)のフラグ名「bank」を指定する場合
　　　↑これはbank[0]と、bank[1]の2個の変数が有る事を意味します。※指定要素番号が1～2では無い事に注意！
　　　　つまり[]内の『要素指定番号』は『0番』～『要素数-1』までの値です。
　　　　例えば要素数が『100』の場合なら、『要素指定番号』は『0～99』となります。
　
　　例）2次元配列要素数,2,10のフラグ名「bank」と4次元配列要素数,10,4,7,2のフラグ名「diary」を指定する場合
　
　　要素指定が無いフラグは「要素数=1」で数えます。
　　　※要素数,2,10は「2×10」で総要素数「20」
　　　※要素指定無し(要素数は1)と、要素数,10,10では、「1」+「10×10」で総要素数「101」
　　　※要素数,2,10,10,10は「2×10×10×10」で総要素数「2000」となりNGです

・フラグ名の記述方法

・フラグ名の記述方法
　コマンドのパラメータやメッセージ埋め込みにフラグを設定する事が可能です。
　フラグの指定は以下のように記述します。
　↓
　　「xxxx」はフラグファイル名のID名です。※「flg_xxxx.txt」の[xxxx部分]
　　「yyyy」はフラグファイル内に記述した、フラグ名称です。
　　「xxxx」と「yyyy」の間に「#」(半角シャープ)を入れます。
　　「yyyy」のフラグに配列指定が有る場合は、「[]」(半角大カッコ)で要素番号を指定できます
　　　※要素数の開始番号は「0」からです。
　　　　要素数10の場合は、[0]～[9]の要素番号を指定可能
　　　　　　　　　　　　　↑1～10では無い事に注意！
　　　※1次元の要素指定番号=0の場合、[0]を省略する事が可能です
　　例）ファイル名「flg_flg1.txt」、フラグ名「体力」を指定する場合
　　→ flg1#体力
　　例）ファイル名「flg_flg1.txt」、フラグ名「AAA」、要素番号「0」を指定する場合
　　→ flg1#AAA[0]
　　例）ファイル名「flg_ZZZZ.txt」、フラグ名「BBB」、要素番号「2」を指定する場合
　　→ ZZZZ#BBB[2]

・汎用フラグ

汎用フラグは、フラグと同様の使い方が出来る、『変数』です。
一時的な値の保存用、などに使用してください。

汎用フラグは以下の10個が使用できます。

・汎用フラグは、通常のフラグの『要素番号』として使用することが出来ます。
　　例）ファイル名「flg_flg1.txt」、フラグ名「AAA」、要素番号「@cnt0」を指定する場合
　　→ flg1#AAA[@cnt0]
　　※↑汎用フラグ『@cnt0』に格納された値が『要素番号』になります

・フラグのパラメータ指定

・コマンドパラメータにフラグを指定する事ができます

例)　画像振動コマンドのパラメータにフラグで指定
　コマンドは　@quake(P1,P2)
　P1:振動方向　0:横振動 1:縦振動
　P2:振動回数
　↑この「P2:振動回数」をフラグで指定する場合は
　※使用フラグは「flg_AAA.txt」のフラグ名『houkou』とします
　↓
　これでP2に設定される値は、『AAA#houkou』に設定していた値が入ります

※コマンドパラメータにフラグ配列を指定する場合
　フラグ名の後ろに「[]」(半角大カッコ)で要素番号を指定します

・コマンドパラメータに汎用フラグを指定する
　パラメータに『@cnt0』～『@cnt9』の汎用フラグ名を指定すればOKです。

※コマンドパラメータにフラグ配列の要素番号に汎用フラグを指定する場合
　「[]」(半角大カッコ)内の要素番号に『@cnt0』～『@cnt9』を指定します

・予約語ファイル

予約語とは、シナリオ中で『固定の名前』等、変更されないテキストを指定するものです。
予約語を指定しておく事で、名前の変更が有った場合でも、シナリオの全ての箇所を変更する必要が無く、
予約語ファイルを変更するだけで対応が出来ます。
予約語ファイルは、「各シナリオフォルダ」下の「reserve」フォルダ内に置いて下さい。

※予約語は使用しなくてもゲーム作成は可能です
　難しいと感じたら無理に使用しなくても構いません
　ですが予約語を使用すれば、シナリオの修正が、より簡単になります
　(例えば、主人公の名前の変更など)

・予約語ファイル
　「reserve」フォルダ内に最大1000個のファイルを作成可能
　
　・各ファイル内に予約語名を記述
　　各ファイル内の予約語の件数は1ファイルにつき最大1000件まで
　　
　　ファイルの行番号が、『予約語番号』になります。　『予約語番号』は予約語指定時に使用します。
　　ファイルの行番号1～1000が、予約語番号(0～999)に対応します。
　　
　　また、予約語の後ろを「,」(カンマ)で区切り、「識別子」を指定する事も可能です。
　　※識別子は、必要なければ指定しなくても大丈夫です
　
　　例）識別子無しの予約語「ユウシャ」(0行目)と、
　　　　識別子指定(name)の予約語「勇者」(1行目)を指定する場合
　　　↑「勇者」のすぐ後ろに区切りの「,」(カンマ)をいれて、
　　　　識別子「name」を記述します

・フラグ値＆予約語のメッセージ埋め込み

・フラグ値＆予約語のメッセージ埋め込み
シナリオに『埋め込み』を行う事で、フラグの値や、予約語をメッセージ表示させる事が出来ます。

・フラグ埋め込み

・汎用フラグ埋め込み
　「[@f:」と「:]」を前後に挟む
　その間に「汎用フラグ名を指定」@cntX(@cnt0～@cnt9)を設定する

・フラグ埋め込みの書式指定
　フラグと汎用フラグは書式の指定が出来ます
　書式によって、埋め込む「最小桁数」等を設定する事が出来ます
　「フラグ指定」の後ろに「:%」(半角コロンと半角パーセント)を記述し、「書式」ZZZZを記述する
　「書式」ZZZZは以下の通りです
　　桁数　　 ：表示する最小桁数を指定します
　　0(数字)　：値が最小桁数に満たない場合、「0」で埋めます
　　+(プラス)：値が正の値の場合、先頭に「+」プラス記号が表示されます

例）最小桁数「10桁」にする→　[@f:SMP#フラグ1:%10:]
例）最小桁数「4桁」で「0」埋め→　[@f:@cnt0:%04:]
例）最小桁数「6桁」で「プラス」付加→　[@f:SMP#フラグ2:%+6:]

・予約語埋め込み

例）ファイル名「rsv_rsv1.txt」の識別子(charname1)の予約語を指定する場合

例）ファイル名「rsv_rsv1.txt」の先頭行(予約語番号:0)の予約語を指定する場合

・予約語とフラグの組み合わせ
予約語の『ファイル行数』の箇所を、さらに『フラグ』で指定する事も出来ます

[@RSV:XXXX#[@f:xxxx#yyyy:]:]
例)　予約語(rsv_AAA.txt)の予約語番号→(flg_BBB.txt,フラグ名:gyousuu)の場合

・予約語と汎用フラグの組み合わせ
予約語の『ファイル行数』の箇所を、さらに『汎用フラグ』でも指定する事も出来ます

[@RSV:XXXX#[@f:xxxx#yyyy:]:]
例)　予約語(rsv_AAA.txt)の予約語番号→(@cnt9の値)の場合

・色指定

・色指定
　パラメータには「色指定」するものが有りますが、2パターンの指定方法が有ります。
　(1)文字指定
　　"balck","white"など色の英単語を記述する方法です。
　　この英単語は、ブラウザで表示できる147種類のHTMLカラーネームと同じです。
　(2)カラーコード指定
　　#(半角シャープ)で始まる6桁の英数字で記述する方法です。
　　この英数字は、ブラウザで表示できるHTMLカラーコードと同じです。

テキスト系

主にメッセージテキストに対するコマンドです

他に「メモ表示」「クリック画面」を含みます
※メモファイルは、各シナリオフォルダの「memo」フォルダ下に置いて下さい。

コマンド一覧

・改ページ　@key_wait_p()
・テキスト色設定　@text_color()
・メッセージフォント変更　@change_font()
・フラグ内容表示　[@f:XX:]
・予約語表示　[@RSV:XX:]
・メモ表示　@memo()
・クリック画面　@click_win()
・クリック画面デザイン　@click_win_design()

・改ページ
　@key_wait_p()

『ウィンドウモード時』においてシナリオメッセージの改ページを行います。
(※通常はメッセージウィンドウの3～4行表示で改ページします)
※このコマンドを使用しなくても自動で改ページを行いますが、
「この場所で必ず改ページしたい」と思う箇所で使用してください。

↓画面の下側の黒い半透明のエリアが「メッセージウィンドウ」です

・テキスト色設定
　@text_color(P1)

シナリオメッセージのテキスト色を変更します。
※色指定は本マニュアルの【初めに】を参照

・メッセージフォント変更
　@change_font(P1,P2)

シナリオメッセージのテキストのフォントを変更します。
※フォント名が空白時、フォント名は現在の設定のまま変更しません
※フォントサイズが「0以下」の時、フォント名とサイズを初期設定に戻します

・フラグ内容表示
　[@f:P1:]

　フラグ内容表示(書式指定付き)
　[@f:P1:%ZZZZ:]

フラグ内容をシナリオのメッセージ上に表示させるコマンドです。
このコマンドは、他のコマンドと違ってメッセージ上に埋め込むコマンド なので”[:]”で通常メッセージと区別します。
フラグ値の表示に『書式指定』する場合は、フラグ名称指定の後ろに”:%”を追加します。
※このコマンドは行の先頭では無く、シナリオメッセージの途中に記述出来ます。

指定する『フラグ名称』には、「通常フラグ」「汎用フラグ」の2種類の指定方法があります。

・「通常フラグ」の指定
　フラグファイル名とフラグ名の間に『#』(半角シャープ)を挟んで記述します
　※フラグ名称は「flg_XXXX.txt」で設定します。
　設定するフラグ名称は最大半角20文字です。


※フラグ名称指定の記述方法は本マニュアルの【初めに】を参照

・「汎用フラグ」の指定
　汎用フラグ名『@cnt0』～『@cnt9』を記述します


・「フラグ埋め込み」の書式指定
　通常フラグと汎用フラグは書式の指定が出来ます
　「フラグ指定」の後ろに「:%」(半角コロンと半角パーセント)を記述し、「書式」ZZZZを記述する
　「書式」ZZZZは以下の通りです
　　　桁数　　 ：表示する最小桁数を指定します
　　　0(数字)　：値が最小桁数に満たない場合、「0」で埋めます
　　　+(プラス)：値が正の値の場合、先頭に「+」プラス記号が表示されます

・予約語表示
　[@RSV:P1:]

予約語をシナリオのメッセージ上に表示させるコマンドです。
このコマンドは、他のコマンドと違ってメッセージ上に埋め込むコマンド なので”[:]”で通常メッセージと区別します。
※このコマンドは行の先頭では無く、シナリオメッセージの途中に記述出来ます。

※予約語指定の記述方法は本マニュアルの【初めに】を参照

※予約語は「rsv_XXXX.txt」で設定します。
ファイルの行番号1～1000が、予約語番号(0～999)に対応します。



※予約語番号の指定を、「フラグ内容表示」[@f:P1:]で指定する事も可能です

・メモ表示
　@memo(P1)

『メモ帳』等でテキストファイルを表示します。
※メモファイルは、各シナリオフォルダの「memo」フォルダ下に置いて下さい。

・クリック画面
　@click_win(P1,P2,P3,P4・・・)

テキストのみを表示する小ウィンドウを表示します。
小ウィンドウはクリックで消えます。
※テキストは最大6行まで指定可能です

↓画面の中央の黒い小ウィンドウが「クリック画面」です

・クリック画面デザイン
　@click_win_design(P1,P2,P3,P4,P5,P6)

クリックウィンドウの画面デザインを変更します。

画像表示系

主に画像ファイルの表示を行うコマンドです
※背景画像ファイルは、各シナリオフォルダの「stage(デフォルト時)」フォルダ下に置いて下さい。
※キャラ画像ファイルは、各シナリオフォルダの「char(デフォルト時)」フォルダ下に置いて下さい。

コマンド一覧

・背景(ステージ)表示　@stage()
・キャラクター情報設定　@char_on()
・キャラクター情報全消去　@char_off()
・キャラクター表示　@char_dsp()
・背景ズーム　@zm_puru()
・キャラズーム　@zm_char_puru()

・背景(ステージ)表示
　@stage(P1)

背景(ステージ)画像を設定します。
ちなみに
「@stage(0)」とすると「背景黒」
「@stage(1)」とすると「背景白」を表示します。

・キャラクター情報設定
　@char_on(P1,P2,P3,P4)

　背景上に表示する画像を設定します。
※このコマンドではキャラクターは表示しません(@char_dsp()で表示実行)
※キャラクターの設定最大数は「10」です(CHAR_MAX)

・キャラクター情報全消去
　@char_off()

※設定されているキャラクター情報を全て消去する

・キャラクター表示
　@char_dsp()

※@char_on、@char_offで設定したキャラクター情報を元に表示する

・背景ズーム
　@zm_puru(P1,P2)

※背景+キャラ画像をズーム表示し、ゆらす
一旦ズーム倍率まで拡大し、その後20％倍率でズームしたまま、揺らします
クリックすると画像が元に戻ります

・キャラズーム
　@zm_char_puru(P1,P2)

※キャラ画像のみをズーム表示し、ゆらす
一旦ズーム倍率まで拡大し、その後20％倍率でズームしたまま、揺らします
クリックすると画像が元に戻ります

移動系

シナリオファイルの実行する位置を変更するコマンドです

コマンド一覧

・ラベル移動　@goto_label()
・別シナリオ移動　@goto_file()
・別シナリオのラベル移動　@goto_file_label()
・移動元シナリオに戻る　@return_file()

・ラベル移動
　@goto_label(P1)

同一ファイル内の指定ラベルに移動する。

・別シナリオ移動
　@goto_file(P1)

別のシナリオファイルに移動する。

・別シナリオのラベル移動
　@goto_file_label(P1,P2)

別ファイル内の指定ラベルに移動する。

・移動元シナリオに戻る
　@return_file()

別シナリオのラベル移動コマンド @goto_file_label()で移動した後、
移動元ファイルの@goto_file_label()の続きの行からシナリオを再開します。
※(注意)戻る先は、必ず『最後に実行した@goto_file_label()』の続きの行からになります

↓「シナリオA」から「シナリオB」に移動後、「@return_file()」した時のイメージです

終了系

シナリオ終了時のコマンドです

・シナリオ終了
　@end()

これをコールする事でシナリオが終了します。
シナリオを終了させて「シナリオ表紙画面」に移行させる時は、必ず記述する必要が有ります。
シナリオの最後や、シナリオ途中のバッドエンド等で使用して下さい。
※シナリオに終了が無く、ループする場合は必要ありません。

演出系

表示画像に対し演出を加えるコマンドです
※単位の『ms』は1000分の1秒(ミリセカンド)です。
　『0.5秒』なら「500ms」となります。

コマンド一覧

・暗転表示　@dark()
・明転表示　@light()
・フラッシュ表示　@flash()
・連続フラッシュ表示　@flash3()
・暗転フラッシュ表示　@dark_moment()
・画像振動　@quake()
・画像振動(上級設定)　@quake_advc()

・暗転表示
　@dark(P1)

ウィンドウが徐々に暗くなり、最後には完全に一面黒になります。
※キャラ情報も消去されるので注意して下さい。
完全に暗転するまでの時間を指定できます。

・明転表示
　@light(P1)

ウィンドウが徐々に明るくなり、最後には完全に一面白になります。
※キャラ情報も消去されるので注意して下さい。
完全に明転するまでの時間を指定できます。

・フラッシュ表示
　@flash(P1)

一瞬ウィンドウが白く光り、徐々に元に戻っていきます。
元に戻るまでの時間を指定できます。

・連続フラッシュ表示
　@flash3()

一瞬ウィンドウが白く光る動作を3回続け、その後徐々に元に戻っていきます。

・暗転フラッシュ表示
　@dark_moment(P1)

一瞬ウィンドウが暗転し、徐々に元に戻っていきます。
元に戻るまでの時間を指定できます。
※フラッシュ表示の暗転版です。

・画像振動
　@quake(P1,P2)

表示画像を小刻みに振動させます。

・画像振動(上級設定)
　@quake_advc(P1,P2,P3,P4)

表示画像を小刻みに振動させます。※@quake()より詳細な設定が可能です
このコマンドでは、揺れ幅や、振動間隔時間を設定できます。

選択系

選択肢ボタンを表示させるコマンドです
※メニュー位置ファイルは、各シナリオフォルダの「menu」フォルダ下に置いて下さい。

コマンド一覧

・メニュー選択　@menu()
・選択分岐ラベル　@ans()
・選択分岐終端　@ansend()
・メニュー選択(位置指定)　@menu_pos()
・リストメニュー型選択　@list_menu()
・メニュー選択(位置フリー)　@menu_free()
・選択肢無効　@menu_dis()
・選択肢有効/無効　@menu_dis_abl()
・選択肢表示/非表示　@menu_visible()
・選択肢フォント変更　@menu_font()
・選択済マーク表示/非表示　@menu_kidoku_mark()
・選択メニュー背景色　@menu_back_color()

・メニュー選択
　@menu(P1,P2,・・・)

選択肢を表示する時の『表示テキスト」を指定します。
このコマンドでは各選択肢の表示エリアは固定です。
※選択肢は6個まで可能
※選択肢の名称(表示テキスト)は半角60文字まで

・選択分岐ラベル
　@ans(P1)

※@menu、@list_menu等、『選択系コマンド』で選択された場合の移動ラベルです。
　『メニュー選択系コマンド』を使用する場合は後述の「@ansend()」とセットで、必ず記述して下さい
　
　パラメータの『選択肢番号」は、各選択肢番号の数字を記述し、移動ラベルとなります。
　例えば、「選択肢1」を選択した場合→@ans(1)　に移動します
　同様に、「選択肢3」を選択した場合→@ans(3)　に移動します

・選択分岐終端
　@ansend()

※選択を行った場合、選択分岐ラベル「@ans()」の移動ラベルから処理を行い、
このコマンドを終端として、選択処理を終了します。
　『メニュー選択系コマンド』を使用する場合は前述の「@ans()」とセットで、必ず記述して下さい

・メニュー選択(位置指定)
　@menu_pos(P1,P2,P3,P4,P5,・・・)

このコマンドでは選択肢の座標位置と幅を指定できます。
※選択肢は10個まで可能

・リストメニュー型選択
　@list_menu(P1,P2,・・・)

このコマンドでは他と違い、メッセージウィンドウ上に選択肢を表示します
※選択肢は20個まで可能
※リストメニューでは「選択済マーク」は表示されません

↓これがリストメニューです

・メニュー選択(位置フリー)
　@menu_free(P1)

メニュー位置ファイルにパラメータを記述する事で、選択肢ボタンの位置をボタン別に自由に指定できます。
※選択肢は100個まで可能


メニュー位置ファイルは、選択肢毎に以下の様に記述して下さい。
「選択肢タイトル,X座標,Y座標,幅,高さ」
例：選択肢１,370,140,60,50　【menu_0.txtを参照】

・選択肢無効
　@menu_dis(P1)

無効にする選択肢番号を設定します。
※選択肢1を無効にする場合は「1」を設定
無効になった選択肢は、選択不可となります。
このコマンドは必ず、『メニュー選択系コマンド』の直前に記述して下さい。

・選択肢有効/無効
　@menu_dis_abl(P1,P2)

有効/無効にする選択肢番号を設定します。
※選択肢1の有効/無効を変更する場合は「1」を設定
無効になった選択肢は、選択不可となります。
このコマンドは必ず、『メニュー選択系コマンド』の直前に記述して下さい。

※(注意)全選択肢が無効の場合、シナリオが続行できなくなります、必ず、最低1個は「有効」にして下さい

・選択肢表示/非表示
　@menu_visible(P1,P2)

表示/非表示にする選択肢番号を設定します。
表示にした場合、その選択肢は自動的に『有効』となります。
非表示にした場合、その選択肢は自動的に『無効』となります。
※選択肢1の表示/非表示を変更する場合は「1」を設定
非表示になった選択肢は、メニューに表示されません(同時に無効になります)。
このコマンドは必ず、『メニュー選択系コマンド』の直前に記述して下さい。

※(注意)全選択肢が非表示の場合、シナリオが続行できなくなります、必ず、最低1個は「表示」にして下さい

・選択肢フォント変更
　@menu_font(P1,P2)

選択肢のフォントを変更します。
※フォント名が空白時、フォント名は現在の設定のまま変更しません
※フォントサイズが「0以下」の時、フォント名とサイズを初期設定に戻します

・選択済マーク表示/非表示
　@menu_kidoku_mark(P1)

既に選択した選択メニューの選択済マークの表示/非表示を変更します。
※表示の場合、メニューの左上に「赤いマーク」が表示されます
※初期値は「表示」です

↓左上の赤いマークが「選択済マーク」です

・選択メニュー背景色
　@menu_back_color(P1,P2)

選択メニューボタンの背景色と透過率を変更します。
※色指定は本マニュアルの【初めに】を参照
※背景色指定が『空白』の場合は初期値に戻ります
※初期値は「色：LIME」の「透過率：50」です

名前系

シナリオメッセージがセリフの時などに、名前を表示するコマンドです
(注意)メッセージ表示が『フルスクリーン時』は、「名前ウィンドウ」は表示しません。

コマンド一覧

・名前ウィンドウ表示　@name()
・色つき名前表示　@name_color()
・名前ウィンドウ消去　@name_cls()

・名前ウィンドウ表示
　@name(P1)

メッセージウィンドウ上に名前ウィンドウと指定した『名前』を表示します。
主に、シナリオのセリフ表示時に使います。

・色つき名前表示
　@name_color(P1,P2)

@name()の機能に加え、名前表示の色を指定できます。
※色指定は本マニュアルの【初めに】を参照

・名前ウィンドウ消去
　@name_cls()

名前ウィンドウを消します

音系

シナリオ中に音声ファイルを再生するコマンドです
※音声ファイルは、各シナリオフォルダの「sound(デフォルト時)」フォルダ下に置いて下さい。

コマンド一覧

・効果音開始　@efc_start()
・サウンド開始　@snd_start()
・サウンド停止　@snd_stop()

・効果音開始
　@efc_start(P1,P2)

効果音を鳴らします。　主に短い音声の再生に使用します。
再生モードにより、再生方法が異なります。
　モード0 : 指定したファイルは通常の再生を行う
　モード1 : 指定したファイルは無限ループで再生を行う
　モード2 : 指定したファイルは再生終了まで待つ(※再生終了までシナリオが止まります)

・サウンド開始
　@snd_start(P1,P2)

サウンド(BGM)を鳴らします。　主に長めの音声の再生に使用します。
再生モードにより、再生方法が異なります。
　モード0 : 指定したファイルは通常の再生を行う
　モード1 : 指定したファイルは無限ループで再生を行う
　モード2 : 指定したファイルは再生終了まで待つ(※再生終了までシナリオが止まります)

・サウンド停止
　@snd_stop()

再生中の効果音やサウンドを停止します。

フラグ系

フラグに値を設定したり、値を比較するコマンドです
※フラグファイルは、各シナリオフォルダの「flg」フォルダ下に置いて下さい。

※数値(設定値、加算値、比較値)の範囲：　-2,147,483,648～2,147,483,647(4バイトの数値)
※ESP:XXXで共有メモリに値設定(XXXは共有メモリ番号)

コマンド一覧

・フラグ設定　@set_flg()
・フラグ加算　@add_flg()
・フラグコピー　@copy_flg()
・フラグ間計算　@calc_flg()
・フラグ乱数設定　@random_flg()
・条件付フラグ設定　@setcomp_flg()
・条件付フラグ加算　@addcomp_flg()
・フラグ値比較分岐　@flg_comp_sel()
・フラグ符号反転　@flg_plu_mi()

・フラグ設定
　@set_flg(P1,P2)

フラグに値を設定する
※ESP:XXXで共有メモリに値設定(XXXは共有メモリ番号)

・フラグ加算
　@add_flg(P1,P2)

フラグに値を加算する
※ESP:XXXで共有メモリに値設定(XXXは共有メモリ番号)

・フラグコピー
　@copy_flg(P1,P2)

「元フラグ」を「先フラグ」にコピーする
フラグの値が「P1」→「P2」にコピーされます。
※ESP:XXXで共有メモリに値設定(XXXは共有メモリ番号)

・フラグ間計算
　@calc_flg(P1,P2,P3,P4)

「値1」と「値2」を計算し、結果を「結果フラグ」に代入する
計算符号：'+'(加算), '-'(減算), '*'(かけ算), '/'(割り算), '¥'(割り算の余り)
　※かけ算：*(アスタリスク)
　※割り算：/(スラッシュ)
　※割り算の余り：¥(円マーク)

・フラグ乱数設定
　@random_flg(P1,P2,P3)

フラグに乱数を設定する
※乱数の範囲
1～10の範囲の乱数を発生させる場合の例→乱数開始値=1、乱数範囲=10
-3～3の範囲の乱数を発生させる場合の例→乱数開始値=-3、乱数範囲=7

・条件付フラグ設定
　@setcomp_flg(P1,P2,P3,P4,P5)

条件に一致した場合のみ、結果フラグに値を設定する

・条件付フラグ加算
　@addcomp_flg(P1,P2,P3,P4,P5)

条件に一致した場合のみ、結果フラグに値を加算する


↓↓↓これは「ミケ02」では削除(※@flg_comp_sel()で代用可能)

・フラグ分岐(※削除)
　@flg_sel(P1,P2,P3)

フラグの値と比較値を比較し、一致した場合に指定ラベルに移行する。

・フラグ値比較分岐
　@flg_comp_sel(P1,P2,P3,P4)

フラグの値と比較値(又はフラグ)を比較し、『条件式に一致』した場合に指定ラベルに移行する。

・フラグ符号反転
　@flg_plu_mi(P1)

指定フラグに設定された値の符号を反転させます。
・プラスの値ならマイナス、マイナスの値ならプラスに反転させます。


↓↓↓これは「ミケ02」では削除(※@flg_comp_sel()で代用可能)

・フラグ比較分岐(※削除)
　@flgflg_comp_sel(P1,P2,P3,P4)

フラグ1の値とフラグ2の値を比較し、『条件式に一致』した場合に指定ラベルに移行する。

サブWin(サブウィンドウ)系

サブウィンドウを表示するコマンドです
※サブウィンドウ関係のファイルは、各シナリオフォルダの「winsub」フォルダ下に置いて下さい。

コマンド一覧

・サブウィンドウ画像設定　@winsub_set()
・サブウィンドウ表示　@winsub_on()
・サブウィンドウ非表示　@winsub_off()
・サブウィンドウ情報設定　@wsub_txt_set()
・サブウィンドウ情報全削除　@wsub_clear()

・サブウィンドウ情報ファイルの書き方

　サブウィンドウ上に表示する内容を設定するファイルです。
　テキストの表示や小画像などを表示するコマンドを記述します。
　１ファイルに付き「100件」までコマンドの記述が可能。
　※「100件」に、コメント行、空行(リターンのみの行)は除きます。

　設定項目は以下の通り
・殆どのパラメータには埋め込み記号[@f:フラグ指定:]、[@RSV:予約語指定:]も対応
　※条件フラグ等(「JOF:」を付加するパラメータ)は埋め込み記号は使用できません
・表示条件有無　1:有り　SW>:有り　その他:条件無し
　　　　　　　↑「1」または「SW>」と記述すれば『表示条件有り』となります
　　　　　　　　『表示条件無し』は以下の設定(条件ﾌﾗｸﾞ,式,条件値)は不要です
・条件式　：<, >, =, !=, <=, >= のいずれかを設定
・条件フラグは　JOF:XXXX#YYYY　(XXXXはフラグファイル名のflg_XXX.txt)(YYYYはフラグ名)
・条件値　：条件フラグと比較する「数字」を設定

サブwin内のテキストの表示方法を設定します
フォント名 例「ＭＳ ゴシック」「ＭＳ 明朝」など
フォントサイズ(1～99)
フォントスタイル(0～31)　0:通常 1:太字 2:イタリック体 4:下線 8:打ち消し線 16:アンチエイリアス ※加算で複数設定可能
　「太字」で「打ち消し線」を指定する場合→「1+8」で「9」と指定
表示条件有無　1:有り　SW>:有り　その他:条件無し
　　　　　　　↑「1」または「SW>」と記述すれば『表示条件有り』となります
　　　　　　　　『表示条件無し』は以下の設定(条件ﾌﾗｸﾞ,式,条件値)は不要です
条件フラグ　JOF:XXXX#YYYY　(XXXXはフラグファイル名のflg_XXX.txt)(YYYYはフラグ名)
条件式　：<, >, =, !=, <=, >= のいずれかを設定
条件値　：条件フラグと比較する「数字」を設定

指定位置にテキストを表示します

　メインのサブウィンドウ上の指定位置に小画像を表示します

　指定位置に棒グラフを表示します
　主にゲームのHP表示などに使用します

　指定位置に四角を指定色で描画します
　『線幅』が「0以下」の場合は四角の内側を塗りつぶします
　"PIC"の画像を用意する手間が省けます

　指定位置に棒グラフ(横変化)を表示します
　主にゲームのHP表示などに使用します

　指定位置に棒グラフ(縦変化)を表示します
　主にゲームのHP表示などに使用します

　棒グラフの色を指定します

　グラフのスライド表示の有無を指定します
　※スライド表示すると、グラフの変化時に徐々にスライドして表示します
　『スライド有り』が「0」の場合表示無し、「1」の場合はスライド表示します

・サブウィンドウ画像設定
　@winsub_set(P1)

サブウィンドウのベースになるメイン画像ファイル名を設定します
このコマンドはサブウィンドウ画像のファイル名を設定するだけで表示は行いません。
サブウィンドウ画像はキャラ画像と同様に、透明色として緑色(RGB:0,255,0)を指定しています。
表示しない場所は透明色で塗りつぶしてください。


↓3つの四角のボックス(赤、青、緑)が「サブウィンドウ」です

↓上で表示している「サブウィンドウ画像ファイル」です。「透明色」の個所は表示されません

・サブウィンドウ表示
　@winsub_on()

設定されたサブウィンドウを表示します。

・サブウィンドウ非表示
　@winsub_off()

設定されたサブウィンドウを非表示にします。

・サブウィンドウ情報設定
　@wsub_txt_set(P1)

サブウィンドウに表示する内容を設定するファイルです。
設定内容は「winsub0.txt」を参照して下さい。

※このコマンドを複数回(最大10回まで)呼ぶ事で、追加で他のサブウィンドウ情報ファイルを設定する事が出来ます。

・サブウィンドウ情報全削除
　@wsub_clear()

設定されたサブウィンドウ画像と情報を全て未設定状態にします。

システム系

システム関係のコマンドです

※拡張シナリオEXEファイルは「expand」フォルダに置く必要が有ります。

コマンド一覧

・チャプター設定　@set_chapter()
・システムボタン無効設定　@button_dis()
・メッセージ表示固定　@msg_full()
・メッセージウィンドウ高さ変更　@change_msg_win_h()
・画面サイズ固定　@winsize_set()
・拡張シナリオ　@expand_exec()

・チャプター設定
　@set_chapter(P1)

チャプターを設定します。
チャプターとは「SAVE」「LOAD」画面にて記録されるセーブデータのタイトルです。
セーブデータの判別が分かりやすくなります。

↓セーブデータ(3行ある内の)2行目が設定された「チャプター」です

・システムボタン無効設定
　@button_dis(P1,P2)

指定された機能ボタンを有効/無効にする
ボタン種別：指定する機能ボタン名称　名称は以下の通り
SAVE：保存ボタン
LOAD：読み込みボタン
SKIP：スキップボタン
CONF：コンフィグ(設定)ボタン
END：終了ボタン
BACKLOG：履歴ボタン

↓画面下のボタンの列が「機能ボタン」です

・メッセージ表示固定
　@msg_full(P1)

メッセージ表示の種別(ウィンドウ表示、フルスクリーン表示)をコマンドで指定します。
シナリオ開始時にメッセージ表示の種別を固定し、以後はその設定でシナリオを進めます。

『フルスクリーン時』は、必ず「黒の半透明」のメッセージウィンドウになります。
『フルスクリーン時』は、「名前ウィンドウ」は表示しません。
『フルスクリーン時』は、コマンド「メッセージウィンドウ高さ変更：@change_msg_win_h()」で変更できません。

※シナリオ中は「コンフィグ」では指定不可ですが、当コマンドで変更します。
(注意)当コマンドを使用する時はシナリオの開始時に設定して下さい。

・メッセージウィンドウ高さ変更
　@change_msg_win_h(P1)

メッセージウィンドウの高さをコマンドで指定します。
最低値は「40」　最大値は「現在のゲーム画面高さ」です。
※注意：メッセージ表示が『フルスクリーン時』は、高さを変更できません。

・画面サイズ固定
　@winsize_set(P1)

画面サイズをコマンドで指定します。
シナリオ開始時に画面サイズを固定し、以後はその設定でシナリオを進めます。
(注意)当コマンドを使用する時はシナリオの開始時に設定して下さい。

・拡張シナリオ
　@expand_exec(P1)

「拡張シナリオ」とは、本ゲーム用に作られた実行ファイルを、シナリオ中に呼び出す為の物です。
※例えば「クイズ」「麻雀」など
拡張シナリオEXEファイルは「expand」フォルダに置く必要が有ります。

拡張シナリオにはパラメータで「共有メモリ」を設定する必要が有ります。
共有メモリは0～999までの番号が有ります。
※共有メモリに何を設定するかは、各拡張シナリオの説明を参照して下さい。

共有メモリに値を設定するには、フラグ設定、加算、代入を使用して下さい。
@set_flg(フラグ,設定値)：フラグ設定
@add_flg(フラグ,設定値)：フラグ加算
@copy_flg(コピー元フラグ,コピー先フラグ)：フラグ代入
フラグに「ESP:XX」とすると、フラグから共有メモリに設定出来ます。

拡張クイズ

↓拡張シナリオのクイズ画面の例

拡張シナリオのクイズ関係の説明です

※拡張シナリオEXEファイルは「expand」フォルダに置く必要が有ります。

説明一覧

・パラメータ設定
・問題作成/編集

・パラメータ設定

拡張シナリオ「クイズ」をシナリオで呼び出す時は、「システム系」のコマンド「@expand_exec()」を記述する必要が有ります。
そしてその前に、その拡張シナリオのパラメータもフラグで設定する必要が有ります。
設定するフラグは「ESP:共有メモリ番号」になります。

　ESP:0　:出題大番号　0～99　qXX.txt(ID=0ならq00.txを使用)
　ESP:1　:出題数　1～100　0:全て
　ESP:2　:ランダム出題　1:ランダム　0:登録順
　ESP:3　:合格ライン％　0～100(0なら必ず不合格)
　ESP:4　:背景情報ID　0～99(ID=0ならbak_00.txtを使用)
　ESP:5　:結果情報ID　0～99(ID=0ならrslt_00.txtを使用)
　ESP:6　:効果音情報ID 0～99(ID=0ならsnd_00.txtを使用)
　ESP:7　:終了種別 -1:エラー 0:不合格　1:合格
　　※終了種別はクイズ終了後の、結果取得用です


・出題大番号 　0～99
　出題するクイズの問題IDです。
　大番号が問題ファイルのファイル名になります。
　qXX.txt(ID=0ならq00.txを使用)
　問題ファイルは「expand\quiz\question」フォルダ下に有ります。
　　※クイズの問題は全400問付属：「日本史(q00.txt)」「世界史(q90.txt)」「古代生物(q93.txt)」「宇宙(q96.txt)」各100問


・出題数　　1～100　0:全て
　ファイル内に存在する問題から何問を出題するか設定します。
　「0」を設定すれば、ファイル内の全ての問題を出題します。

・ランダム出題　　1:ランダム　0:登録順
　「1」を設定すれば、問題をランダムに出題します。
　「0」ならば、登録順に出題します。

・合格ライン％ 0～100(0なら必ず不合格)
　正解率の合格ラインを設定します。
　「0」を設定すれば、必ず不合格になります。

・背景情報ID　　0～99(ID=0ならbak_00.txtを使用)
　IDによって背景情報ファイルを読み込みます。
　

・結果情報ID　　0～99(ID=0ならrslt_00.txtを使用)
　IDによって結果情報を読み込みます。
　

・効果音情報ID　　0～99(ID=0ならsnd_00.txtを使用)
　IDによって効果音情報を読み込みます。
　

・終了種別　　※クイズ終了後の、結果取得用です。
　クイズの正解率から結果を返します。
　0:不合格
　1:合格
　-1:エラーで終了時に返します。

・問題作成/編集

「nh_拡張02クイズ.exe」をダブルクリックすると、問題ファイル(qXX.txt)の作成、編集が出来ます。

↓メイン画面です。この画面で「問題作成/編集」ボタンを押してください

↓「クイズ実行」ボタンを押すと、この画面が出ます

各パラメータを入力すると、クイズのテストが行えます

↓この画面で問題作成/編集する「大番号」を選択します

まず、編集する問題の大番号を選択します。
画面上部に選択中の大番号が表示されます。
大番号を変更する場合、0～99の数字を変更できます。
コンボボックスで番号を変更し、隣の「番号決定」ボタンを押してください。

タイトルを入力(変更)したい場合は、画面中央部の入力エリアに入力してください。
タイトルは最大2行です。

問題表示サイズを変更したい場合は、「大/中/小」を選択できるコンボボックスで変更します。

「問題作成へ」ボタンで、問題作成(編集/追加)画面に移行します。

前の画面に戻る時は「メイン画面へ戻る」ボタンを押して下さい。

↓この画面で問題を編集します

編集ではなく問題の「追加」を行いたい場合は、画面上部の「問題「追加」へ」ボタンを押して下さい。

画面上部の中央に現在の問題小番号が表示されています。
編集したい問題を変更したい場合は、数字を変更して「番号決定」ボタンを押して下さい。
また、「前へ」「次へ」ボタンで前後の問題へ移行します。

問題入力エリアに変更したい問題を入力してください。
問題は最大3行です。

正解入力エリアに変更したい正解を入力してください。

不正解入力エリアに変更したい不正解を入力してください。
不正解は１～３まで有ります。
全て入力する必要はありません。

「編集する」ボタンで、問題ファイルに書き込みます。

大番号選択画面に戻る時は「大番号選択へ戻る」ボタンを押して下さい。

↓この画面で問題を追加します

追加ではなく問題の「編集」を行いたい場合は、画面上部の「問題「編集」へ」ボタンを押して下さい。

画面上部の左端に追加する問題小番号が表示されています。

問題入力エリアに追加したい問題を入力してください。
問題は最大3行です。

正解入力エリアに追加したい正解を入力してください。

不正解入力エリアに追加したい不正解を入力してください。
不正解は１～３まで有ります。
全て入力する必要はありません。

「追加する」ボタンで、問題ファイルに書き込みます。

大番号選択画面に戻る時は「大番号選択へ戻る」ボタンを押して下さい。