後ろの数値を、前の数値から引きます。
命令の引数として計算結果が使われます。

数字ｘ１ミリ秒分待ちます。クリックで飛ばせます。
数字は普通の数字でなければなりません。変数を使いたいときは、
delay命令を使ってください。

一文字あたりの表示速度をミリ秒単位で指定します。
数字は普通の数字でなければなりません。変数を使いたいときは、
textspeed命令を使ってください。

上のメニューから選ばれた、「低速」「普通」「高速」の文字速度にあわせます。それが数字で何にあたるのかはdefaultspeed命令で設定できます。

数字ｘ１ミリ秒分待ちます。クリックで飛ばせません。
数字は普通の数字でなければなりません。変数を使いたいときは、
wait命令を使ってください。

文字の色を変えます。HTMLで指定するのと同じ形式です。
（つまり、１６進数で二桁づつ６ケタで指定、ということ。
　#000000が黒、#ffffffが白、#ffffaaが、白っぽい黄色になります。）
変えたら以後変わりっぱなしなので注意してください。

文字変数$0～$999まで1000個存在します。
0番から199番までが普通の変数で、200番から999番までがグローバル変数です。
普通の変数は、ゲームを終了する、もしくはreset命令などで動作を最初に戻すと値が消えますが、グローバル変数は消えません。
普通の変数の値は、セーブ時にセーブファイルに記憶され、ロード時にその値が復元しますが、グローバル変数ではそうなりません。
具体的には、例えば、普通の変数は好感度に、グローバル変数はクリアフラグに、といった使い方がいいでしょう。
ただし、グローバル変数を使う場合は、命令globalonを定義ブロックで実行しておかなくてはなりません。
文字変数の初期値は""（一文字もない）です。

mov $0,"文字列"

lsp 0,":s;#ffffff" + $0,0,0

通常は文字変数ですが表示文中にあればその文字変数の中身を表示します。

数字変数%0～%999まで1000個存在します。
0番から199番までが普通の変数で、200番から999番までがグローバル変数です。
普通の変数は、ゲームを終了する、もしくはreset命令などで動作を最初に戻すと値が消えますが、グローバル変数は消えません。
普通の変数の値は、セーブ時にセーブファイルに記憶され、ロード時にその値が復元しますが、グローバル変数ではそうなりません。
具体的には、例えば、普通の変数は好感度に、グローバル変数はクリアフラグに、といった使い方がいいでしょう。
ただし、グローバル変数を使う場合は、命令globalonを定義ブロックで実行しておかなくてはなりません。
数字変数の初期値は0です。

mov %0,1

lsp %0,":s;#ffffff文字列",0,0

通常は数字変数ですが表示文中にあればその数字変数の中身を表示します。

ルビ有りを示す

*define
rubyon
game
*start
setwindow 10,10,20,20,24,24,0,12,0,1,1,#ffffff,0,0,639,479
ルビ機能の(暫定仕様/ざんていしよう)です。@
ｒｕｂｙｏｎ時、(文字/もじ)は(下詰/したづめ)で表示されます。@
(縦/たて)の(字間/じかん)を、ルビが入る分とって下さい。@
「(承/うけたまわ)」る、とか、「(論理的/ロジカル)」みたいに、文字幅をあわせようとする機能がついてます。
ルビは折り返し改行されませんのでご注意ください。\
end

*で始まる文はラベル名です。gotoなどの飛び先として使います。
ラベル名に使える単語の一文字目は半角のアルファベットと"_"（アンダーライン）、それ以降はアルファベット"_"（アンダーライン）数字の組み合わせです。

　　正しい例）　*HAJIMARI
　　　　　　　　　*Mike_Tom
　　　　　　　　　*day01

　　誤った例）　*始まり　　（全角文字を使っている）
　　　　　　　　　*Mike&Tom　（アンダーライン以外の記号を使っている)
　　　　　　　　　*01day　　　（一文字目から数字）

*asterisk

後ろの数値を、前の数値と掛けます。
命令の引数として計算結果が使われます。

csel命令を実行すると、自動的にこのラベルにジャンプする。このラベル後に選択肢表示の処理を実装する。

*customsel
skipoff
*csel_st
btndef clear
getcselnum %0
getcursorpos %1,%2
cselbtn 0,500,%1,%2
add %2,21
cselbtn 1,501,%1,%2
if %0>2 add %2,21:cselbtn 2,502,%1,%2
if %0>3 add %2,21:cselbtn 3,503,%1,%2
if %0>4 add %2,21:cselbtn 4,504,%1,%2

