Troubleshooting
Common issues and how to resolve them.
Common Errors
"Not enough credits" or generation won't start
Image and 3D generation are credit-billed (1 credit = $0.01). An image costs 2–12 credits and a 3D model 10–90, depending on the model. Credits expire 6 months after they're granted; when some expire within 14 days, the balance in the title bar turns amber with an hourglass.
Solution: Check your balance in Settings → Account, which also lists every expiry date, and purchase credits if needed. Make sure you're signed in.
"API Key Invalid" (bring-your-own-key providers only)
If you've added your own key for Gemini, Claude, OpenAI, z.ai, OpenRouter, Groq, xAI, DeepSeek or Mistral, the provider rejected it. Hyper 30, Ollama and LM Studio don't need a key: if one of them, or a retired model (Devstral, DeepSeek V4 Flash), told you to check your API key, that was a bug fixed in v0.1.30, so update HyperDevs.
Solution: Verify the key is correct and has credits available on the provider's dashboard, then re-enter it under Settings → AI Providers and save it. Once the key is saved, the provider reads "Configured"; "Not saved" means your edit isn't saved yet.
A 3D generation is taking forever
High-quality models (Rodin, Hunyuan3D) and multi-view jobs legitimately take 1–8 minutes. They're usually not stuck.
Solution: Give it time — generation keeps running even if you switch tabs. For faster results, use TripoSR.
Studio won't connect / Studio plugin not loaded
HyperDevs connects to Roblox Studio by itself whenever a place is open. The Studio light in the tab bar is green when connected and yellow while it waits for Studio. If another app holds the connection to Studio, such as a second copy of HyperDevs or another Roblox Studio MCP server, HyperDevs names it and connects once that app closes.
Solution: The plugin installs itself, but if Studio was already open, restart it once to load the plugin. Make sure a place is open in Studio and close any app HyperDevs names, then use "Test Connection" in Settings → Integration to try again now. With two places open, HyperDevs uses the one in the Game tab, or else the one you opened last. Studio's "Allow HTTP Requests" doesn't need to be on. Restart both apps if needed.
The AI says it can't change something
Before the AI changes your game, HyperDevs asks you first. Only a click answers that prompt, not keys you type in the chat. Escape or the close button refuses just that request, and Deny blocks only that one action, unless you ticked Remember.
Solution: Ask the AI again and click Allow when the prompt appears. When the AI makes several changes at once, one Allow covers them all.
Reply ended at the step limit
A reply that's cut off at the step limit ends with a note saying so.
Solution: Send "continue" to keep going.
Hyper 30
Hyper 30 is slow, unavailable, or out of free use
- ✓ Long Thinking: A reply can keep thinking for up to an hour. The chat shows "Reading your request…", then how long it's been thinking, such as "Thinking · 3 min"
- ✓ Free Use: Hyper 30 is free to use every day, and the meter under the message box shows how much you've used. When it's used up, the chat says so and when it resets (00:00 UTC). To keep chatting, keep going with credits, or bring your own API key, free and unlimited (see AI Providers). Free use can also pause until next month if HyperDevs' free budget for the month runs out; credits still work
- ✓ Length Limit: A free message can run for up to about 3 hours. If one stops there, Continue picks up where it left off
- ✓ Credits: If you've chosen to keep going with credits, the chat stops when you don't have enough credits or you reach your daily cap. Buy credits, or raise the cap in Settings → Account
- ✓ Unavailable: If the chat says Hyper 30 is unavailable right now, try again later, or switch to another provider
- ✓ Maintenance: Messages queued during Hyper 30 maintenance go out when it ends
- ✓ "Starting the AI engine…": The first message after starting HyperDevs may show this while the engine gets ready. Your message still gets its answer
Import & Connection
Model Won't Import to Studio
- ✓ 3D Models Tab & Viewer: Their "Send to Game" builds the model in Studio, reduced to about 10,000 triangles first. If Studio isn't connected, it puts the model in the DropZone folder instead, selected and ready to drag in: open a place in Studio and Send to Game again, or drag the file into Studio
- ✓ Turn on CreateAssetAsync Luau API: For a model to stay in your game, Studio needs its "CreateAssetAsync Luau API" beta feature (File → Beta Features), then a restart. While it's off, "Send to Game" asks first and says how to turn it on; Send anyway puts the model in for this session only, and it disappears when Studio restarts. Just turned it on? Restart Studio, then Send to Game again
- ✓ Check the Studio Light: The Studio light in the tab bar should be green
- ✓ Verify Studio is Open: Must have a place loaded
- ✓ Check Polygon Count: A model over 20,000 triangles now goes in as several parts. Still optimize it first, for performance
- ✓ Publishing the Mesh: Publishing a mesh needs an ID-verified Roblox account and "Allow Mesh & Image APIs" turned on (Game Settings → Security). The app's error message lists these. If the mesh was published but its part couldn't be built, the message names the published asset
- ✓ Uploads to Roblox: "Send to Game" needs no Roblox key: Studio saves the model and its texture to your Roblox account. If Studio won't save them, the model still goes in but disappears when Studio restarts, and the app says how to fix that. Only the Animation tab's "Send to Game" for a rigged model needs a Roblox Open Cloud key, which goes in Settings → Integration. If Roblox refuses an upload, the app shows Roblox's reason
- ✓ Fallback — Show in Folder: Use "Show in Folder" or "Copy Path" to reveal the file, then drag it into Studio (File → Import 3D)
Updates
An update download seems stuck
The updater in versions before v0.1.30 could hang on a download. From v0.1.30 on, a download that stalls ends with an error and Try again.
Solution: Download the latest installer from hyperdevs.app/download and run it.
Still Need Help?
Found a bug? Click Report a bug in the HyperDevs title bar to send us a report from the app. For anything else, contact support.