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
- 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
BloxBot connects two things:
- A desktop app (Electron, Effect, and React) where you chat with AI
- 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.
Download the installer for your platform from the releases page:
| Platform | File |
|---|---|
| macOS (Apple Silicon and Intel) | BloxBot-x.y.z-mac.dmg |
| Windows (64-bit) | BloxBot-Setup-x.y.z.exe |
| Debian / Ubuntu (64-bit) | BloxBot-x.y.z-linux-amd64.deb |
- Install and open BloxBot
- Open Roblox Studio and open (or create) a place
- In Studio, open Assistant settings (three-dot menu) → MCP Servers → enable Studio as MCP server
- Connect an AI provider in BloxBot's Settings → Providers
- Start building
macOS: The app is signed and notarized. Open the .dmg and drag BloxBot to Applications.
Windows: From v0.13.7, the installer and app are signed by Paralov AS. SmartScreen may still warn about a new release for a while. Click "More info" then "Run anyway".
Linux: Install the .deb with your software center or sudo apt install ./BloxBot-*.deb.
# Install frontend dependencies
pnpm install
# Run in development mode
pnpm devProduction builds require VITE_POSTHOG_PROJECT_TOKEN. Copy .env.example to
.env.local for local packaging. GitHub Actions injects the public project token
from the POSTHOG_PROJECT_TOKEN repository variable when building release artifacts.
On first launch, BloxBot downloads the newest compatible OpenCode 1.x.x
release and verifies its SHA-256 digest. Later launches check for compatible
minor and patch updates and can fall back to the newest verified cached copy
when offline.
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
electron/ # Electron main process and preload bridge
icons/ # Desktop installer icons
main.ts # Secure window, IPC, updates, and lifecycle
services/OpenCodeBinary.ts # Runtime download and verified per-user cache
services/OpenCode.ts # Effect-scoped OpenCode process lifecycle
| Command | Description |
|---|---|
pnpm dev |
Run the full app in dev mode |
pnpm package |
Production build and installers |
pnpm test |
Run all tests |
pnpm typecheck |
Type-check app, Electron, and release scripts |
pnpm lint |
Lint frontend code (Biome) |
- Frontend: React 18, TypeScript, TanStack React Query, Tailwind CSS
- Desktop runtime: Electron with Effect-managed services
- AI engine: OpenCode
- Studio integration: Roblox Studio MCP (built-in)
- Testing: Vitest, React Testing Library