Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/nnaridz/RbxGenie/llms.txt

Use this file to discover all available pages before exploring further.

RbxGenie Hero Light

​
What is RbxGenie?

RbxGenie is an AI Vibe Code tool that connects AI agents directly to Roblox Studio. It provides a daemon + plugin architecture with MCP (Model Context Protocol) support, enabling AI assistants like Claude to read, modify, and execute code in your Roblox projects. All operations are undoable via Ctrl+Z thanks to ChangeHistoryService integration.

​
Key Features

46 Powerful Tools

Read and modify instances, properties, scripts, attributes, tags, and more. Execute Luau code and automate playtesting.

MCP Server Support

Native integration with Claude Desktop and Cursor through the Model Context Protocol.

HTTP API

Direct REST API access for custom AI agents, scripts, or any HTTP client.

Event-Driven Bridge

Efficient long-polling architecture between the Node.js daemon and Roblox Studio plugin.

Full Undo Support

All AI changes are tracked via ChangeHistoryService. Undo with Ctrl+Z.

Type-Safe Serialization

Automatic conversion between JSON and Roblox types (Vector3, CFrame, Color3, UDim2, etc.).

​
How It Works

  1. AI Agent sends a tool request via MCP or HTTP
  2. Daemon (Node.js on port 7766) queues the command
  3. Plugin polls for commands, executes in Roblox Studio
  4. Results flow back through the daemon to the AI agent

​
Architecture Overview

RbxGenie consists of three main components:
1

Daemon (Node.js)

Express server running on http://127.0.0.1:7766 that manages command queuing and provides both HTTP and MCP interfaces.
2

Plugin (Lua)

Roblox Studio plugin that polls the daemon for commands, executes them using 46 specialized tools, and returns results.
3

MCP Server

Optional stdio transport layer that exposes all tools to Claude Desktop and Cursor via the Model Context Protocol.
All operations are wrapped in ChangeHistoryService.SetWaypoint for full undo/redo support.

​
Quick Example

Create a part and set its properties: 
curl -X POST http://127.0.0.1:7766/tool/create_object_with_properties \
  -H "Content-Type: application/json" \
  -d '{
    "path": "Workspace",
    "className": "Part",
    "properties": {
      "Name": "MyPart",
      "Size": {"type":"Vector3","value":[10,5,10]},
      "Position": {"type":"Vector3","value":[0,5,0]},
      "BrickColor": {"type":"BrickColor","value":"Bright red"},
      "Anchored": true
    }
  }'

​
Use Cases

Use Claude or other AI assistants to generate and modify game objects, scripts, and UI elements through natural language.
Write scripts that use the playtest tools to automatically test game mechanics and capture results.
Modify hundreds of instances at once using mass operations (mass_set_property, mass_create_objects, etc.).
Generate scripts with AI and inject them directly into your game using set_script_source.
Build custom editors, validators, or migration scripts using the HTTP API.

​
Ready to Get Started?

Quickstart

Get RbxGenie running in under 5 minutes

Installation

Detailed installation guide for all components

Tools Reference

Explore all 46 available tools

Architecture

Deep dive into how RbxGenie works