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) - Execution Modes & Smart Model Routing
- Roblox Studio Bridge, Approval Mode & Rollbacks
- 3D Modeling (
Blender,Meshy AI,Tripo AI) - Audio, Design & Publishing Keys (
Settings → Roblox Plugin & Keys) - Project Style Guide, AI Memory & Skills
- Performance Monitor & Diagnostics
- Themes, Wallpapers, Sound & Password Lock
- Updates & Release Verification
- Keyboard Shortcuts
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
- Sign in with Google Antigravity: Click Connect / Switch Account, then click Check status & models.
- Account Mismatch Protection: Enter your Google address under Expected Google Account Email (optional). AstraBlox verifies that the active Antigravity account matches what you expect and alerts you if another Google account is signed in.
- Gemini API Key (Optional): Paste an
AIza...Google AI Studio key if you prefer direct Gemini API billing. - Click Use Antigravity for chat and Test to confirm everything responds cleanly.
2. Claude (Your Claude Subscription or API Key)
- Claude Pro / Max Subscription (No API Key Needed): Click Install Claude Code (if needed), then Connect Claude subscription, complete the browser sign-in, and click Check status → Use Claude for chat.
- Anthropic API Key (Pay-Per-Use): Expand Advanced: use an API key instead and paste your
sk-ant-...key.
3. ChatGPT (Your ChatGPT Subscription or API Key)
- ChatGPT Plus / Pro Subscription (No API Key Needed): Click Install Codex (if needed), click Connect ChatGPT subscription, sign in in the browser, then click Check status → Use ChatGPT for chat.
- OpenAI API Key (Pay-Per-Use): Expand Advanced: use an OpenAI API key instead and paste your
sk-...key.
4. AgentRouter
- Enter Base URL, API Key, and select a model.
- (Optional) Enter AgentRouter User ID and encrypted System Access Token to view your live remaining balance, or manually track your budget with Track Balance and click Test & Check Money.
- Click Save & Activate.
5. Custom OpenAI-Compatible API
- Works with OpenRouter, DeepSeek, or any OpenAI-compatible
/v1endpoint. - Fill in Base URL, API Key, and exact Model Slug, then click Save & Activate.
Recommended Model Roles (Built-In Guide)
| 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:
- Install Plugin: Writes
AstraBloxBridge.server.luainto%LOCALAPPDATA%\Roblox\Pluginsand pairs it to AstraBlox on127.0.0.1:4860. - 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. - Pairing Token Controls: Reveal, Copy, or Rotate your local bridge token anytime; after rotating, click Install plugin to refresh the plugin copy.
- 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.
- Diagnostics & Undo Tools (
StudioView): - 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:
- Blender (Local AI Geometry — Free):
- Install Blender 4.x, then click Connect Blender / Test Blender (or Start
:9876) in 3D Models. - AstraBlox runs headless Blender automatically on port
9876(with strict geometry sandboxing) — no manual port setup needed. - Use Open GUI anytime if you want to inspect the
.blendresult in the Blender desktop window. - Meshy 3D AI (
msy_...) & Tripo 3D AI (TRIPO_API_KEY): - Paste keys into Settings → Roblox Plugin & Keys → Save Vault Keys (use Check Credits on Meshy to verify balance).
- Engine Selector (
3D ModelsView): Choose Auto, Blender, Meshy, or Tripo and pick from 9 asset presets (Weapon,Building,Creature,Character,Vehicle,Furniture,Nature,Prop,Armor / Accessory).
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
- Project Style Guide (
Style Guidebutton in sidebar orProjectsview): Pin your game's Art & World Palette, UI Colours (Hex / Roles), Model Scale & Proportions, Naming Rules, Reusable Asset Notes, Pinned Reference Images, and Pinned 3D Models. AstraBlox automatically keeps future generations consistent with your pinned style. - AI Memory (
Memorytoggle in sidebar /Projects → AI Memory): Inspect, edit, refresh, or clear project facts and preferences the AI remembers across sessions. - Roblox Skills (
Settings → Roblox Skills): - Filter Roblox & Workflow Skills, Pinned Favorites Only, or All Skills.
- Click Create Skill with AI to author a new reusable workflow (
SKILL.md) for tasks like rigging NPCs, receipt validation, or mobile optimization. - Import community skills from a GitHub
owner/repo/ URL, local folder, or.zip/.mdupload, and pin favorites so the AI prioritizes them (and shows which skills ran on each build).
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.