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相关参数及默认值见上表 |