蓝图事件
用节点和连线组成的图来搭建事件,让它可以分支、循环、计数和记住数值
蓝图模式用节点和连线组成的图来搭建事件,而不是一列步骤。这样一个事件就能自己决定做什么:用不同的方式感谢大额礼物、为目标计数,或在两种反应之间轮流切换。
了解蓝图如何运行
每张图都从 事件 节点开始,触发器每次触发时它都会运行。白色的执行连线决定接下来运行什么。彩色的数据连线负责传递值:红色表示真或假,绿色表示数字,粉色表示文本。
触发器及其规则、冷却和队列仍然保留在事件上,所以它们的工作方式和简易事件一样。只有步骤列表变成了图,每个事件对应一张图。
把事件改为蓝图
在 事件 标签页中,打开标题旁的 蓝图模式。之后点击 新建事件 就会打开一个蓝图。简易事件和蓝图事件在列表中并排显示,蓝图事件的行上带有 蓝图 标签。
开启该模式后,简易编辑器会为新事件提供 以蓝图打开,为已保存的事件提供 转换为蓝图;简易事件行的右键菜单中也有这两项。转换出的副本以未保存状态打开,运行的步骤和原事件相同。
改回简易事件
右键点击蓝图事件行,选择 转换为简易事件。事件会立即转换,提示中会提供 撤销。如果图中用到了列表无法表示的内容,例如分支或变量,这一项会显示为灰色;把指针停在上面即可查看原因。
熟悉编辑器
蓝图会全屏打开,底部导航栏和事件列表会让到一旁。顶栏中有 导入、导出、测试值、保存并运行、保存 和 取消,旁边的状态会显示 没有问题,或者统计错误和警告的数量。
- 左侧的 我的蓝图 列出你的 变量 和所有节点。
- 右侧的 详情 用来编辑所选内容。选中 事件 节点即可更改触发器及其规则,然后点击 应用触发器。
- 底部的 编译结果 列出所有问题。点击某个问题即可跳转到对应的节点。
拖动侧边面板的边缘可以调整宽度,双击边缘可以恢复原样。窗口较窄时,“我的蓝图”会变成一列图标,“详情”则从右侧滑入。
添加节点
点击画布工具栏中的 添加节点,按 Shift+A,或右键点击画布的空白处。在 搜索节点 中输入名称,然后按 Enter。从某个引脚拖出连线到空白处时,列表只会显示能接上这条连线的节点,并自动连接你选中的那一个。
| 类别 | 节点 |
|---|---|
| 流程控制 | 分支、序列、并行、随机、延迟、For 循环、执行一次、执行 N 次、交替、按文本切换、按数字切换 |
| 触发数据 | 获取触发数据、获取触发字段、拥有身份 |
| 数学 | 加、减、乘、除、余数、最小值、最大值、限制范围、取整、绝对值、随机数 |
| 逻辑 | 比较、AND、OR、NOT |
| 文本 | 格式化文本、比较文本、拼接文本、转换大小写、文本长度、转为数字 |
| 变量 | 获取变量、设置变量 |
| 动作 | 动作(除 等待 和 分组 以外的任何步骤)、运行其他事件 |
| 工具 | 打印、注释、重新路由节点 |
延迟 可等待 0–600 秒,For 循环 最多运行 100 次。动作 节点完成后从 然后 继续;如果步骤失败,并且 失败 引脚接了连线,就会改走 失败。有些步骤可以从连线读取值,例如朗读台词所用的 文本。
连接节点
从输出引脚拖到输入引脚。指针旁的标记会显示一个对勾和连线将要接上的引脚,或者显示一个 X 并说明无法连接的原因,例如“此引脚需要数字。请用‘转为数字’从文本中读取。”
数字和真或假的值会自动转换为文本。执行输出和数据输入各自只能接一条连线,所以新连线会替换旧连线。按住 Alt 并点击引脚,即可断开它上面的连线。
用变量保存数值
在“我的蓝图”中点击 添加变量,然后设置它的 类型、初始值 和 作用域:事件 表示只在这个蓝图中使用,全局 表示按名称与所有蓝图事件共享。点击 获取 和 设置 即可为它添加对应的节点。
当前 显示变量此刻的值,也就是这个事件最近几次运行后留下的值。这些值会一直保留到应用关闭;点击 当前 旁的重置箭头,可以把变量恢复为初始值。
测试蓝图
点击 测试值,选择触发器在测试中携带的内容,例如观众名称、礼物、钻石或评论。然后点击 保存并运行:Vfinity 会保存事件,并像点击事件行上的播放按钮那样,把它作为测试运行一次。
运行经过的每个节点都会亮起,失败的节点会闪烁红色。打印 节点会把内容写入 调试控制台。有错误的蓝图也可以保存,但只要还有错误,它的行上就会显示 修复蓝图。
撤销与整理
撤销 和 重做 涵盖对图的所有更改,包括你应用过的触发器更改。自动排列 会沿着执行连线,把图从左到右排好。按 C 可以用 注释 包裹所选节点。
分享单个事件
导出 会把事件连同它的触发器、蓝图以及用到的声音和媒体保存到一个文件中,并会先保存你的更改。在另一台电脑上新建一个蓝图,然后点击 导入:文件中的事件会替换编辑器当前显示的内容;如果文件里是简易事件,导入后会变成一个运行相同步骤的蓝图。
导入前请先连接 VTube Studio:每个 触发快捷键 动作都会按名称匹配当前所加载模型的快捷键,找不到的快捷键会在提示中列出。在点击 保存 之前,所有内容都不会被保留。
选择要包含在备份文件中的内容。
旧版本
早于 Alpha 0.4.0 的 Vfinity 版本无法运行蓝图事件。请只与使用 Alpha 0.4.0 或更新版本的人分享蓝图文件。