*csel_loop
selectbtnwait %0
if %0=-2 systemcall lookback:goto *csel_loop
if %0=-1 gosub *rclk:goto *csel_st
if %0>=500 & %0<=504 saveon:sub %0,500:cselgoto %0
goto *csel_loop

定義ブロック開始を示す特殊なラベルです。

*define
game

実行ブロック開始を示す特殊なラベルです。

*start
end

これのすぐ後に改行を書けば、その改行は無視されます。

前の数値を、後ろの数値で割ります。
命令の引数として計算結果が使われます。

:（コロン）でつなげることによって、一行にたくさんの命令文を書くことができます。これは、if文で威力を発揮します。

btnwait %0
if %0=-1 allsphide:systemcall lookback

;で始まる文はコメントです。NScripterはこの文を読み飛ばします。

defsub abs ; 渡された変数を絶対値に変換する

以下の設定は、大文字小文字を区別しません。
一行目に;$で、その行は設定モードになります。
V数　で変数の数を設定します。0スタートなので、与えた数-1が最大の変数番号になります。
G番号　で最小のグローバル変数の番号を設定します。
S幅,高さ　で画面サイズを指定します。ワイドスクリーンでもいけます。
L数　でラベルの最大数を設定します。この数値はファイルログの最大数も兼ねています。初期値10000なので、よほどの事がない限りいじる必要はないかと。

;$V2000G1000S800,600L10000

配列変数を使うにはdim命令を使います。
配列変数は?0～?199まで200個定義できます。
グローバル変数として使うことはできません。

クリック待ちをします。

表示直前にgettagで取得できる情報を指定できます。

[太郎/0001.wav]「太郎の台詞」

これのすぐ後に改行を書けば、その改行は無視されます。

表示文字列の中で変数に値を代入できるようになりました。
{}で囲んで、その中で変数名,値を指定すると、その値が変数に代入されます。
ただし、エイリアスは使えません。
{変数名,値,変数名,値}のように、複数個書くと、それらの代入操作が全て実行されます。

jumpf命令とjumpb命令で使う飛び先です。
jumpf命令、jumpb命令と~記号の間には表示文章を置かないようにしてください。

改ページ待ちをします。直後の改行は無視されます。

後ろの数値または文字列を、前の数値または文字列を足します。
数値同士、文字列同士でないとエラーとなります。
命令の引数として計算結果が使われます。

mov ?0[0],?0[0]+1

mov $1,"●"
mov $2,"あいうえお"+$1+"さしすせそ"
;これで、$2は"あいうえお●さしすせそ"になります。

mov $0,"テスト"
mov $0,$0+"あいうえお"
;これで$0は"テストあいうえお"になります。

<と>で囲んだ文字列をテキストボタンに設定します。
テキストボタン番号は省略可能です。

setcursorとほぼ同じなのですが、こちらの座標指定は、文字との相対座標ではなく、画面上の絶対座標としての指定です。

変数に変数を加えます。文字の場合は連結です。

add %0,6

add $5,"ああああ"

文字列を、行頭禁則文字列,行末禁則文字列の順で指定することで、
現在の禁則文字列に設定を追加します。define節専用です。

一文字だけでも設定できますし、複数並べれば、
それらが全て禁則文字になります。

nsaアーカイブを読み込むディレクトリを追加します。

拡張スプライト全体の表示を一時的にマスクすることが出来ます。allsphide allspresumeと使い方は同じです。

拡張スプライト全体の表示を一時的にマスクすることが出来ます。allsphide allspresumeと使い方は同じです。

すべてのスプライトを一時隠します

allsphide

allsphideで隠したスプライトを表示します

allspresume

mspと似ているが、こちらは増分ではなく絶対指定。

amsp 2,5,2,100

拡張スプライトの移動命令です。msp2は現在値からの相対指定、amsp2は値そのものの指定です。

amsp2 0,10,20,10,10,5

アーカイブ展開プラグインを指定します。
書式は、"アーカイブファイル名|関連付けＤＬＬ名"です。
画像、音声はアーカイブ対応していますが、スクリプトはしていません。

レジストリを読みに行く命令と組み合わせることで、いろいろな指定ができるようになります。

arc "arc.sar|scrunarc.dll"

getreg $0,"software\leaf\toheart","datadir"
add $0,"\lvns3dat.pak|axlfpak.spi"
arc $0

文字列を数字に変換します。Ｃ言語の同名関数と同じです。

