Docs / Guides

Frequently Asked Questions

Couldn't find your answer? Ask on the AstraBlox Discord (discord.gg/25buSZhsd5) — community members and support are there to help.


General

Is AstraBlox Studio free?
Yes, the app is free to download and install. You connect your own AI subscription (ChatGPT Plus/Pro, Claude Pro/Max, Google Antigravity) or API key, so you only pay what your own AI provider charges.

Is the source code available?
No. AstraBlox Studio is closed-source, proprietary software. This GitHub repository only publishes official installers, changelogs, and user documentation.

What platforms are supported?
Windows 10 and 11 (64-bit), macOS 11 or newer (Apple Silicon and Intel), and 64-bit Linux. Roblox Studio has no Linux version, so on Linux you run it through Vinegar; AstraBlox finds it automatically.

Is there a web version I can use in my browser?
Yes! Open AstraBlox Studio Web Edition in your browser with no install required. Create a saved login (auto-restored in your browser, with optional encrypted GitHub Gist cloud sync and portable .astrablox-account.json backups), connect your own Gemini, Claude, OpenAI, or OpenRouter key, generate Luau scripts, preview UI, run security checks, edit 3D animations, and download .rbxlx / .rbxmx files straight to Roblox Studio. For live Studio bridge sync, Blender local 3D modeling, and multi-bot Player Simulation, use the Desktop app.


Installation & Updates

Windows says "Windows protected your PC" when running AstraBloxSetup.exe. Is it safe?
Yes — click More info → Run anyway. Microsoft SmartScreen displays this warning on new indie desktop installers that do not yet have an EV code-signing certificate. You can verify the official SHA-256 checksum on every GitHub Release before running it.

My Mac says "Apple could not verify AstraBlox Studio is free of malware".
The easiest fix is installing with one Terminal command, which opens with no warning: curl -fsSL https://bobkinloch5-creator.github.io/astrablox/install-mac.sh | bash If you already used the DMG: click Done, then open System Settings → Privacy & Security, scroll down and click Open Anyway next to AstraBlox Studio. Or paste xattr -dr com.apple.quarantine "/Applications/AstraBlox Studio.app" into Terminal. You only do this once. (Newer macOS no longer offers right-click → Open for apps that aren't notarized by Apple yet.)

How do updates work?
AstraBlox checks GitHub Releases and shows a popup when a new version is out: Update now, What's new, Remind me later or Skip this version. The Update Center in Settings has automatic checks, automatic install, a beta channel and your update history. Downloads are checksum-verified and your projects, settings and keys are kept.

How do I uninstall?
Use Settings → Uninstall on any system, Apps & features on Windows, the uninstall script on Mac and Linux. See the Install Guide.

Does updating overwrite my projects or API keys?
No. The app itself is stored separately from your data: your projects, style guides, AI memory, and encrypted vault keys live in the .astrablox folder in your home folder.


Connecting Roblox Studio & AI Providers

The Roblox Studio plugin isn't connecting (Studio Offline). How do I fix it?
1. Keep AstraBlox Studio open (it runs locally on 127.0.0.1:4860).
2. Click Settings → Roblox Plugin & Keys → Install plugin, then restart Roblox Studio.
3. In Roblox Studio, open Home → Game Settings → Security, turn Allow HTTP Requests ON, and click Save.
4. If Roblox Studio asks to allow localhost (127.0.0.1) requests, click Allow.
5. Check Roblox Studio's Output window — it should print [AstraBlox] Bridge loaded. If stuck, click Ping Studio inside the top Performance Monitor pill.

Which AI provider should I use?
- For full games & complex scripts: Claude Pro/Max (Claude Code), ChatGPT Plus/Pro (Codex gpt-6.1-sol), or Google Antigravity (gemini-4-hydrogen-xhigh / high).
- Let Auto Model stay ON so AstraBlox automatically saves quota/time by routing small tweaks to fast models like gemini-3.8-flash-low or haiku.

Antigravity warns about an email mismatch — what does that mean?
You set an Expected Google Account Email in Settings → AI Providers, and the currently active Antigravity sign-in uses a different Google account. Click Connect / Switch Account to switch to the right account.

Do I need Blender or Meshy?
They are optional, though installing Blender 4.x (free) lets AstraBlox generate detailed 3D weapons, buildings, props, and creatures locally on :9876 instead of relying solely on Studio parts. You can also connect Meshy AI or Tripo AI for cloud 3D generation.


Usage, Safety & Support

Why did AstraBlox refuse my prompt or model request?
AstraBlox enforces family-friendly safety filtering across chat, 3D generation, images, voice, and script review. Requests involving adult/18+ content, gore, drugs, hate, self-harm, or cheats/exploits are blocked before reaching the AI. See SAFETY.md.

What is player simulation?
Ask the AI to "simulate players" (up to 20 bots). Bot characters play your game in a real Studio playtest and report where they die and why, where they get stuck, which checkpoints or finish lines nobody can reach, server FPS and script errors. Bots aren't real Roblox accounts, so anything tied to a real player (like saving data) is covered by the normal playtest.

Can I stop Auto Playtest from starting every time?
Yes — keep Auto Playtest toggled OFF in the chat bar. When OFF, AstraBlox never enters Play mode on its own.

I don't hear the completion sound.
Click anywhere inside the AstraBlox window once after opening (Chromium pauses audio until first click) and ensure Play a sound when the AI finishes a task is checked in Settings → Themes & Lock.

Where can I get more help?
- Join our Discord Server (discord.gg/25buSZhsd5) - Read the Configuration Guide - Open a Bug Report