{"id":17660536,"url":"https://github.com/ccvrc/dg-lab-vrcosc","last_synced_at":"2025-10-11T02:43:27.898Z","repository":{"id":254544476,"uuid":"844083042","full_name":"ccvrc/DG-LAB-VRCOSC","owner":"ccvrc","description":"DG-LAB VRChat OSC control for Misaka, also support Terrors of Nowhere.","archived":false,"fork":false,"pushed_at":"2025-08-18T15:10:22.000Z","size":56956,"stargazers_count":43,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-20T22:47:00.938Z","etag":null,"topics":["dglab","vrchat"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ccvrc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-08-18T10:31:41.000Z","updated_at":"2025-08-18T15:10:25.000Z","dependencies_parsed_at":"2024-11-06T13:24:40.019Z","dependency_job_id":"dd10feb9-0a51-46a6-a132-30ccd0b90a7b","html_url":"https://github.com/ccvrc/DG-LAB-VRCOSC","commit_stats":{"total_commits":80,"total_committers":2,"mean_commits":40.0,"dds":0.07499999999999996,"last_synced_commit":"c0e0886a80acc3ab528cec06b32f90877e714c6d"},"previous_names":["ccvrc/dg-lab-vrcosc"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/ccvrc/DG-LAB-VRCOSC","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccvrc%2FDG-LAB-VRCOSC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccvrc%2FDG-LAB-VRCOSC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccvrc%2FDG-LAB-VRCOSC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccvrc%2FDG-LAB-VRCOSC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ccvrc","download_url":"https://codeload.github.com/ccvrc/DG-LAB-VRCOSC/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccvrc%2FDG-LAB-VRCOSC/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005967,"owners_count":26084004,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dglab","vrchat"],"created_at":"2024-10-23T17:07:32.257Z","updated_at":"2025-10-11T02:43:27.852Z","avatar_url":"https://github.com/ccvrc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **DG-LAB-VRCOSC**\n\n这是与 **VRChat** 游戏联动的郊狼 (DG-LAB) **3.0** 设备控制程序，通过 VRChat 游戏内的 avatars 互动和其他事件来控制设备的输出。\n\n- **兼容设备**：通过 WebSocket 控制 DG-LAB APP，目前只适配 DG-LAB 3.0 主机。\n\n- **VRChat Avatar 联动功能** ( **OSC**)：\n\n  - **面板控制模式**：通过 VRSuya 的 [SoundPad](https://booth.pm/zh-cn/items/5950846) 进行控制，映射按键到设备功能。同时也支持**远程控制**，你可以通过自己 avatar 上的面板控制其他安装相同面板玩家的设备。\n\n  - **交互控制模式**：支持通过 VRChat 的 Contact 或 Physbones 参数进行控制，让 avatar 之间的交互可以控制设备输出（ 例如触碰或是拉伸动骨）。\n\n  - **ChatBox 显示**：可以通过 VRChat 的 ChatBox 显示当前设备信息。\n\n- [**Terrors of Nowhere**](https://terror.moe/) 游戏联动功能：\n\n  - 游戏内受到伤害会增加设备输出，游戏内死亡会触发死亡惩罚。\n  - 通过 [ToNSaveManager](https://github.com/ChrisFeline/ToNSaveManager) 的 WebSocket API 监控游戏事件，需要在游玩 ToN 时运行这个存档软件，并打开设置中的 WebSocket API 服务器。\n\n**补充说明：**\n\n- 面板控制功能需要在 Booth 购买 [声音面板](https://booth.pm/zh-cn/items/5950846) 后将资源导入工程，再导入本项目提供的修改包，将修改包内提供的 prefab 安装到您的 avatar 中。此处的修改包发布已获取 [ VRサウンドパッド ] 原作者授权。\n- 如果需要缩短对 ToN 游戏状态的响应时间，可以调整 ToNSaveManager 设置中的 **常规-设置更新速率**，将更新速率设置为 100ms（默认为 1000ms，根据实际情况调整）。\n\n\n## 快速开始\n\n视频使用教程: https://www.bilibili.com/video/BV1k81VYfETR\n\n1. 下载 [release](https://github.com/ccvrc/DG-LAB-VRCOSC/releases) 中最新版本的 `DG-LAB-VRCOSC.zip`，解压后运行\n2. 点击主界面的 `启动` 来生成二维码，然后使用 DG-LAB APP 连接 DG-LAB 3.0 主机，点击 APP 中的 `SOCKET控制` 然后扫描此处二维码连接设备。\n3. 如果遇到问题，可以通过日志排查。建议检查网卡和端口是否设置正确，修改后再次尝试启动。\n\n\u003e 注意：你需要修改你使用的模型，才能让此程序与游戏中的 avatar 联动。\n\u003e ToN 游戏支持不需要修改模型，只需按上面的说明启用 ToNSaveManager 的 WebSocket API 接口即可。\n\n## 问题反馈\n\n如果在使用过程中遇到问题，欢迎在 [Issues](https://github.com/ccvrc/DG-LAB-VRCOSC/issues) 中提出。\n\n访问[问题收集表](https://qiz80xlgzfj.feishu.cn/base/Db7KbBBmfaQmoXsk2BGcBddrnoc?table=tbl2hzoJWjaUkyyT\u0026view=vewMnpNgGD)以查看当前收集到的BUG。\n\n可以加入VRChat的游戏内群组 [DG-LAB-VRCOSC](https://vrc.group/CCVRC.1997) 来接收软件的更新动态。\n\n## 注意事项\n\n 1. 本程序及开发者不对使用该本程序产生的**任何后果**负责，使用程序则视为同意本条款。\n 2. 请遵循 DG-LAB APP 中的说明，以安全的方式使用设备，使用此程序前请根据个人情况设置合理的强度上限。\n 3. 本程序大部分代码使用 LLM 生成，未经过充分的测试！使用时请注意风险！\n \n## 界面说明\n\n\u003e 以下是 v0.1 版本程序的界面\n\n程序界面：\n![DG-LAB-VRCOSC-MainUI-CN.png](docs%2Fassets%2FDG-LAB-VRCOSC-MainUI-CN.png)\n\nSoundPad 控制面板界面：\n![DG-LAB-VRCOSC-SoundPad-CN.png](docs%2Fassets%2FDG-LAB-VRCOSC-SoundPad-CN.png)\n\nVRChat 游戏内轮盘菜单：\n![DG-LAB-VRCOSC-VRChatMenu-CN.png](docs%2Fassets%2FDG-LAB-VRCOSC-VRChatMenu-CN.png)\n\n## About\n\n这个程序一开始只是为了做下面图片中的事情（画的好棒），后来想更完善些就加上了 UI 和 ToN 游戏的支持。\n\n\u003cdiv style=\"display: flex; align-items: center;\"\u003e\n    \u003cimg src=\"docs/images/dg-lab-start.png\" alt=\"dg-lab-start\" style=\"height: 450px; margin-right: 10px;\"\u003e\n    \u003cimg src=\"docs/images/misaka-h.png\" alt=\"misaka-h\" style=\"height: 450px;\"\u003e\n\u003c/div\u003e\nArtworks by Wanlin\n\n## 编译与构建\n\n### 环境准备\n```bash\n# 1. 安装 Python 3.12\n# 下载并安装 Python 3.12: https://www.python.org/downloads/\n\n# 2. 安装项目依赖\npip install -r requirements.txt\n```\n\n### 构建步骤\n```bash\n# 3. 生成版本文件\n./generate_version.ps1\n\n# 4. 构建可执行文件\npyinstaller DG-LAB-VRCOSC.spec\n```\n\n## 构建发布版本\n\n### 创建发布标签\n```bash\n# 1. 创建版本标签 (格式: v0.0.0)\ngit tag v0.0.0\n\n# 2. 推送标签到远程仓库\ngit push origin v0.0.0\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccvrc%2Fdg-lab-vrcosc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fccvrc%2Fdg-lab-vrcosc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccvrc%2Fdg-lab-vrcosc/lists"}