Troubleshooting

My project won't load

Three causes in order of likelihood:

1. Browser doesn't support WebGL 2.0. Open chrome://gpu or your browser's equivalent and confirm WebGL 2 is enabled. Charios requires it.
2. Sign-in expired. Hard refresh (⌘ + Shift + R). If the dashboard redirects to sign-in, re-sign in with Google.
3. Server-side issue. Check our status — if other users report the same, we're probably aware. Otherwise email hello@charios.com with the project ID.

My edits aren't being saved

Charios saves automatically about 1.2 s after your last edit. Check the bottom-left status pill — if it never reaches "Saved", you have a connectivity issue. Other things to check:

• Tab is in a sleeping state. Some browsers throttle JS in background tabs. Bring Charios to the foreground and editing resumes.
• You're hitting the project limit. Free is capped at 3 active projects. Saves on existing projects always work, but creating new ones above the limit fails.
• Storage upload failed. Layers PNGs upload to our object store on drop, not on save. If a layer's upload fails, you'll see a small warning icon on the layer row.

A mocap clip looks broken on my character

Toggle the skeleton overlay on first — it tells you whether the issue is the clip or your sprites. From the wireframe:

• Bones look reasonable, sprites are askew — sprites are parented to the wrong bones. Drag them onto the right bone in the layer panel.
• Bones look broken — bad source mocap. Try a different clip; if every clip looks broken, your body shape might be too extreme. Reset body shape and re-test.
• Bones flicker — usually a custom mocap import issue. Try a bundled clip; if bundled clips work, the imported file is the problem.

Auto-cut grouped my body parts incorrectly

Auto-cut works on alpha-island connectivity — anything touching gets merged. Two fixes:

• Re-export your art. Erase the connecting pixels in your image editor and re-upload.
• Use Shift-drag custom rectangles. Hold Shift while dragging in the upload preview to draw your own crop. The custom crop participates in bone-snap exactly like an auto crop.

AI variants failed to generate

• You hit your monthly quota. Pro is 50 generations / month. Wait for the reset on the 1st, or upgrade to Team for unlimited.
• Vertex API hiccup. Rare but happens. Try again in a few minutes. If consistent across multiple attempts, email us.
• Source layer is too small. If a layer's PNG is < 64×64, the model can't usefully reinterpret it. The variant will skip that layer; the original stays in place.

My export landed broken in Unity / Godot / Unreal

See Export troubleshooting for common engine-specific issues.

Still stuck?

Email hello@charios.com with: your project ID (URL bar), what you tried, and a screenshot of the issue. We respond within 24 hours on business days.