Tags： NVLMaker
#NVL脚本编辑器指令列表（一）
#一、通用参数列表 以下列出部分指令共用的参数，在指令参数列表中就不再重复列出。
##（一）trans相关
当出现“显示效果/消除效果”相关参数时，相关参数及可能的值如下表： 其中method包含了一部分使用DLL之后的切换效果，如较难实现可无视。
| 参数 | 值 | 说明 |
|---|---|---|
| time | 切换时间，毫秒，对不同指令该值具有不同的默认值 | |
| canskip | true/false | 效果是否可以点击跳过，默认是true |
| method | ①~⑩ | 切换效果 |
| ① | crossfade | 淡入，默认值 |
| ② | universal | 遮片 |
| ③ | turn | 翻页 |
| ④ | wave | 波纹 |
| ⑤ | ripple | 水面涟漪效 |
| ⑥ | scroll | 卷动 |
| ⑦ | mosaic | 马赛克 |
| ⑧ | rotateswap | 旋转切换 |
| ⑨ | rotatezoom | 旋转缩放 |
| ⑩ | rotatevanish | 旋转消失 |
| rule | 效果遮片图，当切换效果为universal时读取 | |
| from | left/right/top/bottom | 切换方向，当切换效果为scroll时读取 |
| stay | nostay/stayback/stayfore | 原图是否停留，当切换效果为scroll时读取 |
##（二）layer相关
当出现“层”相关参数时，可能的值如下表：
| 参数 | 值 | 说明 |
|---|---|---|
| layer | 指定图层 | |
| - | stage/base | 根据版本不同可能会有这两个值，不过都是指背景层 |
| - | all | 全部前景图层（0-8） |
| - | 0-7 | 立绘层 |
| - | 8 | 头像层 |
| page | 指定页 | |
| - | fore | 表页，默认值 |
| - | back | 里页 |
#二、图形化指令、参数列表
##（一）图像
###（1）显示背景
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @bg | |||
| - | 显示效果 | time=700 | 其他trans相关参数及默认值见上表 |
| - | storage | Y | 背景图片名 |
| - | clfg | false | 同时消除所有前景层 |
| - | hidemes | false | 同时消除对话框（及系统按钮） |
| - | convert | false | 图片反色效果 |
| - | grayscale | false | 图片去色效果 |
| - | mcolor | 蒙版色 | |
| - | mopacity | 蒙版色透明度 |
###（2）显示人物
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @fg | |||
| - | 显示效果 | time=500 | 其他trans相关参数及默认值见上表 |
| - | storage | Y | 人物图片名 |
| - | layer | 0 | 显示人物的图层编号 |
| - | pos | left/center/right | 人物显示位置 |
| - | left | 直接指定横坐标，仅当pos为空值时生效，未指定时，会自动取得当前图层的坐标 | |
| - | top | 直接指定纵坐标，仅当pos为空值时生效，未指定时，会自动取得当前图层的坐标 | |
| - | opacity | 图片透明度 |
###（3）显示头像
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @face | |||
| - | 显示效果 | time=100 | 其他trans相关参数及默认值见上表 |
| - | storage | Y | 头像图片名 |
| - | opacity | 图片透明度 | |
| - | fg | 同时显示人物立绘图片，不能调整位置，会自动取得指定编号图层的坐标 | |
| - | layer | 0 | 同时显示的人物立绘所用的图层 |
###（4）消除背景
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @clbg | |||
| - | 消除效果 | time=700 | 其他trans相关参数及默认值见上表 |
| - | clfg | false | 同时消除所有前景层 |
| - | hidemes | false | 同时消除对话框（及系统按钮） |
###（5）消除人物
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @clfg | |||
| - | 消除效果 | time=500 | 其他trans相关参数及默认值见上表 |
| - | layer | 0 | 可选0~8/all |
| - | clface | false | 同时消除头像 |
| - | hidemes | false | 同时消除对话框（及系统按钮） |
##（二）对话
###（1）对话框相关操作（无参数）
| 指令名 | 说明 |
|---|---|
| @dia | 显示一般对话框（uidia内的定义） |
| @scr | 显示大对话框（uidia内的定义） |
| @menu | 显示透明对话框（uidia内的定义） |
| @hidemes | 隐藏对话框（不会消除头像或改变对话框样式） |
| @showmes | 将隐藏的对话框显示出来（如隐藏对话框之后头像没有消除过，则头像仍会恢复显示） |
###（2）对话中常见的指令
| 指令名 | 说明 |
|---|---|
| [lr] | 等待点击、点击之后换行 |
| [w] | 等待点击、点击之后清空之前文字并继续显示下一段 |
| [r] | 单纯换行 |
| [l] | 单纯等待点击 |
| [indent] | 文字缩进 |
| [endindent] | 解除缩进 |
| [font color=0x000000] | 改变文字样式，编辑器支持直接插入如左格式的改变颜色代码 |
###（3）人名相关
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @npc | |||
| - | id | Y | 要显示的人物姓名，会以【姓名】格式显示 |
| - | color | 显示人名时所用的文字颜色，不指定时会使用人名列表namelist里的路人颜色 | |
| - | face | 同时显示头像图片 | |
| - | fg | 同时显示人物立绘图片，不能调整位置，会自动取得指定编号图层的坐标 | |
| - | layer | 0 | 同时显示的人物立绘所用的图层 |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @主角 | 显示内容为【f.姓+f.名】，文字颜色使用人名列表namelist里的主角颜色 | ||
| @其他人物名 | 取得人名列表namelist里定义的人物名，文字颜色并显示 | ||
| - | face | 同时显示头像图片 | |
| - | fg | 同时显示人物立绘图片，不能调整位置，会自动取得指定编号图层的坐标 | |
| - | layer | 0 | 同时显示的人物立绘所用的图层 |
###（4）等待
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @wait | KAG3原版指令 | ||
| - | time | Y | 等待时间（毫秒） |
| - | canskip | 是否可略过，不填默认为true |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @waitclick | KAG3原版指令 |
###（5）事件跳转&插入标签
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @jump | KAG3原版指令 | ||
| - | storage | 不填写时默认为同脚本 | |
| - | target | 不填写时默认为脚本开头 |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| *标签名 | |书签名 | KAG3原版指令 |
##（三）音声
###（1）播放音乐
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @bgm | 对应KAG3原版指令@xchgbgm | ||
| - | storage | Y | 音乐文件名 |
| - | overlap | 500 | 音乐切换时两首音乐的交叉时间 |
| - | time | 1000 | 音乐渐入时间（音量从0-满花费的时间） |
| - | loop | true | 是否循环播放，默认为循环播放 |
###（2）播放音效
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @se | 对应KAG3原版指令@playse/@fadeinse | ||
| - | storage | Y | 音效文件名 |
| - | buf | 0 | 播放编号（0为默认，1为语音） |
| - | loop | false | 是否循环 |
| - | time | 渐入时间，不填写时效果同@playse |
###（3）等待音效
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @ws | KAG3原版指令 | ||
| - | buf | 0 | 播放编号（0为默认，1为语音） |
| - | canskip | false | 效果是否可以点击跳过 |
###（4）停止音乐
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @stopbgm | KAG3原版指令 |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @fadebgm | KAG3原版指令 | ||
| - | time | 渐变时间 | |
| - | volume | 渐变音量 |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @fadeoutbgm | KAG3原版指令 | ||
| - | time | 渐变时间 |
###（5）停止音效
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @stopse | KAG3原版指令 | ||
| - | buf | 0 | 播放编号（0为默认，1为语音） |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @fadese | KAG3原版指令 | ||
| - | buf | 0 | 播放编号（0为默认，1为语音） |
| - | time | 渐变时间 | |
| - | volume | 渐变音量 |
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @fadeoutse | KAG3原版指令 | ||
| - | buf | 0 | 播放编号（0为默认，1为语音） |
| - | time | 渐变时间 |
##（四）选项
###（1）准备选项
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @selstart | 开始选项按钮定义（相当于backlay） | ||
| - | hidemes | false | 是否隐藏对话框、头像（并禁止右键操作） |
| - | hidesysbutton | false | 是否隐藏系统按钮（并禁止右键操作） |
###（2）按钮位置
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @locate | KAG3原版指令 | ||
| - | x | ||
| - | y |
###（3）选项按钮
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @selbutton | 在message1上显示选项按钮 | ||
| - | text | Y | 选项按钮上会显示的文字 |
| - | target | Y | 点下按钮后会跳转到的标签 |
| - | storage | 点下按钮后会跳转到的脚本文件名 | |
| - | exp | 点下按钮后会执行的TJS表达式 | |
| - | normal | 按钮一般状态下的图片，不填写则会使用界面配置表setting内的对应值，下同 | |
| - | over | ||
| - | on | ||
| - | enterse | ||
| - | clickse |
###（4）等待选项
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @selend | 将之前定义的按钮显示出来（相当于trans+wt） | ||
| - | 显示效果 | time=300 | 其他trans相关参数及默认值见上表 |
注：以下为编辑器界面未提供但NVL内可以使用的@selend的参数，优先级低。
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| - | timeout | 限时选项处理 | |
| - | outtime | 限时选项等待时间 | |
| - | storage | 超时后跳转去的脚本 | |
| - | target | 超时后跳转去的标签 | |
| - | timebar | 限时选项剩余时间倒计时槽 | |
| - | bgimage | 时间槽背景图形 | |
| - | bgx | 时间槽背景图形坐标 | |
| - | bgy | 时间槽背景图形坐标 | |
| - | bar | 时间槽图片 | |
| - | x | 时间槽坐标 | |
| - | y | 时间槽坐标 | |
| - | width | 时间槽宽度 |
###（5）消除选项
| 指令 | 参数 | 是否必须/默认值 | 说明 |
|---|---|---|---|
| @clsel | 选择过后使用，将选项按钮消除并将对话框、系统按钮复原 | ||
| - | 显示效果 | time=100 | 其他trans相关参数及默认值见上表 |