atoi %0,"123"
atoi %3,$0

クリック待ちが指定時間（ミリ秒）たつと勝手に進むようになる、デモなどに便利な命令です。
０を指定すれば、設定が無効になります。

商用ソフト「銀色」のために作った命令です。
この命令を実行すると、メニューに「オートモード」がつきます。
オートモードは「次の選択肢まで進む」に似ていますが、ウェーブが
なりおわるまで先には進まず、ウェーブがないところでも、下のautomode_time命令で
どのくらいクリックまでに待つか指定することが出来ます。
いわゆる読み上げモードですね。

メニューからボリューム変更ダイアログが
使えるようになる。（MP3(BGM) voice(DWAVE 0) SE(DWAVE 1～)のボリュームを
いじれるようになりました。）
この辺の拡張機能の追加についてはもうちょっとすっきりした命令を作る予定
（今有効な命令は将来的にもちゃんと使えます。）

上のmode_extで増える「オートモード」のとき、ウェーブがなっていないときに　どのくらい待つのかをミリ秒単位で指定します。

表示文頭以外の自動のセーブポイント更新を停止します。
*define節で
autosaveoff
とすることで、saveon/saveoff命令は無視されるようになります。
（表示文頭ではセーブポイントは従来通り更新されます）。
表示文頭以外でセーブさせたい場合（たとえばクリッカブルマップなど）では、手書きでsavepoint命令を呼び出してください。タイミングによってはデータがうまく復帰できなかったりするので、画面全体を読み込んで描画する直前をセーブポイントにするとか、うまく工夫してください。

指定AVIファイルを画面一杯に再生します。
数字が１のときは、クリックすれば再生を中止して、次の処理へ移ります。
０のときには、最後まで再生し終わるまで、処理をスクリプトに戻しません。

バー表示指定をします。幅と高さは、バーが最大値であったときの値です。
　最大値に満たない場合は、割合に合わせてバーが短くなります。
　バーは左詰表示です。単純に長さにあわせて指定した色で塗りつぶすだけなので、
　値が足りないときの地の色は、元絵のほうで描いてしておいてください。
　なお、指定した後でprint命令などの表示処理を実行しないと、画面に反映されません。

バーの設定をクリアします。　バーとは、格闘ゲームの体力バーみたいなもののことです。

ボタン定義をクリアする。

bclear

デフォルトではbexecはカーソルキーとスペース／リターンをボタン間の移動とボタンの決定に使うようになりました。
カーソルキー入力を得たい場合はbclearとbexecの間にbcursor命令を入れてください。

どのスプライトとも重なっていないときの処理を指定する。これもexbtnやspstrに指定するのと同じ文字列

bdef "C0" ;どれとも重なっていない場合はスプライト０番を非表示にする。

bclear命令とbexec命令の間にbdown命令を入れると、左クリックを押し下げたときに処理が戻るようになりました。

ボタン処理を実行する。引数は文字列変数と数値変数、もしくはその両方が選べる。

bclearを実行するまで設定は残っている。
btimeを実行するまでは経過時間とタイムアウト時間の設定も残っている。

文字列変数に戻る値：
どのスプライトでもないところが左クリックされた場合……"LCLICK"が返ります。
スプライトが左クリック場合……"S(スプライト番号)"が返ります。たとえばスプライト１２番なら"S12"が返ります。
タイムアウトした場合……"TIMEOUT"が返ります。
右クリックされた場合……"RCLICK"が返ります。
中クリックされた場合……"MCLICK"が返ります。
ホイールアップ／ダウンされた場合……"WHEELUP" "WHEELDOWN"が返ります。
キーが押された場合……それぞれに対応した文字列が返ります。英字は大文字で返ります。
　・英字１文字、数字はそのまま返ります。
　・"SPACE"　スペースキー
　・"RETURN"　リターンキー
　・"CTRL"　コントロールキー
　・"UP" "DOWN" "LEFT" "RIGHT" カーソルキー上下左右
　・"F1"～"F12" ファンクションキー
　・"PAGEUP" "PAGEDOWN" ページアップ、ダウンキー
　・"SHIFT" シフトキー

数値変数に戻る値：
スプライトが押されたときにそのスプライト番号を得る。それ以外の場合は-1が返る。

どの値が入力されても戻るので、必要のない値を受け取った場合はbexecに処理を戻してループすること。

bexec $0,%0

