How cjl26rg2/void-script works
VoidScript turns an AI chat in a browser into a Roblox Studio agent: the extension detects a provider’s reply, parses commands, and sends them through a local bridge to Studio’s MCP server, returning results to the chat. The bridge also exposes embedded animation/VFX tools. The repository includes a separate Tauri desktop client with its own bridge connection and AI chat. README claims cover script/tree operations, Luau execution, asset generation, Creator Store access, play-testing, and persistent project memory; source excerpts do not expose every implementation path, so those capabilities are represented at the documented feature level.
Main entry points: app.js Desktop interface · bridge.py Bridge and MCP manager · main.js Agent loop · providers Chat providers
Components 18
Browser agent
- Chat providers
voidscript-extension/providers - Agent loop
voidscript-extension/core/main.js - Command parser
voidscript-extension/core/parser.js - Extension worker
voidscript-extension/background.js - Status and settings
voidscript-extension/popup.js
Local bridge
- Bridge and MCP manager
bridge.py - Studio MCP launcher
launch_studio_mcp.py
Studio tools
- Animation and VFX tools
creatives.py - Roblox Studio MCP
- Studio agent capabilities
Desktop client
- Desktop interface
desktop/ui/app.js - Desktop backend
desktop/src-tauri/src/main.rs - Desktop generation kit
desktop/ui/toolkit.js - Desktop model kit
desktop/ui/modelkit.js - Desktop model viewer
desktop/ui/modelview.js - Desktop UI kit
desktop/ui/uikit.js
Other components
- User
- AI chat site
Connections 20
- User → AI chat site: requests work
- AI chat site → Chat providers: hosts extension
- Chat providers → Agent loop: supplies chat interface
voidscript-extension/core/main.js - Agent loop → Command parser: parses commands
voidscript-extension/core/main.js - Agent loop → Extension worker: requests execution
voidscript-extension/core/main.js - Extension worker → Bridge and MCP manager: sends commands
- Bridge and MCP manager → Roblox Studio MCP: forwards MCP calls
- Bridge and MCP manager → Studio MCP launcher: imports launcher
bridge.py - Bridge and MCP manager → Animation and VFX tools: dispatches tools
bridge.py - Animation and VFX tools → Roblox Studio MCP: runs generated Luau
creatives.py - Roblox Studio MCP → Studio agent capabilities: provides agent operations
- Agent loop → AI chat site: returns tool results
- User → Status and settings: manages session
voidscript-extension/popup.js - User → Desktop interface: uses desktop client
- Desktop interface → Desktop backend: invokes commands
desktop/ui/app.js - Desktop backend → Bridge and MCP manager: connects to bridge
desktop/src-tauri/src/main.rs - Desktop interface → Desktop generation kit: uses generation kit
desktop/ui/app.js - Desktop interface → Desktop model kit
- Desktop interface → Desktop model viewer
- Desktop interface → Desktop UI kit