Skip to content

paralov/app-bloxbot-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BloxBot

AI-assisted Roblox development. BloxBot is a free, open-source desktop app that connects any AI model to Roblox Studio's official MCP server, so you can build games by describing what you want.

Download the latest release | Website

What it does

  • Chat with AI models (Claude, GPT, Gemini, and more) that can read and modify your Roblox Studio project in real time
  • Create scripts, build UI, manipulate the explorer hierarchy, edit properties - all through natural language
  • Uses Roblox Studio's built-in MCP server, giving the AI structured access to Studio. No plugins to install
  • Bring your own API key from any supported provider, or connect via OAuth

How it works

BloxBot connects two things:

  1. A desktop app (Tauri v2 - React frontend, Rust backend) where you chat with AI
  2. An AI server (OpenCode) that manages model connections, sessions, and tool use

The AI connects to Roblox Studio through its official built-in MCP server. When you type a message, the AI uses MCP tools to directly inspect and modify your open Studio project.

Installation

Download the installer for your platform from the releases page:

Platform File
macOS (Apple Silicon) BloxBot_x.x.x_aarch64.dmg
macOS (Intel) BloxBot_x.x.x_x64.dmg
Windows (64-bit) BloxBot_x.x.x_x64-setup.exe

Setup

  1. Install and open BloxBot
  2. Open Roblox Studio and open (or create) a place
  3. In Studio, open Assistant settings (three-dot menu) → MCP Servers → enable Studio as MCP server
  4. Connect an AI provider in BloxBot's Settings → Providers
  5. Start building

Platform notes

macOS: The app is signed and notarized. Open the .dmg and drag BloxBot to Applications.

Windows: SmartScreen may warn about an unknown publisher. Click "More info" then "Run anyway".

Development

Prerequisites

Setup

# Install frontend dependencies
pnpm install

# Download bundled runtimes (Node.js + OpenCode sidecar)
make deps

# Run in development mode
make dev

Project structure

src/                    # React/TypeScript frontend
  components/           #   UI components (Chat, Settings, Sidebar, etc.)
  hooks/                #   React Query hooks (queries + mutations)
  lib/                  #   Pure utilities (sseDispatch, queryKeys, splitModelKey)
  providers/            #   Context providers (OpenCodeClient, ActiveSession, Preferences)
  test/                 #   Test setup and utilities
src-tauri/              # Rust backend
  src/lib.rs            #   App setup, menu, window management
  src/opencode.rs       #   OpenCode server lifecycle
  src/paths.rs          #   Path resolution (sidecar, Node.js)

Key commands

Command Description
make dev Run the full app in dev mode
make build Production build
make test Run frontend tests
make check Test + type-check + lint (frontend + Rust)
pnpm lint Lint frontend code (Biome)

Tech stack

  • Frontend: React 18, TypeScript, TanStack React Query, Tailwind CSS
  • Backend: Rust (Tauri v2)
  • AI engine: OpenCode
  • Studio integration: Roblox Studio MCP (built-in)
  • Testing: Vitest, React Testing Library

License

MIT

About

A desktop app for building Roblox games with AI

Topics

Resources

License

Stars

Watchers

Forks

Contributors