Skip to content

Repository files navigation

Stud

The AI Agent for Roblox Studio - Build games with AI that actually does things.

License: AGPL-3.0Made with TauriReact

Stud connects AI models (GPT-4, Claude, ChatGPT Plus/Pro) directly to Roblox Studio, enabling real-time manipulation of instances, scripts, and properties through natural language. Think Cursor AI, but for Roblox development.

Why Stud?

Most AI coding tools are built for text files. Roblox Studio is different - it's a visual tree of instances, properties, and Luau scripts. Stud bridges this gap by giving AI direct access to your Studio session.

Before Stud: Copy code from ChatGPT → Paste into Studio → Debug → Repeat

With Stud: "Create a car that players can drive" → AI creates the model, scripts, and configures everything → Done

Features

  • Direct Studio Control - AI creates, modifies, and deletes instances in real-time
  • Script Editing - Read, write, and edit Luau scripts with intelligent diff
  • 15+ AI Tools - Complete toolkit for any Roblox development task
  • Multi-Provider - OpenAI API, Anthropic API, or ChatGPT Plus/Pro (no API key needed!)
  • Live Feedback - See exactly what the AI is doing in your game
  • Undo Support - Every AI change creates an undo waypoint
  • Modern UI - Built with React 19 and prompt-kit

Demo

"Set up a basic obby with 5 platforms that get progressively harder"

The AI will:

  1. Create a folder structure for the obby
  2. Generate 5 platforms with increasing gaps
  3. Add spawn and finish checkpoints
  4. Create a respawn script for falling players
  5. Test the configuration

All while you watch it happen in real-time.

How It Works

┌─────────────┐ HTTP ┌─────────────┐ Polling ┌─────────────┐
│ Stud UI │◄────────────►│ Bridge │◄───────────────►│ Studio │
│ (React) │ :3001 │ (Rust) │ 100ms │ (Plugin) │
└─────────────┘ └─────────────┘ └─────────────┘
│
│ Vercel AI SDK
▼
┌─────────────┐
│ AI Models │
│ GPT/Claude │
└─────────────┘
  1. You type a message in Stud
  2. AI decides which tools to use
  3. Bridge Server (Rust) queues the requests
  4. Studio Plugin executes commands in your game
  5. Results flow back to AI, which continues or responds

The polling pattern is necessary because Roblox Studio can only make outgoing HTTP requests.

Installation

Prerequisites

Quick Start

# Clone the repo
git clone https://github.com/madebyshaurya/stud.git
cd stud
# Install dependencies
npm install
# Run in development mode
npm run tauri dev

Install the Studio Plugin

  1. Open Roblox Studio
  2. Go to PluginsPlugins Folder (or press Alt+P)
  3. Copy studio-plugin/stud-bridge.server.lua to this folder
  4. Restart Roblox Studio
  5. You'll see "Stud Bridge" in your plugin toolbar

Configuration

AI Providers

ProviderSetupBest For
ChatGPT Plus/ProClick "Sign in with ChatGPT"Free with subscription, no API costs
OpenAI APIAdd API key in SettingsPay-per-use, full control
Anthropic APIAdd API key in SettingsClaude models

Recommended: If you have ChatGPT Plus/Pro, use the OAuth sign-in. No API key needed, and it works with GPT-4, GPT-5, o3, and more.

Roblox Cloud API (Optional)

For DataStore access and game publishing:

  1. Go to Creator Hub > API Keys
  2. Create a key with required permissions
  3. Add to Settings in Stud

AI Tools

Instance Manipulation

ToolWhat it does
roblox_createCreate new instances (Parts, Models, Scripts, etc.)
roblox_deleteRemove instances from the game
roblox_cloneDuplicate instances
roblox_moveReparent instances to new locations
roblox_set_propertyChange any property (Position, Color, Name, etc.)
roblox_get_propertiesRead all properties of an instance
roblox_get_childrenList children (with recursive option)
roblox_searchFind instances by name or class
roblox_get_selectionGet what you have selected in Studio

Script Editing

ToolWhat it does
roblox_get_scriptRead script source code
roblox_set_scriptReplace entire script content
roblox_edit_scriptFind/replace within scripts
roblox_run_codeExecute Luau code immediately

Bulk Operations

ToolWhat it does
roblox_bulk_createCreate many instances at once
roblox_bulk_deleteDelete multiple instances
roblox_bulk_set_propertyUpdate properties across many instances

Example Prompts

Creating things:

"Create a red neon part at position 0, 10, 0 that slowly rotates"

Editing scripts:

"Add a debounce to the touch handler in game.Workspace.Coin.Script"

Bulk operations:

"Find all parts named 'Coin' and make them spin using TweenService"

Game systems:

"Set up a basic shop system with a GUI and DataStore for saving purchases"

Debugging:

"Why isn't my script in ServerScriptService working? Read it and help me fix it"

Development

# Full app with hot reload
npm run tauri dev
# Frontend only (faster iteration)
npm run dev
# Type checking
npx tsc --noEmit
# Production build
npm run tauri build

Project Structure

stud/
├── src/ # React frontend
│ ├── components/ # UI components (shadcn/ui + prompt-kit)
│ ├── lib/
│ │ ├── ai/ # AI providers and chat logic
│ │ └── roblox/ # Roblox tools (Zod schemas)
│ └── stores/ # Zustand state management
├── src-tauri/ # Rust backend
│ └── src/
│ ├── bridge.rs # HTTP bridge server (Warp)
│ └── lib.rs # Tauri app setup
└── studio-plugin/ # Roblox Studio plugin
└── stud-bridge.server.lua

Tech Stack

LayerTechnology
FrontendReact 19, Vite 7, Tailwind CSS 4, shadcn/ui
UI Componentsprompt-kit
AIVercel AI SDK v6, OpenAI, Anthropic
DesktopTauri 2 (Rust)
HTTP ServerWarp
StateZustand
ValidationZod

Roadmap

  • Toolbox Search - Visual asset picker from Creator Store
  • Auto-Planning - AI plans before executing complex tasks
  • @ Mentions - Reference instances with @game.Workspace.Part
  • Diff View - See script changes before/after
  • One-Click Games - Templates for Obby, Tycoon, FPS, etc.
  • Roblox Docs RAG - AI that knows the Roblox API deeply
  • Sub-Agents - Parallel AI workers for complex tasks

Contributing

Contributions are welcome!

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/amazing)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing)
  5. Open a Pull Request

See CLAUDE.md for code style guidelines and architecture details.

Community

  • Report bugs via GitHub Issues
  • Feature requests welcome!
  • Star the repo if you find it useful

License

MIT License - see LICENSE for details.


Made for Roblox developers who want to build faster.

Not affiliated with Roblox Corporation.

About

ai agent for roblox studio

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages