NVLMaker Cloud常用指令参考
NVLMaker
Cloud
Playground
说明
(一)指令格式
NVLMaker Cloud使用类似吉里吉里的TAG语法。
支持@指令名 参数名=参数值
(单行),以及[指令名 参数名=参数值]
(可在对话中插入)两种格式。
(二)切换效果
当指令中可以使用“method”时,相关参数及可能的值如下表:
效果仍在不断增加中,欢迎向我们提出建议~
参数 |
值 |
说明 |
method |
crossfade/universal/turn/ripple/scroll/pageturn/wave |
切换效果 |
① |
crossfade |
淡入,默认值 |
② |
universal |
遮片 |
③ |
turn |
翻页 |
④ |
ripple |
水面涟漪效果 |
⑤ |
scroll |
卷动效果 |
⑥ |
pageturn |
翻页效果 |
⑦ |
wave |
波纹效果 |
rule |
|
效果规则图片文件名,当切换效果为universal时读取 |
使用范例:可以使用[bg storage="背景文件" method="ripple"]
,将执行背景切换,并且切换效果为水面涟漪效果。
(三)等效参数名
本文档中列出的指令与NVLMaker单机版完全兼容。
如果您是NVLMaker单机版的老用户,可以直接跳过本段的斜体字说明和表格,继续阅读指令部分的文档。
对于特定指令,NVLMaker Cloud也能正常识别以下等效参数名。
使用范例:[bgm file="音乐文件"]
和 [bgm storage="音乐文件"]
意义相同。
指令 |
用途 |
参数名 |
等效参数名 |
trans |
切换效果名 |
method |
mode |
bgm/se/call/jump |
文件名 |
storage |
file |
call/jump |
标签名 |
target |
label |
se |
音效频道 |
buf |
channel |
(四)用于Playground测试的图片素材列表
图片版权均归属素材作者所有,请勿挪用。
如想将素材用于游戏中,请单独向素材作者购买授权。
(1)背景图片
点选缩略图可查看完整列表
(2)人物图片
点选缩略图可查看完整列表
(3)切换规则图片
点选缩略图可查看完整列表
指令
(一)图像
(1)显示背景
指令 |
参数 |
是否必须/默认值 |
说明 |
@bg |
|
|
|
- |
storage |
必须 |
背景图片名 |
- |
l |
同时显示立绘(左)图片名 |
|
- |
c |
同时显示立绘(中)图片名 |
|
- |
r |
同时显示立绘(右)图片名 |
|
- |
clfg |
true |
同时消除所有前景层 |
- |
cleff |
true |
同时消除所有叠加在背景上的效果 |
- |
hidemes |
false |
同时消除对话框(及系统按钮) |
- |
convert |
false |
叠加反色效果 |
- |
grayscale |
false |
叠加去色效果 |
- |
mcolor |
|
叠加颜色 |
- |
mopacity |
|
叠加颜色透明度 |
- |
method |
|
相关参数及默认值见上表 |
- |
time |
700 |
切换时间(毫秒) |
- |
canskip |
true |
是否允许快速跳过 |
(2)显示人物
A:显示人物
指令 |
参数 |
是否必须/默认值 |
说明 |
@fg |
|
|
|
- |
storage |
必须 |
人物图片名 |
- |
face |
- |
同时显示头像 |
- |
layer |
0 |
显示人物的图层编号 |
- |
pos |
center |
人物显示位置可选:left/center/right |
- |
left |
|
直接指定横坐标,仅当pos为空值时生效,未指定时,会自动取得当前图层的坐标 |
- |
top |
|
直接指定纵坐标,仅当pos为空值时生效,未指定时,会自动取得当前图层的坐标 |
- |
opacity |
255 |
图片透明度(0-255) |
- |
method |
|
相关参数及默认值见上表 |
- |
time |
500 |
切换时间(毫秒) |
- |
canskip |
true |
是否允许快速跳过 |
B:显示多个人物
指令 |
参数 |
是否必须/默认值 |
说明 |
@fgs |
|
|
|
- |
l |
- |
显示立绘(1-左)图片名 |
- |
c |
- |
显示立绘(0-中)图片名 |
- |
r |
- |
显示立绘(2-右)图片名 |
- |
clfg |
false |
是否消除之前全部位置上的立绘 |
- |
method |
|
相关参数及默认值见上表 |
- |
time |
500 |
切换时间(毫秒) |
- |
canskip |
true |
是否允许快速跳过 |
C:人物移入
指令 |
参数 |
是否必须/默认值 |
说明 |
@fgin |
|
|
|
- |
storage |
必须 |
人物图片名 |
- |
layer |
0 |
显示人物的图层编号 |
- |
pos |
center |
人物显示位置可选:left/center/right |
- |
from |
r |
从左侧l或右侧r移入 |
(3)显示头像
指令 |
参数 |
是否必须/默认值 |
说明 |
@face |
|
|
|
- |
storage |
必须 |
头像图片名 |
- |
opacity |
255 |
图片透明度(0-255) |
- |
fg |
|
同时显示人物立绘图片,不能调整位置,会自动取得指定编号图层的坐标 |
- |
layer |
0 |
同时显示的人物立绘所用的图层 |
- |
method |
|
相关参数及默认值见上表 |
- |
time |
500 |
切换时间(毫秒) |
- |
canskip |
true |
是否允许快速跳过 |
(4)消除背景
指令 |
参数 |
是否必须/默认值 |
说明 |
@clbg |
|
|
|
- |
clfg |
true |
同时消除所有前景层 |
- |
cleff |
true |
同时消除所有叠加在背景上的效果 |
- |
hidemes |
false |
同时消除对话框(及系统按钮) |
- |
method |
|
相关参数及默认值见上表 |
- |
time |
700 |
切换时间(毫秒) |
- |
canskip |
true |
是否允许快速跳过 |
(5)消除人物
A:消除人物
指令 |
参数 |
是否必须/默认值 |
说明 |
@clfg |
|
|
|
- |
layer |
0 |
可选0~8/all |
- |
clface |
false |
同时消除头像 |
- |
hidemes |
false |
同时消除对话框(及系统按钮) |
- |
method |
|
相关参数及默认值见上表 |
- |
time |
500 |
切换时间(毫秒) |
- |
canskip |
true |
是否允许快速跳过 |
B:人物移出
指令 |
参数 |
是否必须/默认值 |
说明 |
@fgout |
|
|
|
- |
layer |
0 |
要消除的立绘编号 |
- |
to |
l |
从左侧l或右侧r移出 |
(6)消除头像(无需参数)
(二)对话
(1)对话框相关操作(无需参数)
指令名 |
说明 |
@dia |
显示一号对话框 |
@scr |
显示二号对话框 |
@menu |
显示全屏透明对话框 |
@hidemes |
隐藏对话框(不会消除头像或改变对话框样式) |
@showmes |
将隐藏的对话框显示出来(如隐藏对话框之后头像没有消除过,则头像仍会恢复显示) |
(2)对话中常见的插入指令
指令名 |
说明 |
[lr] |
等待点击、点击之后换行 |
[w] |
等待点击、点击之后清空之前文字并继续显示下一段 |
[r] |
单纯换行 |
[l] |
单纯等待点击 |
(3)改变文字样式
指令 |
参数 |
是否必须/默认值 |
说明 |
@font |
|
|
|
- |
color |
|
改变文字颜色,格式为0xRRGGBB |
- |
size |
|
改变文字大小 |
(4)恢复默认文字样式(无需参数)
指令名 |
说明 |
@resetfont |
恢复文字默认样式 |
改变/恢复文字样式也可在对话中直接插入,例如:
[font color=0xFF0000 size=26]早上好![resetfont][lr]
这里是NVLMaker Cloud的PlayGround。[w]
(5)人名显示
指令 |
参数 |
是否必须/默认值 |
说明 |
@npc |
|
|
|
- |
id |
必须 |
要显示的人物姓名: 当游戏设定不使用姓名栏时,会以【姓名】 格式显示于对话框内 当游戏设定使用姓名栏时,将显示在姓名栏上 |
- |
color |
|
显示人名时所用的文字颜色,不指定时会使用人名列表里的默认颜色 |
- |
face |
|
同时显示头像图片 |
(三)音声播放
(1)播放音乐
指令 |
参数 |
是否必须/默认值 |
说明 |
@bgm |
|
|
|
- |
storage |
必须 |
音乐文件名 |
- |
loop |
true |
是否循环播放 |
(2)播放音效
指令 |
参数 |
是否必须/默认值 |
说明 |
@se |
|
|
|
- |
storage |
必须 |
语音文件名 |
- |
buf |
0 |
音效频道编号 |
- |
loop |
false |
是否循环播放 |
(3)播放语音
指令 |
参数 |
是否必须/默认值 |
说明 |
@vo |
|
|
|
- |
storage |
必须 |
语音文件名 |
(4)停止音乐
指令 |
参数 |
是否必须/默认值 |
说明 |
@fadeoutbgm |
|
|
|
- |
time |
1000 |
渐变时间(毫秒) |
(5)等待音效
指令 |
参数 |
是否必须/默认值 |
说明 |
@ws |
|
|
|
- |
buf |
0 |
语音频道编号 |
- |
canskip |
true |
是否允许快速跳过 |
(四)跳转
(1)跳转到标签
指令 |
参数 |
是否必须/默认值 |
说明 |
@jump |
|
|
|
- |
target |
|
标签名,具体格式为*标签名字 |
- |
storage |
|
标签所在的剧本文件,不指定时为当前剧本文件 |
(2)呼叫剧本段落
指令 |
参数 |
是否必须/默认值 |
说明 |
@call |
|
|
|
- |
target |
|
呼叫的段落开始标签名,具体格式为*标签名字 |
- |
storage |
|
标签所在的剧本文件,不指定时为当前剧本文件 |
(3)从剧本段落返回
指令名 |
说明 |
@return |
返回呼叫指令的位置并继续执行下一行 |
(4)等待点击
指令名 |
说明 |
@waitclick |
等待玩家点击后继续下一行,类似于[w]但不出现等待图标 |
(五)选项
(1)选项按钮定义开始
指令 |
参数 |
是否必须/默认值 |
说明 |
@selstart |
|
|
开始选项按钮定义 |
- |
hidemes |
false |
是否隐藏对话框、头像(并禁止右键操作) |
- |
hidesysbutton |
false |
是否隐藏系统按钮(并禁止右键操作) |
(2)定义选项按钮
指令 |
参数 |
是否必须/默认值 |
说明 |
@selbutton |
|
|
定义一个选项按钮 |
- |
text |
必须 |
选项按钮上会显示的文字 |
- |
target |
必须 |
点下按钮后会跳转到的标签 |
- |
storage |
|
点下按钮后会跳转到的剧本文件名 |
- |
exp |
|
点下按钮后会执行的表达式 |
(3)显示已定义的选项
指令 |
参数 |
是否必须/默认值 |
说明 |
@selend |
|
|
选项按钮定义结束 |
- |
time |
300 |
显示时间 |
- |
canskip |
true |
是否允许快速跳过 |
(4)消除选项
指令 |
参数 |
是否必须/默认值 |
说明 |
@clsel |
|
|
将选项按钮消除并将对话框、系统按钮复原 |
(六)演出
(1)画面震动
指令 |
参数 |
是否必须/默认值 |
说明 |
@quake |
|
|
画面震动 |
- |
time |
|
震动时间 |
- |
canskip |
true |
是否允许快速跳过 |
- |
vmax |
|
纵向最大位移(像素) |
- |
hmax |
|
横向最大位移(像素) |
(2)等待画面震动结束
指令 |
参数 |
是否必须/默认值 |
说明 |
@wq |
|
|
等待画面震动结束 |
- |
canskip |
true |
是否允许快速跳过 |
(3)粒子效果指令一览
类型 |
粒子显示 |
粒子消失 |
下雨 |
raininit |
rainuninit |
下雪 |
snowinit |
snowuninit |
樱花 |
sakurainit |
sakurauninit |
红叶 |
momijiinit |
momijiuninit |
雾气 |
foginit |
foguninit |
萤火 |
fireflyinit |
fireflyuninit |
(4)画面缩放
指令 |
参数 |
是否必须/默认值 |
说明 |
@camera |
|
|
|
- |
zoom |
|
放大倍率,100代表原大小 |
- |
anchor |
|
对焦中点,将以此点为中心进行缩放,可选字段见下表,也可使用x,y指定 |
- |
x |
|
对焦中点坐标x |
- |
y |
|
对焦中点坐标y |
名称 |
说明 |
topleft |
左上 |
topright |
右上 |
topcenter |
中上 |
leftcenter |
左中 |
center |
正中 |
rightcenter |
右中 |
bottomleft |
左下 |
bottomcenter |
中下 |
bottomright |
右下 |
(5)人物动态
指令 |
参数 |
是否必须/默认值 |
说明 |
@shake |
|
|
人物摇动 |
- |
layer |
0 |
指定摇动的立绘图层 |
- |
time |
200 |
摇动时间 |
- |
times |
3 |
左右摇动次数 |
- |
range |
15 |
摇动范围(像素) |
- |
canskip |
true |
是否允许快速跳过 |
指令 |
参数 |
是否必须/默认值 |
说明 |
@fgjump |
|
|
人物小跳 |
- |
layer |
0 |
指定的立绘图层 |
- |
time |
200 |
摇动时间 |
- |
times |
1 |
跳动次数 |
- |
height |
15 |
跳动高度(像素) |
- |
canskip |
true |
是否允许快速跳过 |