背景画像をロードします。一番上がファイルから、二つ目が単色での塗りつぶし指定、一番下が、黒、もしくは白での塗りつぶし指定です。

特殊なサイズの背景を使いたいときに指定します。
x,yの位置から、width x heightドットの画像を置く、ということになります。

bgcpyでも同じ意味になります。現在の画面を背景画面として取り込みます。
ofscpyもしくはofscopyとの違いは、背景画面になっているので、この上にテキストウィンドウなどを表示できることです。

圧縮された音楽ファイルをループで演奏する。mp3loop命令と同じ意味です。

bgm "bgm01.mp3"

音声再生時にＢＧＭボリュームを下げる。

bgmdownmode 1

bgmfadeoutと同じ要領で、フェードインの設定をします。

BGMのフェードアウトの時間を指定
define節でも実行節でも使えます。

圧縮された音楽ファイルを一度だけ演奏する。mp3と同じ意味です。

bgm "bgm01.mid"

圧縮された音楽ファイルの演奏を停止します。

bgmのボリュームを変えます。bgm命令とmp3命令で有効です。

bgmvol 100

高速に画面上で画像表示をしたいとき（ＡＩＲのオープニングのようなアニメーション処理）に使う命令です。
　ボタン画像バッファを利用しますので、事前にbtndefで画像を読みこんでください。
　ボタン画像から読んでくる元画像の幅が画面上の幅と違うときは、画面にあわせて画像が拡大縮小されます。
（例えば、全画面のＸＹ半分のサイズの画像を４つ描いたものをロードしておいて、高速に拡大しながら画面全体に表示していくと、残像効果でドットの荒さは見えず高速なアニメに見える、というテクニックがＡＩＲでは使われています。）
　この命令はバッファを介さず直接スクリーンに画像を書きます。よって、終わった後は画面データが不定になるので、下のofscpy命令を使った後、必ず別の画像をふつうのbg命令などで呼び出して、画像を確定してください。

　セーブによっても、この命令の結果としての画像がセーブされたりはしません。
　よって、使われる部分は限られてきます。（デモとか、ＳＬＧでの小窓アニメなど、間にセーブやコマンド入力が挟まれないような処理）

画像ファイルを指定された分割数に分割してBMP形式で保存します。

bmpcut "test.bmp",3,2

一行、文字表示を改行する命令です。空行をはさみたいときに使ってください。

一番内側のループをひとつ、途中で抜け出します。
すぐ下のNEXT文を探し、その下へ抜けます。

二重ループを一気に外まで抜けることはできません。
一重めのループをBREAKで抜けた後、さらに次のBREAKを書いてください。

【お勧めしない使い方】
BREAK *ラベル名
BREAK文に*ラベル名があればそのラベルに飛びます。
ただし、ラベル指定でふたつのループを抜けても内部的には
一番内側のひとつしかループ状態を解除しません。
先述のとおり、そういう使い方はスタックを無駄遣いするのと
ソースを見難くするのでお勧めはしません。

*define
game
*start
for %0=1 to 8
for %1=6 to 2 step -2
%0，%1
if %0=4 & %1=4 break
next
next
click
end

スプライトをボタンとして設定する。
パラメータを省略すると、マウスを重ねたときにセル１、マウスをはずしたときにセル０、マウスをクリックしたときにセル２（セルがみっつ以上ある場合のみ）になる。
パラメータを三つ指定できる。それぞれexbtnやspstrに指定するのと同じ文字列で、順に「マウスが重なっていないときの処理」「マウスが重なっているときの処理」「マウスを押したときの処理」になる。
文字列には""を指定できるので、何もしないときには""にすること。

bsp 1 ;スプライト１番をボタンにする
bsp 2,"P3,0","P3,1","P4,1" ;スプライト２番をボタンにする。それぞれ重なっていないとき、重なったとき、押したときの処理を記述している。

ボタン処理を開始してからタイムアウトする時間を指定する。
時間の後で,1とすると、時間が経過していてもボイス（dwaveチャンネル０）が再生し終わるまで待つ。これはオートモード等に使う。

btime 2000 ;２秒後にタイムアウトする。
btime 1000,1 ;１秒後にタイムアウトする。１秒を過ぎてもボイスが終了していなければ待つ。

左から順に、ボタン番号,x,y,wd,ht,x3,y3です。
ボタンの定義命令です。ボタン番号>0です。
ゲーム画面上の(x,y)を左上として、サイズwd * htの範囲をボタンとして指定します。
その上にマウスカーソルがのると、ボタン画像ファイルの(x3,y3)を左上の点とする画像が表示されます。
くわしくは、フォルダbtndemoにある説明.txtを参照下さい。

