Getting started

BloxBot setup guide: from download to your first game

March 30, 2026

This guide walks through every step of setting up BloxBot, from downloading the app to having AI place its first part in your Roblox Studio project. By the end, you'll have a working setup and know how to verify that everything is connected.

What you need before starting

• Roblox Studio installed and updated
• A computer running Windows or macOS
• An API key from an AI provider (Anthropic, Google, OpenAI, or OpenRouter), or a provider that supports OAuth

Don't have an API key yet? We'll cover how to get one in Step 3.

Step 1: Download and install BloxBot

Go to the latest release page and download the installer for your platform.

macOS

Open the .dmg file and drag BloxBot into your Applications folder. The app is signed and notarized, so it should open normally. If macOS still shows a security warning, right-click the app and choose Open to bypass Gatekeeper on first launch.

Windows

Run the installer. Windows SmartScreen may show a warning because the app is from a smaller publisher. Click More info, then Run anyway.

Launch BloxBot after installing. You should see the main chat interface with a settings icon.

Step 2: Enable the MCP server in Roblox Studio

BloxBot talks to Roblox Studio through its built-in MCP server. This is what lets AI read your project, create scripts, place parts, and edit terrain directly.

1. Open Roblox Studio and load any place (or create a new one from the Baseplate template).
2. Open the Assistant panel. Click the three-dot menu in the top right.
3. Go to MCP Servers.
4. Enable Studio as MCP server.

You only need to do this once. Studio remembers the setting across sessions.

Step 3: Connect an AI provider

BloxBot supports multiple AI providers. You'll need an API key from at least one.

1. In BloxBot, click Settings (the gear icon).
2. Go to Providers.
3. Pick a provider and enter your API key.

Which provider should you pick?

• Anthropic (Claude) - strong at complex game logic and multi-step tasks. Claude Opus 4.6 scores highest on structured Roblox tasks. Get an API key at console.anthropic.com.
• Google (Gemini) - Gemini 3 Pro leads the OpenGameEval benchmarks overall. Good all-around choice. Get an API key at aistudio.google.com.
• OpenRouter - a single API key that gives access to many models. Useful if you want to switch between providers without managing multiple keys.

Not sure? Start with whichever provider you already have an account with. You can always add more later.

Step 4: Verify the connection

Before building anything, confirm that BloxBot can talk to Studio.

1. Make sure Roblox Studio is open with a place loaded.
2. Make sure BloxBot is running and shows a green connection indicator.
3. Type a simple test prompt:

Create a red part named "TestBlock" at position 0, 10, 0 in Workspace.

If everything is working, you should see a red block appear in your Studio viewport within a few seconds. Check the Explorer panel to confirm "TestBlock" is in Workspace.

If the block appeared, your setup is complete. Delete the test block and start building.

Troubleshooting

BloxBot shows no connection

• Make sure Roblox Studio is open with a place loaded, not just the home screen.
• Confirm the MCP server is enabled in Studio's Assistant settings.
• Restart both BloxBot and Studio, then check again.

AI responds but nothing happens in Studio

• The MCP server might not be enabled. Go back to Step 2 and verify.
• Try a simpler prompt, like creating a single part. Complex prompts can fail silently.

macOS security warning won't go away

• Right-click the app and choose Open instead of double-clicking.
• If that doesn't work, go to System Settings > Privacy & Security and click Open Anyway.

Windows SmartScreen blocks the installer

• Click More info on the SmartScreen popup, then Run anyway.

API key errors

• Double-check that you pasted the full key with no extra spaces.
• Make sure your API account has credits or an active billing plan.
• Some providers require you to enable API access separately from your regular account.

What to build first

Your setup is ready. Here are some good starting points:

• Build a Roblox obby with AI in 10 minutes - a step-by-step tutorial for your first complete game.
• Tips for getting better AI results - practical prompting patterns that work well with Roblox development.

Back to BloxBot