https://github.com/ccvrc/dg-lab-vrcosc
DG-LAB VRChat OSC control for Misaka, also support Terrors of Nowhere.
https://github.com/ccvrc/dg-lab-vrcosc
dglab vrchat
Last synced: 8 months ago
JSON representation
DG-LAB VRChat OSC control for Misaka, also support Terrors of Nowhere.
- Host: GitHub
- URL: https://github.com/ccvrc/dg-lab-vrcosc
- Owner: ccvrc
- License: other
- Created: 2024-08-18T10:31:41.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-08-18T15:10:22.000Z (10 months ago)
- Last Synced: 2025-08-20T22:47:00.938Z (10 months ago)
- Topics: dglab, vrchat
- Language: Python
- Homepage:
- Size: 54.3 MB
- Stars: 43
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# **DG-LAB-VRCOSC**
这是与 **VRChat** 游戏联动的郊狼 (DG-LAB) **3.0** 设备控制程序，通过 VRChat 游戏内的 avatars 互动和其他事件来控制设备的输出。
- **兼容设备**：通过 WebSocket 控制 DG-LAB APP，目前只适配 DG-LAB 3.0 主机。
- **VRChat Avatar 联动功能** ( **OSC**)：
- **面板控制模式**：通过 VRSuya 的 [SoundPad](https://booth.pm/zh-cn/items/5950846) 进行控制，映射按键到设备功能。同时也支持**远程控制**，你可以通过自己 avatar 上的面板控制其他安装相同面板玩家的设备。
- **交互控制模式**：支持通过 VRChat 的 Contact 或 Physbones 参数进行控制，让 avatar 之间的交互可以控制设备输出（ 例如触碰或是拉伸动骨）。
- **ChatBox 显示**：可以通过 VRChat 的 ChatBox 显示当前设备信息。
- [**Terrors of Nowhere**](https://terror.moe/) 游戏联动功能：
- 游戏内受到伤害会增加设备输出，游戏内死亡会触发死亡惩罚。
- 通过 [ToNSaveManager](https://github.com/ChrisFeline/ToNSaveManager) 的 WebSocket API 监控游戏事件，需要在游玩 ToN 时运行这个存档软件，并打开设置中的 WebSocket API 服务器。
**补充说明：**
- 面板控制功能需要在 Booth 购买 [声音面板](https://booth.pm/zh-cn/items/5950846) 后将资源导入工程，再导入本项目提供的修改包，将修改包内提供的 prefab 安装到您的 avatar 中。此处的修改包发布已获取 [ VRサウンドパッド ] 原作者授权。
- 如果需要缩短对 ToN 游戏状态的响应时间，可以调整 ToNSaveManager 设置中的 **常规-设置更新速率**，将更新速率设置为 100ms（默认为 1000ms，根据实际情况调整）。
## 快速开始
视频使用教程: https://www.bilibili.com/video/BV1k81VYfETR
1. 下载 [release](https://github.com/ccvrc/DG-LAB-VRCOSC/releases) 中最新版本的 `DG-LAB-VRCOSC.zip`，解压后运行
2. 点击主界面的 `启动` 来生成二维码，然后使用 DG-LAB APP 连接 DG-LAB 3.0 主机，点击 APP 中的 `SOCKET控制` 然后扫描此处二维码连接设备。
3. 如果遇到问题，可以通过日志排查。建议检查网卡和端口是否设置正确，修改后再次尝试启动。
> 注意：你需要修改你使用的模型，才能让此程序与游戏中的 avatar 联动。
> ToN 游戏支持不需要修改模型，只需按上面的说明启用 ToNSaveManager 的 WebSocket API 接口即可。
## 问题反馈
如果在使用过程中遇到问题，欢迎在 [Issues](https://github.com/ccvrc/DG-LAB-VRCOSC/issues) 中提出。
访问[问题收集表](https://qiz80xlgzfj.feishu.cn/base/Db7KbBBmfaQmoXsk2BGcBddrnoc?table=tbl2hzoJWjaUkyyT&view=vewMnpNgGD)以查看当前收集到的BUG。
可以加入VRChat的游戏内群组 [DG-LAB-VRCOSC](https://vrc.group/CCVRC.1997) 来接收软件的更新动态。
## 注意事项
1. 本程序及开发者不对使用该本程序产生的**任何后果**负责，使用程序则视为同意本条款。
2. 请遵循 DG-LAB APP 中的说明，以安全的方式使用设备，使用此程序前请根据个人情况设置合理的强度上限。
3. 本程序大部分代码使用 LLM 生成，未经过充分的测试！使用时请注意风险！
## 界面说明
> 以下是 v0.1 版本程序的界面
程序界面：
SoundPad 控制面板界面：
VRChat 游戏内轮盘菜单：
## About
这个程序一开始只是为了做下面图片中的事情（画的好棒），后来想更完善些就加上了 UI 和 ToN 游戏的支持。
Artworks by Wanlin
## 编译与构建
### 环境准备
```bash
# 1. 安装 Python 3.12
# 下载并安装 Python 3.12: https://www.python.org/downloads/
# 2. 安装项目依赖
pip install -r requirements.txt
```
### 构建步骤
```bash
# 3. 生成版本文件
./generate_version.ps1
# 4. 构建可执行文件
pyinstaller DG-LAB-VRCOSC.spec
```
## 构建发布版本
### 创建发布标签
```bash
# 1. 创建版本标签 (格式: v0.0.0)
git tag v0.0.0
# 2. 推送标签到远程仓库
git push origin v0.0.0
```