btndefの下で使ってください。
負ならば絶対値を取って、その数以上、正ならばその数以下の位置にカーソルが来たときに、ボタン命令で-4を返します。

btndef clear
btnarea -400

ボタン画像ファイルを設定します。これを使うと、以前のボタン定義はクリアされます。
くわしくは、フォルダbtndemoにある説明.txtを参照下さい。

btndefとbtnwait系命令の間に挟んでください。
そのボタン命令において、ボタンの押しっぱなしを取得できるようににします。

btndown 1

ボタン時にテキストウィンドウが消えなくなります。

btnnowindowerase

次のbtnwaitもしくはbtnwait2の時間制限をミリ秒で指定します。この命令を使った直後のボタンモードで、何も押されずに指定した時間が過ぎると、 btnwait系命令は-2を返します。

btntimeとほぼ同じだが、ボイスの発生終了まで待つ

btntime2 1000

実際にボタン処理します。数字変数に結果が戻ります。

戻り値：
０…どのボタンでもないところをクリックした
－１…右クリックした
その他…ボタン番号

戻り値が０以下（ボタンを押していない）ときは、すぐにもういちどbtnwaitを呼べば、また同じボタンモードに。
戻り値が１以上（実際にボタンを押した）ときは、押された瞬間の画像のままで、ボタン定義は全てクリアされます。（メモリ節約のため）
くわしくは、フォルダbtndemoにある説明.txtを参照下さい。

実際にボタン処理します。数字変数に結果が戻ります。

戻り値：
０…どのボタンでもないところをクリックした
－１…右クリックした
その他…ボタン番号

btnwait命令と違って、ボタン定義はクリアされません。だから、ボタン画像ファイルは読まれっぱなしです。
ボタン処理が終わって、ボタンが要らなくなったら、他の処理がメモリを使えるように、btndef ""でボタン定義をクリアして、ボタン画像を解放しておくことをお勧めします。

bclear命令とbexec命令の間にbtrans命令を入れると、ボタン画像の透過部分には反応しなくなりました。

渡された文字列_w.bmpと渡された文字列_b.bmpからNScripter形式の透過画像を作ります。
付属しているbw2aconv.exeと同じ動作です。

＜豆知識＞
コマンドプロンプトから
dir /b > filelist.txt
とかをやるとファイルリストが取れるので、
それと組み合わせて一括変換に使うといいでしょう。

bw2a "test"

白抜きと黒抜きから、NScripter形式の透過画像を作ります。
製作作業用の命令です。
nscripterと同じ位置にフォルダ"b"とフォルダ"w"を作り、それぞれ白抜きと黒抜きを入れてください（白抜きと黒抜きについてはbw2aの説明をご覧ください）
ファイル名は元と同じでいいのがミソです。フォトショップのアクションを使えば作業が効率化できるでしょう。

bw2a3 "test.bmp"

ウィンドウのタイトルを変えます。

ＣＤのフェードアウトに掛ける時間をミリ秒単位で指定します。

手動でスプライトのセルを指定します。内部状態を切り替えるだけなので、あとでprintなどで画面に反映してください。

cellcheckspbtnのexbtnバージョンです。引数はexbtnと同じです。
スプライトがロードされ、かつ、セルが二つ以上あるときのみ拡張ボタンとして設定します。そうでないときは無視されます。
なお、exbtnについては「サンプル」「メニューのカスタマイズと複合ボタン」を参照してください。新機能S（音声再生）とM（スプライト移動）が増えています。

cellcheckexbtn 1,100,"P1,1P2"

基本的にはspbtnと同じですが、セルが二つ以上ない画像の場合は無視されます。
これはＣＧモードのときに有効に使えます。
（つまり、サムネイルはセルがひとつだけにしておけば、
　spbtn登録はループで一気に行える）

for %0=0 to 9
  cellcheckspbtn %0,%0+1
next

out.bmpの隣にその画像ファイルを貼り付けていきます。
out.bmpが無ければ作成します。

キーの押下状態を取得します。
文字列には、英字１文字、数字、スペースなどはそのまま指定できます。
"SPACE"でもスペースキーは取得できます。
"RETURN" "ENTER" リターンキー
"CTRL" コントロールキー
"UP" "DOWN" "LEFT" "RIGHT" カーソルキー上下左右
"F1"～"F12" ファンクションキー
"PAGEUP" "PAGEDOWN" ページアップ、ダウンキー
"SHIFT" シフトキー
を指定します。

