Troubleshooting

The editor shows a license error or refuses to open the agent window. Fix: close Unity, open Unity Hub, log in with your Unity account, and reopen the project. Headless/CI runs need a license before the compile-gate proof can run.

The dashboard and docs pages default to http://localhost:4000. If nothing is listening, run BrodyStart.bat and wait for [gateway] ONLINE (health check at /health). The Navbar gateway settings lets you override the URL for a deployed gateway.

PayPal subscriptions require a pre-made billing plan in the PayPal dashboard; checkout falls back to a one-off order, and the user must click "I've paid — activate" after paying. Automatic activation via webhook is being fixed.

Referral links and the 1,000-credit referral bonus are not fully wired end-to-end — the referral code fallback is hardcoded on the dashboard and the grant path is unfinished.

The studio logo path in the WelcomeWindow points to the wrong location, so the logo never renders. Cosmetic only — the window works normally.

Your provider key is missing or wrong in backend/.env — check OPENROUTER_API_KEY (plus ANTHROPIC_API_KEY / OPENAI_API_KEY if used), then restart the gateway. A 404 usually means the key, not the product.

The extension folder was not imported. Re-import the package (or copy Assets/Brody AI into your project), wait for compilation, and reload the editor — Assets → Reimport All once if needed.

The ToolCallCard image preview is fixed at 180x120 and supports .png/.jpg only (no .jpeg) — previews may crop oddly. The full image is always available in the scene.

Failed calls are refunded automatically — the ledger returns the reserved credits and the charge never sticks. GET /api/v1/billing/refund-stats reports the totals (refundCount, creditsRefunded, lastRefundAt), and every refund shows up as a green "refund" row on the usage page (GET /api/v1/usage/history). If a refund is missing, share the request_id with support.

The daily safety-net grants 10,000 free credits once per UTC calendar day when your balance is low or zero. POST /api/v1/credits/safety-net is idempotent per day — calling it twice never double-grants. It exists so a zero-balance user can keep making cheap calls instead of being hard-blocked.

Skyboxes are generated via POST /api/v1/generate/cubemap, which reserves 800 credits per generation and charges them on success. Failures usually mean an insufficient balance (top up, or claim the daily safety-net) or an invalid prompt/style payload. Check the usage page for the charge or refund row before retrying.