一、通用参数列表
以下列出部分指令共用的参数，在指令参数列表中就不再重复列出。
（一）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相关参数及默认值见上表 |
发布评论