NVLMaker Playground常用指令参考
NVLMaker Cloud Playground
说明
（一）指令格式
NVLMaker Cloud使用类似吉里吉里的TAG语法。
支持@指令名 参数名=参数值（单行），以及[指令名 参数名=参数值]（可在对话中插入）两种格式。
（二）切换效果
当指令中可以使用“method”时，相关参数及可能的值如下表：
效果仍在不断增加中，欢迎向我们提出建议～
| 参数 |
值 |
说明 |
| method |
crossfade/universal/turn/ripple |
切换效果 |
| ① |
crossfade |
淡入，默认值 |
| ② |
universal |
遮片 |
| ③ |
turn |
翻页 |
| ④ |
ripple |
水面涟漪效果 |
| 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 |
（四）可以用于测试的图片素材列表
（1）背景图片
（2）人物图片
（3）切换规则图片
指令
（一）图像
（1）显示背景
| 指令 |
参数 |
是否必须/默认值 |
说明 |
| @bg |
|
|
|
| - |
storage |
必须 |
背景图片名 |
| - |
time |
700 |
切换时间（毫秒） |
| - |
canskip |
true |
是否允许快速跳过 |
| - |
clfg |
false |
同时消除所有立绘层 |
| - |
hidemes |
false |
同时消除对话框（及系统按钮） |
| - |
convert |
false |
图片反色效果 |
| - |
grayscale |
false |
图片去色效果 |
| - |
mcolor |
|
蒙版色 |
| - |
mopacity |
|
蒙版色透明度 |
| - |
method |
|
相关参数及默认值见上表 |
（2）显示人物
| 指令 |
参数 |
是否必须/默认值 |
说明 |
| @fg |
|
|
|
| - |
storage |
必须 |
人物图片名 |
| - |
time |
500 |
切换时间（毫秒） |
| - |
canskip |
true |
是否允许快速跳过 |
| - |
layer |
0 |
显示人物的图层编号 |
| - |
pos |
center |
人物显示位置可选：left/center/right |
| - |
left |
|
直接指定横坐标，仅当pos为空值时生效，未指定时，会自动取得当前图层的坐标 |
| - |
top |
|
直接指定纵坐标，仅当pos为空值时生效，未指定时，会自动取得当前图层的坐标 |
| - |
opacity |
255 |
图片透明度（0-255） |
| - |
method |
|
相关参数及默认值见上表 |
（3）显示头像
| 指令 |
参数 |
是否必须/默认值 |
说明 |
| @face |
|
|
|
| - |
storage |
必须 |
头像图片名 |
| - |
time |
100 |
切换时间（毫秒） |
| - |
canskip |
true |
是否允许快速跳过 |
| - |
opacity |
255 |
图片透明度（0-255） |
| - |
fg |
|
同时显示人物立绘图片，不能调整位置，会自动取得指定编号图层的坐标 |
| - |
layer |
0 |
同时显示的人物立绘所用的图层 |
（4）消除背景
| 指令 |
参数 |
是否必须/默认值 |
说明 |
| @clbg |
|
|
|
| - |
time |
700 |
切换时间（毫秒） |
| - |
canskip |
true |
是否允许快速跳过 |
| - |
clfg |
false |
同时消除所有前景层 |
| - |
hidemes |
false |
同时消除对话框（及系统按钮） |
| - |
method |
|
相关参数及默认值见上表 |
（5）消除人物
| 指令 |
参数 |
是否必须/默认值 |
说明 |
| @clfg |
|
|
|
| - |
time |
500 |
切换时间（毫秒） |
| - |
canskip |
true |
是否允许快速跳过 |
| - |
layer |
0 |
可选0~8/all |
| - |
clface |
false |
同时消除头像 |
| - |
hidemes |
false |
同时消除对话框（及系统按钮） |
| - |
method |
|
相关参数及默认值见上表 |
（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 |
|
同时显示头像图片 |
| - |
fg |
|
同时显示人物立绘图片，不能调整位置，会自动取得指定编号图层的坐标 |
| - |
layer |
0 |
同时显示的人物立绘所用的图层 |
（三）音声播放
（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 |
返回呼叫指令的位置并继续执行下一行 |
（五）选项
（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 |