checkkey %1," "

回想文字列を取得できるかどうかを調べます。
第一引数は結果を格納する数字変数、第二引数は何ページ前かを指定します。
1で取得可能、0で不可能です。第二引数には１以上を指定してください。
０は現在のページなので、この関数を使わなくても処理できるはずです。

checkpage %5,1

これで、「ファイル名」のファイルがあるＣＤドライブを検索します。
もしＣＤが入っていなければ指定した文字列のエラーポップアップを表示します。
ボタンは「再試行」と「キャンセル」です。

chkcdfile "file.dat","CDがありません"

これで、「ファイル名」のファイルがあるＣＤドライブを検索します。
もしＣＤが入っていれば１、なければ０を返します。

chkcdfile_ex %0,"file.dat"

dwaveチャンネルのボリュームを変えます。

chvol 3,100

その位置の立ち絵を消します。
aはすべて消すことを意味します。

クリックを待ちます。

クリック待ちをして、クリックした位置を取得します。Ｘ座標、Ｙ座標です。

通常、クリックによってメッセージが次のクリック待ちまで瞬時表示になりますが、この時、通常クリック待ちではなくそのページの改頁待ちまで一気に飛ぶようにします。
define節専用命令です。

強制クリック待ち機能をオンにします。これを実行すると、特定の文字を表示したらクリック待ちするように作れます。
ただし、その直後に本来のクリック待ち文字がある場合、もしくは、強制クリック文字の前に_（半角アンダーバー）がある場合は、強制クリック待ちはされません。
強制クリック待ち時に、単なるクリック待ちか改ページになるかは、二番目のパラメータが決めます。（最大行－数字）よりも下で強制クリック文字を見つけたときは、改ページになります。
この機能は、作業の簡便化には役立つのですが、次の一行が非常に長く、数字設定よりも上の行から始まって字がはみ出すような現象を防ぐことまではできません。
その場合は、そこだけ本来の改ページ文字を使うか、数字を変えてください。文字列は全角文字のみ許されます。

clickstr "」。！？",2

クリック待ちでクリックしたときになるWAVEファイルを指定します。
順に、普通のクリック待ち、改ページクリック待ち、です。

文字列同士を比べて、等しければ０、等しくなければそれ以外を、数字変数に代入します。
右のほうが大きい場合、負、左のほうが大きい場合、正が帰ります。

三角関数cosθを取得します。
値は１０００倍されたものが返ってきます。

cos %1,60
;%0=1000になる。

指定された名前でダミーBMPファイル(640.480)を作ります。
真っ白背景に黒字でファイル名がでかでか書かれます。

createdummy "test.bmp"

システムカスタマイズ時の選択肢命令。*customselを呼び出すために使う。書式はselectと一緒。

csel "選択肢１",*s1,"選択肢２",*s2,"選択肢３",*s3

選択肢のテキストでボタンを作る。文字列とスプライト番号の指定が不要。

cselbtn 0,500,%1,%2

cselで設定したラベルへ飛ぶ。

cselgoto %0

そのスプライトを消去します。
-1を指定すると、すべてのスプライトを消去します。

拡張スプライトを消去します。

csp2 0

csvファイルを閉じます。この命令で閉じないと開きっぱなしですので、使い終わったら閉じるようにしてください。

csvclose

（読み取りモード専用です）
csvファイルを最後まで読み終わっていれば1、終わっていなければ0を返します。

csveof %1

csvファイルを開きます。一つ目の文字列はファイル名です。
nsaの中に格納しているファイルも読み出すことが出来ます。
二つ目の文字列は、モード指定です。次のように指定します。
"r"……読み取りモード。通常のcsvファイルを読みます。
"rc"……暗号化csv読み取りモード。wcで書き込んだcsvファイルを読みます。
"w"……書き込みモード。csvファイルに書き込みます。
"wc"……暗号化書き込みモード。csvファイルを暗号化して書き込みます。

csvopen "test.csv","r"

csvopen "angou.csv","wc"

（読み取りモード専用です）
csvファイルからデータを読み出します。指定した順に読み取ります。

csvread $0,$1,%0,%2

（書き込みモード専用です）
csvファイルにデータを書き込みます。指定した順に書き込みます。

csvwrite 12,"test",%1,$2

マシンの現在の年月日を取得します。

