Diagnostics and troubleshooting
Read the right diagnostic
Diagnostics include a code, severity, message and where available source span/identity. Source spans are UTF-16 half-open offsets. Select the object/cue and inspect its related diagnostics; read the bottom status for invalid-draft or stale-job state. Warnings can indicate approximation even if compilation succeeds.
Common problems
| Symptom | Check / recovery |
|---|---|
| Invalid draft; previous scene retained | Open source diagnostics. Fix malformed units/references or explicitly restore accepted source; compile before prompting. |
| Prompt did not move requested wall | Disambiguate asset vs instance; add semantic notes; inspect boundary vs target-local relation and partial warnings. |
| No move/rotate gizmo | Select visible unlocked instance; stop playback; accept/fix draft; Focus object. |
| Object too big or sideways | Inspect measured bounds vs semantic profile and orientation evidence; author explicit height/up/front overrides. |
| Dog height looks wrong | Check withers reference and confidence, not only total bounds height. |
| Physics controls disabled | Enable physics, compile, inspect collider/readiness diagnostics; unsupported shapes are not ready. |
| No walking animation | Check real clip list, in-place ownership and manifest pin; no animation can be invented. |
| No sound | Use Enable/resume audio gesture; verify supported MP3/PCM WAV and resource hash/URI. |
| NPC unavailable | Check optional host transport/API provider; end conversation normally; no browser key. |
| WorldPack export rejected | Compile all drafts, verify pinned resources, resolve stale results; do not bypass validation. |
| Room passage blocked | Inspect actual wall occupancy and actor envelope; portal metadata does not cut geometry. |
| Save conflict | Reload latest revision and reconcile your draft; do not overwrite concurrent work blindly. |
Safe investigation
Keep a copy of source and diagnostics before changing a draft. Do not delete asset/manifests to fix a rendering issue: saved projects may pin them. Reproduce in an isolated project, then test save/reload/reset. Report the build commit, error code, minimal source and asset provenance; never share API keys or private project data.
Current website and account checks
| Symptom | Check / recovery |
|---|---|
| Local editor only shows a connection error | Check API port 8000 and frontend proxy; the account-mode request needs the API even when local login is disabled. |
| Production account cannot open editors | Verify email, approval and session status. Password reset does not grant approval. |
| RAMS character fills the preview | Check the simulated display and canvas CSS sizing; preview fit scale is not player camera zoom. Reload matching frontend/runtime builds. |
| RAMS 3D appears incomplete | Wait for model and texture readiness; verify accepted scene, resource responses and selected runtime profile. |
| .qway export reports schema validation | Keep the original project. Read the exact failing field, confirm matching application/schema versions and migrate only on a backed-up copy. |
| Contact form is missing | Configure the intended contact destination and endpoint. Preview intentionally blocks actual submission. |
| Unknown or changed SSH key | Compare fingerprints through a trusted channel; do not accept blindly. |