DG-LAB-VRCOSC

这是与 VRChat 游戏联动的郊狼 (DG-LAB) 3.0 设备控制程序，通过 VRChat 游戏内的 avatars 互动和其他事件来控制设备的输出。

• 兼容设备：通过 WebSocket 控制 DG-LAB APP，目前只适配 DG-LAB 3.0 主机。

• VRChat Avatar 联动功能 ( OSC)：

  • 面板控制模式：通过 VRSuya 的 SoundPad 进行控制，映射按键到设备功能。同时也支持远程控制，你可以通过自己 avatar 上的面板控制其他安装相同面板玩家的设备。

  • 交互控制模式：支持通过 VRChat 的 Contact 或 Physbones 参数进行控制，让 avatar 之间的交互可以控制设备输出（ 例如触碰或是拉伸动骨）。

  • ChatBox 显示：可以通过 VRChat 的 ChatBox 显示当前设备信息。

• Terrors of Nowhere 游戏联动功能：

  • 游戏内受到伤害会增加设备输出，游戏内死亡会触发死亡惩罚。
  • 通过 ToNSaveManager 的 WebSocket API 监控游戏事件，需要在游玩 ToN 时运行这个存档软件，并打开设置中的 WebSocket API 服务器。

补充说明：

• 面板控制功能需要在 Booth 购买 声音面板 后将资源导入工程，再导入本项目提供的修改包，将修改包内提供的 prefab 安装到您的 avatar 中。此处的修改包发布已获取 [ VRサウンドパッド ] 原作者授权。
• 如果需要缩短对 ToN 游戏状态的响应时间，可以调整 ToNSaveManager 设置中的 常规-设置更新速率，将更新速率设置为 100ms（默认为 1000ms，根据实际情况调整）。

快速开始

视频使用教程: https://www.bilibili.com/video/BV1k81VYfETR

1. 下载 release 中最新版本的 DG-LAB-VRCOSC.zip，解压后运行
2. 点击主界面的 启动 来生成二维码，然后使用 DG-LAB APP 连接 DG-LAB 3.0 主机，点击 APP 中的 SOCKET控制 然后扫描此处二维码连接设备。
3. 如果遇到问题，可以通过日志排查。建议检查网卡和端口是否设置正确，修改后再次尝试启动。

注意：你需要修改你使用的模型，才能让此程序与游戏中的 avatar 联动。 ToN 游戏支持不需要修改模型，只需按上面的说明启用 ToNSaveManager 的 WebSocket API 接口即可。

问题反馈

如果在使用过程中遇到问题，欢迎在 Issues 中提出。

访问问题收集表以查看当前收集到的BUG。

可以加入VRChat的游戏内群组 DG-LAB-VRCOSC 来接收软件的更新动态。

注意事项

1. 本程序及开发者不对使用该本程序产生的任何后果负责，使用程序则视为同意本条款。
2. 请遵循 DG-LAB APP 中的说明，以安全的方式使用设备，使用此程序前请根据个人情况设置合理的强度上限。
3. 本程序大部分代码使用 LLM 生成，未经过充分的测试！使用时请注意风险！

界面说明

以下是 v0.1 版本程序的界面

程序界面：

SoundPad 控制面板界面：

VRChat 游戏内轮盘菜单：

About

这个程序一开始只是为了做下面图片中的事情（画的好棒），后来想更完善些就加上了 UI 和 ToN 游戏的支持。

Artworks by Wanlin

编译与构建

环境准备

# 1. 安装 Python 3.12
# 下载并安装 Python 3.12: https://www.python.org/downloads/

# 2. 安装项目依赖
pip install -r requirements.txt

构建步骤

# 3. 生成版本文件
./generate_version.ps1

# 4. 构建可执行文件
pyinstaller DG-LAB-VRCOSC.spec

构建发布版本

创建发布标签

# 1. 创建版本标签 (格式: v0.0.0)
git tag v0.0.0

# 2. 推送标签到远程仓库
git push origin v0.0.0