Content
# RobloxForge MCP
> Build Roblox experiences with AI at the level of a dedicated Roblox developer.
RobloxForge is an AI-native Model Context Protocol (MCP) server for Roblox Studio.
Unlike existing Roblox MCP servers that expose only low-level APIs, RobloxForge provides high-level building primitives, verification, persistence awareness, playtesting feedback loops, project memory integration, and reference-image-assisted development.
The goal is simple:
**Make an AI assistant behave like a Roblox developer instead of a script generator.**
---
# Why RobloxForge?
Most existing Roblox Studio MCP integrations expose tools such as:
* Run Luau code
* Create an instance
* Set a property
* Read an object
While useful, these tools operate at an extremely low level.
Building a single room often requires dozens of separate tool calls.
This leads to common problems:
* Slow development cycles
* Silent failures
* Missing objects
* Unsaved work
* AI forgetting project conventions
* Repetitive instance creation
* No automated verification
* No access to Studio output logs
RobloxForge solves these issues by moving intelligence into the tool layer itself.
Instead of creating forty individual parts, an AI can create an entire room with a single operation.
---
# Architecture
RobloxForge follows the same proven architecture used by modern Roblox Studio MCP implementations.
```text
Claude Code
│
│ MCP / stdio
▼
RobloxForge Server (Node.js + TypeScript)
│
│ HTTP Long Polling
▼
Roblox Studio Plugin (Luau)
```
The Studio plugin acts as the source of truth.
The server queues commands.
The plugin executes them inside Roblox Studio and reports the actual results back to the AI.
This allows verification, error detection, and future automation features.
---
# Core Features
## Batch Building
Create entire structures using a single tool call.
Examples:
* Rooms
* Corridors
* Storage areas
* Shelving systems
* Machinery
* Modular facility sections
Instead of:
```text
40+ individual CreatePart calls
```
RobloxForge allows:
```text
1 build_room call
```
---
## Verification First
Every create and modification operation is verified.
After an object is created:
* RobloxForge reads it back
* Compares requested values
* Detects mismatches
* Reports failures immediately
No more silent success.
No more "the AI thinks it worked".
---
## Persistence Awareness
RobloxForge understands the difference between:
* Studio runtime changes
* Undo history
* Saved projects
Tools automatically create waypoints.
Save operations report honest status instead of pretending changes are persisted.
---
## Playtest Feedback Loops
RobloxForge can:
* Start a playtest
* Capture logs
* Read warnings
* Read errors
* Stop playtests
This enables autonomous debugging workflows.
Example:
1. AI creates script
2. AI starts playtest
3. Script errors appear
4. AI reads logs
5. AI fixes code
6. AI retests
---
## Project Memory
RobloxForge integrates directly with project documentation.
Supported files:
```text
CLAUDE.md
memory/roadmap.md
memory/decisions.md
```
The AI can:
* Read project rules
* Read architectural decisions
* Update roadmaps
* Append changelogs
* Create ADRs
This helps maintain long-term project consistency.
---
## Reference Image Workflows
RobloxForge supports image-assisted development.
Examples:
* Extract color palettes
* Analyze visual mood
* Use concept art as inspiration
* Generate room layouts from sketches
The AI handles interpretation.
RobloxForge provides the tools required to execute the design.
---
# Feature Comparison
| Feature | Typical Roblox MCP | RobloxForge |
| ------------------------- | ------------------ | ----------- |
| Instance Creation | ✅ | ✅ |
| Property Editing | ✅ | ✅ |
| Batch Operations | ❌ | ✅ |
| Verification | ❌ | ✅ |
| Studio Output Access | ❌ | ✅ |
| Playtest Automation | ❌ | ✅ |
| Project Memory | ❌ | ✅ |
| High-Level Building Tools | ❌ | ✅ |
| Reference Image Support | ❌ | ✅ |
| Persistence Awareness | ❌ | ✅ |
#
---
# Installation
Clone the repository:
```bash
git clone https://github.com/efefefe435-ux/robloxforge.git
cd robloxforge
```
Install dependencies:
```bash
npm install
```
Build:
```bash
npm run build
```
Run:
```bash
npm start
```
#
---
# Design Principles
RobloxForge is built around several core principles.
### Verification Over Assumption
Never assume an operation succeeded.
Verify it.
### High-Level Tools Over Low-Level Repetition
AI should think about rooms, systems, and gameplay.
Not individual parts.
### Honest Persistence
Unsaved changes should never be reported as saved.
### Project Context Matters
An AI should remember project rules.
### Fast Iteration
Building and testing should happen in a continuous loop.
---
# Contributing
Contributions are welcome.
Before submitting major changes, please open an issue describing:
* Problem
* Proposed solution
* Expected impact
This helps keep architecture decisions consistent.
---
# License
MIT License
See the LICENSE file for details.
---
# Vision
RobloxForge is not intended to be another Roblox Studio MCP wrapper.
The long-term goal is to provide an AI-native development environment where an assistant can build, test, verify, debug, and maintain Roblox projects with the efficiency of a dedicated developer.
The AI should not merely write code.
It should be able to build games.
send feedbacks for me in dm beospie06 discord
