feat: polish VR gameplay and sync tools

2026-05-28 19:01:20 +09:00
parent ee34d79a66
commit 03105a4f85
50 changed files with 4986 additions and 328 deletions
@@ -0,0 +1,55 @@
+# VRBeats Unity MCP Server
+
+This MCP server connects Codex to the Unity Editor bridge in this project.
+
+## Unity side
+
+Open the project in Unity. The bridge auto-starts on domain reload and listens only on:
+
+```text
+http://127.0.0.1:19744
+```
+
+Manual controls are available in Unity:
+
+```text
+Tools > Codex Bridge > Start Server
+Tools > Codex Bridge > Stop Server
+Tools > Codex Bridge > Auto Start
+Tools > Codex Bridge > Capture Game View
+```
+
+## Install
+
+Run once from this folder:
+
+```powershell
+npm install
+```
+
+## Codex MCP config
+
+Add a server entry like this to the Codex MCP config, then restart Codex/VS Code so the tool list refreshes:
+
+```toml
+[mcp_servers.vrbeats_unity]
+command = "node"
+args = ["C:\\Users\\User-40\\Desktop\\unity\\work\\BeatSabar\\VRBeatSaber\\tools\\unity-mcp-server\\index.mjs"]
+startup_timeout_sec = 30
+
+[mcp_servers.vrbeats_unity.env]
+UNITY_BRIDGE_URL = "http://127.0.0.1:19744"
+```
+
+## Exposed tools
+
+- `unity_health`
+- `unity_capture_game_view`
+- `unity_get_console_logs`
+- `unity_list_scene_roots`
+- `unity_list_scene_objects`
+- `unity_get_object`
+- `unity_set_transform`
+- `unity_set_play_state`
+
+`unity_capture_game_view` writes `Captures/latest.png` in the project root.