デバッグウィンドウに表示される文をdebuglog.txtというテキストファイルに保存していくことが出来る命令です。
debuglog 1でオン、debuglog 0でオフです。define節でもstart以降でも使えます。

その変数の値を１減らします。

デフォルトのフォントを指定します。
指定しなければ、ＭＳ ゴシックが使われます。

特殊表示文字!sdまたはtextspeeddefault命令を呼び出したときの時の文字速度の指定です。
左から順に、メニューから「低速」「普通」「高速」を選んだときの速度です。

defaultspeed 50,20,0

BGMのデフォルトボリュームをいじれます。デフォルトでは１００（０から１００です。）

定義リセット命令です。*define節から読みなおします。

mov %200,1
definereset

MP3(BGM)のデフォルトボリュームをいじれます。デフォルトでは１００（０から１００です。）

SE(DWAVE 1～)のデフォルトボリュームをいじれます。デフォルトでは１００（０から１００です。）

指定した名前のユーザ定義命令を作ります。
実際にはサブルーチンとして実装されます。
命令名は変数と同じ法則で名づけることが出来ますが、先頭に_を使うことだけは出来ません。

defsub subname

以降のスクリプトで
subname
とあると、
*subname
にgosubジャンプする。

voice(DWAVE 0)のデフォルトボリュームをいじれます。デフォルトでは１００（０から１００です。）

数字ミリ秒分だけ、待ちます。クリックで飛ばせます。
特殊表示文字dと同じですが、変数を引数に使えます。

NScrからWindowsのメニューバーをなくせます。

deletemenu

メモリ内に確保したスクリーンショットを削除します。
savescreenshot2命令と組み合わせて使います。

deletescreenshot

配列変数はBASIC式です。つまり、この宣言だと、?0は、
一次元目が0～10の、二次元目が0～20の添字を使えます。

例のとおり、今まで「数字」となっていたところならどこでも
配列変数を使えます。

mov ?0[2][5],20
;?0[2][5]に20を代入。
mov %4,?0[3][1]
;%4に?0[3][1]を代入。
？０［２］［３］＝?0[2][3]@
;値を表示

numalias enemyparam,10
dim ?enemyparam[10]

その変数を、数字で割ります。整数、小数点以下切り捨てで答えが出ます。

draw系命令で描画した画像を実画面に転送します。
これがないと表示されません。

*test
saveoff
;デモ処理はsaveoffしたほうが速くなります。終わったらsaveonを忘れずに
mov %0,0
bg "bg.bmp",1
*lp
resettimer
drawclear
drawbg2 320,240,100,100,%0*2
draw
wait 5
;ウェイトを多少いれないと、メッセージ処理が遅れがちになります。
gettimer %1
if %1>=50 add %0,%1/50
if %1<50 waittimer 50:inc %0
;掛かった処理時間に比例して変数を変化させます。
goto *lp

ＢＧ画面を描画します。

drawbg

ＢＧ画面を描画します。(x,y)で位置を指定します。
x_scale、y_scaleは、縦横の拡大率です。単位は％です。
rotは回転の角度です。反時計回りで、単位は度です。
なお、はみ出た部分は描画されないので前の画像が残ります。
それではまずい場合は、事前にdrawclearなどで消しておいて下さい。

drawbg2 320,240,200,300,15

画面を黒く塗りつぶします。

drawclear

画面をその色で塗りつぶします。
ＲＧＢで、それぞれ０～２５５を指定します。

drawfill 255,0,128

スプライトを描画します。
スプライト番号、セル番号、透過度、表示先左上x座標,表示先左上y座標を指定します。
通常モードでのスプライトの位置、表示非表示は関係ありません。
スプライトやテキストウィンドウは、新しく書いたほうが上へ重なります。

drawsp 2,1,128,20,40

スプライトを描画します。
スプライト番号、セル番号、透過度、表示先中心x座標,表示先中心y座標を指定します。
通常モードでのスプライトの位置、表示非表示は関係ありません。
スプライトやテキストウィンドウは、新しく書いたほうが上へ重なります。

drawsp2 2,1,128,20,40,150,60,-10

drawsp系の命令で、一次変換を実現するものです。
スプライトを描画します。
スプライト番号、セル番号、透過度、α値、表示先中心x座標,表示先中心y座標、行列の要素左上、右上、左下、左下の順で指定します。
行列の要素は実際の１０００倍の値になります。

drawsp3 2,1,128,20,40,1500,300,800,1200

テキストウィンドウを描きます。
これより前に書いたスプライトは下に、後に書いたスプライトは上に来ます。

