PolyPotion Handbook

• Organized dock & working samples — the tool dock is now grouped by craft (create · shape · surface · rig · animate · perform), and every “Load a sample” button actually brews something: basic shapes (figure, sphere, cube, cylinder, torus knot) generated on the spot, plus shortcuts to the Library and HumanGen.
• Recipe — ⧉ non-destructive pipelines: wire steps (weld → decimate → ground → bake AO…) into a graph whose wires carry GLB buffers. Change the source mesh or any slider and everything downstream re-brews itself; grab any node's output as a .glb. The graph is saved, so a cleanup you designed once becomes a recipe you reuse.
• Retopo — ▱ guided retopology: your mesh becomes a clay reference and you draw clean quads straight onto it — 4 clicks per quad, click a boundary edge to grow the strip, X-symmetry mirrors everything, a relax brush evens the spacing, and the cage exports as a fresh GLB.
• Timeline — ≡ non-linear animation: lay your clips out as blocks, trim / re-time / crossfade them, borrow clips from other files (retargeted by bone name), and bake it all into one continuous performance clip.
• Lipsync — 👄 record a voice line (or load audio) and the character speaks it: viseme morphs, jaw bone, or an auto-built jaw shape, with the take baked into the GLB as an animation clip.
• Director — a 🎬 camera sequencer. Cut orbits, push-ins and close-ups over your character’s animation on a timeline, then render the sequence straight to a .webm video — all on-device.
• Shader Lab — a ◈ node-graph shader editor. Wire noise, voronoi, fresnel and colour ramps into your own animated looks, preview them live on your character, and publish them straight onto Showcase’s shelf with your exposed sliders intact.
• Mesh Doctor — a new ✚ tool in the dock. It audits any mesh (non-manifold edges, flipped faces, degenerate triangles, duplicate verts, UV overlap, scale mixups), scores its health out of 100, highlights each finding on the model and fixes most of them in one click.
• Play any clip on your character — every animation card in the Library now has ◈ Play on character: one click retargets the clip onto whichever character you last opened and plays it in Showcase.
• Text to pose — in the Pose tool’s left panel, describe a pose in plain words (“kneeling, arms raised”) and an AI drafts it onto the skeleton. Pick Claude, DeepSeek V4 Pro / Flash, DeepSeek V3 or Gemini; the ⚙ cog stores your API keys locally. Refine the result by dragging handles as usual.
• Drop-imports now survive a reload — meshes you drop into the Library are saved in your browser alongside baked rigs.
• Storage escape hatch — if saved characters ever refuse to load, open the command palette (⌘K) and run Reset library storage.

What this is

PolyPotion is a set of small tools that share one job: take a 3D character from a raw mesh all the way to something rigged, posed, cleaned up and ready to use. Each tool does one thing well and hands off to the next. You move between them from the dock on the left.

Most tools open any .glb, .fbx or .obj — drag a file onto the window, click Import, or open one from the Library. A typical run looks like this:

You don't have to follow it in order — jump in wherever your model already is.

Getting around

A few things work the same everywhere, so they're worth learning once.

Tips & shortcuts

Small things that save time once the layout is familiar.

That's the whole of PolyPotion. Replace the striped boxes with real screenshots whenever you like.