连接 VTube Studio
开启 VTube Studio 的插件 API，授权一次 Vfinity，确认 VTS 状态标签变绿
Vfinity 通过 VTube Studio 的插件 API 控制你的模型。开启该 API，并在首次请求时授权 Vfinity，你的事件即可触发快捷键、表情并让模型做出动作。
开启插件 API
打开 VTube Studio 设置
在 VTube Studio 中，点击齿轮图标打开其设置界面。
启动 API
找到插件 API 部分，将 Start API 切换为开启状态。留意其显示的端口号，除非你自行修改，否则默认为 8001。
连接并授权 Vfinity
打开 VTube Studio 卡片
在 Vfinity 中，前往 设置连接，在 应用 分组下找到 VTube Studio API。IP 地址 和 端口 默认填入 localhost 和 8001。如果 VTube Studio 显示了不同端口，请在此处修改。
连接
点击 连接 VTS。你也可以右键点击标题栏中的 VTS 状态标签并选择 连接。
允许插件接入
VTube Studio 会弹出询问是否允许 Vfinity 接入的窗口。选择 Allow（允许）。若无弹窗反应，请检查是否出现在副显示器或被遮挡在 VTube Studio 窗口后方。
你只需授权 Vfinity 一次。此后连接均无需再次确认；开启 启动时自动连接 后，每次启动 Vfinity 都会自动连上。
如果 VTube Studio 运行在另一台电脑上，请在 IP 地址 中输入该电脑的局域网 IP，而非 localhost。
查看绿色状态标签
标题栏中的 VTS 标签让你对连接状态一目了然。VTube Studio 授权后它会变为绿色，悬停光标可查看文字详情。
| 状态标签 | 含义 |
|---|---|
| 绿色 | 已连接并已授权。事件可正常驱动你的模型。 |
| 琥珀色 | 正在连接，或连接断开后正在重试。标签旁会显示重试次数。 |
| 红色 | 未连接。 |
右键点击该标签可断开连接、重新连接，或快速跳转到“设置”中的 VTube Studio 卡片。
本机
Vfinity 通过端口 8001 连接到 VTube Studio API，以触发快捷键并移动你的模型。
Vfinity 连接到 OBS 内置的 WebSocket 服务器（端口 4455），以切换场景和显示来源。
OBS 浏览器源打开 Vfinity 自己的服务器（端口 21424），以绘制投掷物、提醒和组件。
你的脚本使用令牌在相同的端口 21424 访问本地 API。
TikTok LIVE、Twitch、Kick 和 YouTube 通过互联网访问。Vfinity 自身发起这些连接。
箭头：谁发起连接
端口：谁在监听
查看 Vfinity 读取的内容
仪表板中的 VTube Studio 模型 卡片会显示当前加载的模型，以及事件编辑器可用的表情、模型、物品文件、参数与 ArtMesh 数量。当你切换模型时，这些列表会自动同步更新。
- 刷新列表：如果数据看起来不够及时，可点击重新读取。
- 重新连接：如果 VTube Studio 停止响应，可点击重新建立连接。
- 将图片作为 VTube Studio 物品：需要二次单次权限。点击 在 VTube Studio 中允许 并接受其提示，以便 Vfinity 将图片加载为物品。
- 测试受击晃动：触发模型受到撞击时的微小震颤，便于在不投掷任何物品的情况下检查模型反应。