drawtext

define節で使います。DirectSoundを使うことを宣言します。この命令を使うには、DirectX2もしくはそれ以降が必要です。 (この命令は現在のバージョンでは使う必要がなくなっています）

ボイスを入れるときに便利な命令です。
dwave 0,"wav\数字.wav"と等価です。

dv0001:「これが０００１番のせりふだよー」

DirectSoundでＷＡＶファイルを演奏します。
数字はチャンネルＮＯで、０から４９までです。
違うチャンネルの音はミキシングされて同時再生されます。
なお、オートモードでの再生終了待ちはチャンネル０で行います。
再生できるのはＰＣＭ形式だけです。
wave系命令と同時に使用することも出来るので、たとえばMP3コーデックでの ＢＧＭをwaveloop命令で鳴らしつつ、こっちで音声再生という使い方が出来ます。

dwave 0,"test.wav"

演奏前にWAVをメモリにロードしdwaveplay dwaveplayloopで再生します

dwaveload 0,"test.wav"
dwaveplay 0

dwaveと同じ書式ですが、こっちはループ再生します。

dwaveloadでメモリにロードしたWAVを一度だけ再生します。

dwaveloadでメモリにロードしたWAVをループで再生します。

そのチャンネルの再生を止めます。

エフェクト番号に、効果を割り当てます。
画像表示命令には、ここで指定したエフェクト番号を使ってください。
左から順に、エフェクト番号、効果番号、掛ける時間（単位ミリ秒）、パターン画像名です。
ただし、効果番号によっては、後ろの二つは省略されることもあります。

エフェクト番号０番は、「表示せずに、次の画像命令でいっしょに表示する」という意味で予約されているので、１番以降を使ってください。
なお、エフェクト番号０を使った場合は、なるべく早くほかの画像表示命令で画像を表示してください。

デフォルト指定で、１が瞬時表示にしてあります。

＜効果番号一覧表＞
　１　瞬時表示。時間指定はいりません。
　２　左シャッター
　３　右シャッター
　４　上シャッター
　５　下シャッター
　６　左カーテン
　７　右カーテン
　８　上カーテン
　９　下カーテン
１０　ピクセル単位のクロスフェード
１１　左からスクロール
１２　右からスクロール
１３　上からスクロール
１４　下からスクロール
１５　マスクパターンによるフェード。
　　　第三パラメータに文字列でマスク画像名を指定します。
　　　マスク画像の形式は256色でもフルカラーでもかまいません。
　　　サンプルで置いてあるm1.bmp,m2.bmpでためしていただければわかると
　　　思いますが、マスク上で白いところほど遅く、黒いところほど速く
　　　表示されます。
　　　マスク画像が小さいときは、壁紙のように四方に並べて640x480ドットに
　　　敷き詰められます。
１６　モザイクアウト。この命令のあとは、指定された画面をエフェクト番号０
　　　でロードしたときと同じで、不定状態です。必ず、直後にほかの命令…
　　　たとえばprintなどを使って、画像を表示しなおしてください。
１７　モザイクイン。
１８　マスクパターンによるクロスフェード
　　　１５番では、単に、マスクの濃度による時間差でピクセルがコピーされる
　　　だけでしたが、こっちは、時間差クロスフェードします。
　　　各社ではやっている演出効果ですが、マシンへの負担が、全エフェクトで
　　　一番大きいので、遅いマシンでは、少し荒くなるかもしれません。

effect 2,4,1000

effect 3,15,2000,"m3.bmp"

エフェクト終了後、次の命令の実行までにどれだけの間を取るかをミリ秒単位で指定します。
エフェクトが瞬時表示(1)である場合、この設定に関係なく、瞬時に表示されます。

「選択肢までとばす」の時、エフェクトをすべて瞬間表示にします。

エフェクト中にクリックをしたらエフェクトがスキップされるかどうかを指定します。
デフォルトでは１（スキップする）になっています。０にするとスキップしません。

effectskip 1

プログラムを終了し、ウィンドウを消します。

yesnobox %0,"今日はもう終わり？","終了確認"
if %0==1 end

NScripterを英文モードにします。半角英字のみの文章を正しく表示できるようになります。
このモードを使う時は、行頭を>にしてください。

*define
english
game
*start
>Peter Piper picked a peck of pickled peppers;@
end

テキストボタンを押してボタンモードを抜けたとき、押されたままになりますが、そのテキストボタンを消して元通りの色にします。