动作步骤
事件或快捷面板按键可以运行的每个动作步骤，包含其专属字段、取值范围与默认值
你可以在事件编辑器的就执行这个区域或在快捷面板按键中添加的每个步骤，附带各字段的取值范围与默认值。
步骤列表的执行方式
当列表中包含超过一个步骤时，会出现步骤运行方式选项。
| 选项 | 执行逻辑 |
|---|---|
| 按顺序（默认） | 一个接一个执行，每个步骤都在其自身的等待延迟后启动 |
| 全部同时 | 所有步骤同时启动；各自仍会等待其专属的延迟 |
| 随机一个 | 按权重随机抽取一个步骤执行。每次礼物连击重复触发时会重新抽取 |
每个步骤还包含以下通用控制项：
| 字段 | 取值范围 | 默认值 |
|---|---|---|
| 先等待（毫秒） | 0–600,000 | 0 |
| 权重（仅限随机一个） | 0–100；设为 0 则绝不会被抽中 | 1 |
| 开关 | 关闭的步骤将被直接跳过 | 开启 |
若开启的步骤未完成必要配置，或随机抽取的所有步骤权重均为 0，编辑器将禁止保存。右键点击某个步骤可进行复制、移动、转换为其他类型，或使用复制步骤与粘贴步骤将其迁移到其他事件或按键中。
VTube Studio
这些步骤仅在 VTube Studio 处于连接状态时运行。每个步骤都会独立检测连接，因此即使 VTS 已关闭，列表中的其他非 VTS 步骤仍会照常执行。
| 步骤 | 专属字段 |
|---|---|
| 触发快捷键 | VTS 快捷键；持续时间（秒）（到达后再次按下以关闭） |
| 移动模型 | X 位置、Y 位置、旋转（°）、大小、过渡时间（秒）、保持（秒）、返回原始位置 |
| 特效预设 | 特效预设名称、淡入淡出时间（秒）、持续时间（秒） |
| 设置表情 | 表情、执行方式、淡入淡出（秒）、多少秒后关闭 |
| 给模型染色 | 染色范围、颜色、不透明度、彩虹色、场景光照、多少秒后还原 |
| 放置物件 | 放置内容、物件文件或图片、X 位置、Y 位置、大小、图层、淡入淡出（秒）、固定到 ArtMesh、固定位置、多少秒后移除 |
| 切换模型 | 模型、多少秒后切回 |
| 驱动参数 | 参数、数值、方式、持续（秒）、变化曲线、接管强度 |
取值范围
| 字段 | 取值范围 | 默认值 |
|---|---|---|
| X 位置、Y 位置（移动模型） | −1 至 1；±1 代表屏幕边缘 | 0 |
| 旋转（°） | −360 至 360；正数为顺时针 | 0 |
| 大小（移动模型） | −100 至 100；0 保持不变 | 0 |
| 过渡时间（秒） | 0–2 | 0.5 |
| 淡入淡出时间（秒）、淡入淡出（秒） | 0–2 | VTube Studio 自身预设 |
| 不透明度 | 0–255 | 不透明 |
| 场景光照 | 0–1 | 1 |
| 大小（放置物件） | 0–1，对应 VTube Studio 的物件缩放比例 | — |
| 图层 | −30 至 30；负数位于模型后方 | — |
| 数值（驱动参数） | −1,000,000 至 1,000,000 | 0 |
| 持续（秒） | 0 或更大 | 0.4 |
| 接管强度 | 0–1 | — |
| 任意持续、保持或“多少秒后”字段 | 最高 86,400 秒（一天）；留空表示一直保持 | 留空 |
选项设置
| 字段 | 可选值 |
|---|---|
| 执行方式（设置表情） | 开启、关闭、切换 |
| 染色范围 | 整个模型、ArtMesh 名称包含、标签包含、已在 VTube Studio 中选取 |
| 放置内容 | VTube Studio 自带的物件、你自己的图片 |
| 固定位置 | 中心、随机位置 |
| 方式 | 叠加到面部追踪、接管面部追踪 |
| 变化曲线 | 保持后停止、均匀淡出、快速衰减、摆动收束 |
你自己的图片文件大小必须在 5 MB 以下，且 VTube Studio 会弹窗询问一次是否允许 Vfinity 加载图片物件。VTube Studio 最多每 2 秒加载一次模型。接管强度仅对接管面部追踪有效。
声音、朗读与媒体
| 步骤 | 字段 | 取值范围 | 默认值 |
|---|---|---|---|
| 播放一段声音 | 声音池 | 最多 10 个声音，每个均带有权重 | 单个声音 |
| 音量 | 0–100% | 100% | |
| 播放位置 | 仅 OBS、仅本应用、OBS 和本应用 | 仅本应用 | |
| 等待完成 | 超过 30 秒自动放弃等待 | 关闭 | |
| 朗读自定义台词 | 朗读文本 | 最多 300 个字符，支持模板变量 | 留空 |
| 覆盖语音 ID | 来自 TTS 服务商的语音 ID | 你的 TTS 语音 | |
| 单独的音量和语速 | 开启或关闭；关闭时沿用 设置音频语音 中的事件音量和语速 | 关闭 | |
| 音量 | 0–100% | 事件音量 | |
| 语速 | −50% 至 +100%；部分服务商无法调整语速 | 事件语速 | |
| 等待完成 | 开启或关闭 | 开启 | |
| 每分钟字符数（0 = 不限） | 0–100,000 | 600 | |
| 显示图片或视频 | 图片、GIF 或视频 | 已上传的图片、GIF、WebP、WebM 或 MP4 | — |
| 显示时长（秒；0 = 视频长度） | 0–300 | 5 | |
| 适应方式 | 完整显示图片、填满画面 | 完整显示图片 | |
| 静音视频声音 | 开启或关闭 | 开启 | |
| 视频音量 | 0–100% | 100% | |
| 伴随音效 | 声音、音量及播放位置 | 无，仅 OBS | |
| 位置与大小、动画 | 画面摆位以及进出场动效 | 弹出 | |
| 等待完成 | 开启或关闭 | 关闭 |
当声音池中包含多个声音时，单次执行会按权重抽取一个；权重为 0 的声音绝不播放。每分钟字符数限制了单个事件在所有观众中的总朗读量，有助于控制付费语音的费用开销。台词单独设置的音量和语速只作用于该步骤；聊天朗读保留自己的设置。
媒体内容展示在 OBS 的动作媒体来源中（#overlay-actions）。时长设为 0 时视频将播放至自然结束（最长 2 分钟）。视频自带的声音会在该来源的每个副本中播放；若需要只播放一次的音频，请使用伴随音效。
投掷
| 字段 | 取值范围或选项 | 默认值 |
|---|---|---|
| 投掷物品 | 已配置的物品、观众头像、聊天表情 | 已配置的物品 |
| 投掷配置（可选） | 来自“投掷”标签页的礼物投掷配置 | 默认物品 |
| 物品数量 | 1–50 | 1 |
| 显示观众名称 | 开启或关闭 | 开启 |
其他应用交互
| 步骤 | 字段 | 前置条件 |
|---|---|---|
| 控制 OBS | 要做什么，随后配置场景、来源、滤镜或文本来源与文本；状态；多久后还原 | 在 设置连接OBS Studio 中已连接 OBS |
| 调用 HTTP Webhook | URL / 动作 ID、HTTP 方法、JSON 正文 / 参数、Authorization 请求头（不会包含在分享的备份中） | 无 |
| Streamer.bot 动作 | URL / 动作 ID、刷新动作列表、JSON 正文 / 参数 | 已连接 Streamer.bot |
| 模拟按键 | 组合键、按住时长（毫秒） | 在 设置自动化与规则键盘操作 中已开启允许事件模拟按键 |
| 字段 | 取值范围或选项 | 默认值 |
|---|---|---|
| 要做什么（控制 OBS） | 切换场景、显示或隐藏来源、打开或关闭滤镜、写入文本来源 | 切换场景 |
| 状态 | 打开、关闭、切换 | 打开 |
| 多久后还原 | 秒数；留空表示保持更改 | 留空 |
| HTTP 方法 | GET、POST、PUT、PATCH、DELETE | POST |
| JSON 正文 / 参数 | JSON 对象，最多 32,768 字符；使用 GET 时不发送 | {} |
| 组合键 | 最多 5 个按键：字母、数字、Ctrl、Alt、Shift、Meta、Enter、Escape、Tab、Space、Backspace、Delete、Home、End、Page Up、Page Down、方向键、F1–F12 | — |
| 按住时长（毫秒） | 20–5,000 | 100 |
Webhook 必须为 http 或 https 地址，超过 10 秒未响应将放弃。在 OBS 连接状态下，OBS 字段会下拉列出你的场景、来源和滤镜；未连接时支持手动输入名称。模拟按键会将按键发送给当前处于焦点的应用；按下紧急停止会释放当前仍被按住的任何按键。
流程控制
| 步骤 | 字段 | 取值范围 | 默认值 |
|---|---|---|---|
| 等待 | 等待（秒） | 0–600 | 1 |
| 分组 | 分组运行方式 | 按顺序、全部同时、随机一个；最多 20 个步骤；不支持分组嵌套 | 全部同时 |
| 应用命令 | 应用命令，随后配置值、值（JSON）、要运行的映射或选择快捷面板按键 | 命令中的任意命令 | — |
应用命令会提示输入对应命令所需的值。相互触发的事件在经过 4 次连锁调用后，或单次触发累计启动超过 20 次执行后将自动停止。
蓝图事件通过动作节点运行其他所有步骤，但没有等待和分组：这些工作由它的延迟、序列、并行和随机节点完成。