Docs / Guides

Configuration Guide

Every setting in AstraBlox Studio is designed to work out of the box while giving you full control over AI models, Roblox Studio behavior, 3D/audio tools, security, and appearance.

Need help dialing in a provider, Blender, or Studio Bridge? Ask on Discord (discord.gg/25buSZhsd5).


Table of Contents


AI Providers (Settings → AI Providers)

Open Settings (gear icon, bottom-left) → AI Providers and configure any of the five provider options:

1. Google Antigravity & Gemini

2. Claude (Your Claude Subscription or API Key)

3. ChatGPT (Your ChatGPT Subscription or API Key)

4. AgentRouter

5. Custom OpenAI-Compatible API

Task Type Suggested Models
Architecture & Security Claude Opus, Antigravity gemini-4-hydrogen-xhigh, GPT-6.1-Sol
Daily Roblox Scripting Claude Sonnet, gpt-6-astra, gemini-4-hydrogen-high
3D / World & Scene Planning gemini-4-argon-high, gemini-pro-orchestrator-g1-pro
Fast UI Tweaks & Quick Fixes gemini-3.8-flash-low / -high, Claude Haiku, gpt-5.6-luna

Execution Modes & Smart Model Routing

Right inside the chat composer bar, you can adjust how AstraBlox balances speed, depth, and testing before or between any message:

Control Options & Behavior
Execution Mode Fast (maximum responsiveness, compact prompts, lighter models, essential static checks) · Balanced (default — smart model routing, targeted playtesting, parallel independent agents) · Deep (full 8-agent multi-wave build orchestration, comprehensive planning)
Smart Model Routing (Auto Model) ON by default — automatically routes simple script/UI tweaks to fast models and heavy multi-system builds to flagship reasoning models. Click Auto Model once to switch to Manual Lock and force your selected model & effort level
Effort Selector low, medium, high (default), xhigh
3D Import Behavior 3D: Review first (inspect 3D model, scale & polycount in chat before importing) · 3D: Auto-import
Auto Playtest OFF by default — Studio never jumps into Play mode automatically unless you switch this ON or explicitly ask for a playtest

Roblox Studio Bridge, Approval Mode & Rollbacks

Configure under Studio tab or Settings → Roblox Plugin & Keys:

  1. Install Plugin: Writes AstraBloxBridge.server.lua into %LOCALAPPDATA%\Roblox\Plugins and pairs it to AstraBlox on 127.0.0.1:4860.
  2. Enable HTTP Requests in Studio: In Roblox Studio → Game Settings → Security, turn Allow HTTP Requests ON and allow localhost (127.0.0.1) connections when prompted.
  3. Pairing Token Controls: Reveal, Copy, or Rotate your local bridge token anytime; after rotating, click Install plugin to refresh the plugin copy.
  4. Approval Mode: - Fully automatic (Recommended): Applies builds straight to Studio while saving instant rollback snapshots for every turn. - Preview & approve major changes first: Holds large edits in an approval queue in the Studio view before writing to your place.
  5. Diagnostics & Undo Tools (Studio View): - Test Bridge / Inspect Live Place / Live Studio View (1 fps, 2–3 fps, or 5 fps viewport preview) - Undo Last AI Build or restore individual changed scripts without rolling back an entire session - Game Doctor (Scan my game → Fix with AI), Optimize Roblox Game, Read Studio Output, Run Game Check, Run Comprehensive Test, and Explain Error

3D Modeling (Blender, Meshy AI, Tripo AI)

Configure in the 3D Models view or Settings → Roblox Plugin & Keys:


Audio, Design & Publishing Keys (Settings → Roblox Plugin & Keys)

All external API keys are encrypted locally with your PC vault key (.vault.key inside %USERPROFILE%\.astrablox):

Key / Field Used For
ElevenLabs API Key (sk_...) Character voice-overs, dialogue lines, sound effects, and looping game music in the Audio view (Check Characters checks quota)
Figma Personal Access Token (figd_...) Importing Figma frames & color tokens directly into Roblox ScreenGui layouts in the Design view
ROBLOX_API_KEY + Creator User ID / Group ID One-click Open Cloud asset uploads (icons, thumbnails) and place publishing from the Publish tab
GitHub Token (ghp_... / github_pat_...) Optional — only needed if importing private GitHub Roblox skill repositories

Click Test All PC Connections in Settings → Roblox Plugin & Keys at any time to run a full diagnostic across every local tool and connected provider.


Project Style Guide, AI Memory & Skills


Performance Monitor & Diagnostics

Click the Performance Monitor pill in the top header anytime (idle or mid-build) to inspect: - Active Agent Role (e.g., Coordinator, Scripting, 3D Modeling, Animation, UI/UX, Game Builder, Testing, Performance) - Active Execution Mode + Model + why the router selected it - Real Elapsed Time + stage latency breakdown (Model, Studio, Tools, Wait) - Ops Completed / Failed, Subtask Progress, Queued Count, and Empirical ETA (only displayed after real subtask data exists) - Stuck Diagnostics & Quick Recovery: Ping Studio, Skip Stuck Cmd, Pause Queue, and Stop Task


Themes, Wallpapers, Sound & Password Lock

Open Settings → Themes & Lock: - Toggle Play a sound when the AI finishes a task - Switch among 18 built-in themes & animated wallpapers (AstraBlox, Claude Dark, VS Code Dark, Midnight Blue, Daylight, VS Code Light, Roblox Neon City, Medieval Castle, Cosmic Obby, Kingdom at Dusk, Sky Islands, Neon Block City, Night Village, Cosmic Cubes, Aurora, Starfield, Neon Grid, Floating Blocks) or upload a custom background image with adjustable dimming - Optionally enable Password Lock (StudioOwner or custom username + password) to lock the local IDE workspace on shared PCs


Updates & Release Verification

Open Settings → License & Updates: - By default, packaged builds are pre-configured to check bobkinloch5-creator/astrablox GitHub Releases automatically. - Click Check Updates → Update App Now to download AstraBloxSetup.exe, verify its SHA-256 hash against the release notes, and silently update + relaunch. - Click What's New / Changelog to inspect version history and verification notes.


Keyboard Shortcuts

Shortcut Action
Enter Send prompt (or queue if AI is currently running)
Shift + Enter Insert new line in prompt box
Esc Stop the currently running AI task
Ctrl + M Toggle microphone voice typing (works even while AI is building)
Drag & Drop Attach up to 6 images, .mp4/.mov/.webm videos, PDFs, .lua/.luau scripts, or .glb/.fbx/.obj models

Need help configuring something specific? Join the AstraBlox Discord (discord.gg/25buSZhsd5) or read the FAQ.