fc8db5efd2
- Add PlaygroundNpcGlb component using @react-three/drei useGLTF. Loads /avatars-3d/<npcId>.glb on demand, with materials frozen and raycasting disabled (parent group handles clicks). - HEAD-probe per id with module-level cache so a missing GLB never triggers GLTF parse errors. Voxel body is the seamless fallback. - Wire useGlbAvailable() into the NPC component: when GLB present, render it instead of the voxel torso/limbs/head; nameplate chip stays. - public/avatars-3d/README.md with Meshy.ai prompts per Greek god. Drop a GLB at public/avatars-3d/athena.glb and Athena upgrades. No code change needed. Mix-and-match is supported (only some NPCs upgraded).
3D NPC bodies (optional GLB swap)
Drop GLB models named after each NPC id and they'll replace the voxel body in the Playground. The portrait-chip nameplate stays the same.
Recognized NPC ids
athena, apollo, iris, nike, pan, chronos, hermes, eros
Plus: tavernkeeper, banker, trainer, innkeeper, apothecary, recruiter, shopkeeper
Generation pipeline
- Open https://www.meshy.ai/ (free tier: 200 credits/mo, ~15 generations).
- Use Text-to-3D.
- Suggested prompts:
athena.glb— "Greek goddess Athena, owl helmet, robed, holding a scroll, stylized low-poly game character, T-pose, full body, neutral lighting"apollo.glb— "Greek god Apollo, laurel crown, holding a lyre, golden robe, stylized low-poly game character, T-pose, full body"iris.glb— "Greek goddess Iris with rainbow-colored wings, courier outfit, stylized low-poly game character, T-pose, full body"nike.glb— "Greek goddess Nike of victory, winged warrior, bronze armor, stylized low-poly game character, T-pose, full body"pan.glb— "Greek god Pan, satyr legs, panpipes, leather smith apron, stylized low-poly game character, T-pose, full body"chronos.glb— "Personification of time as a Greek archivist, hourglass robe, long beard, stylized low-poly game character, T-pose, full body"hermes.glb— "Greek god Hermes, winged sandals, winged helmet, caduceus, traveler robe, stylized low-poly game character, T-pose, full body"eros.glb— "Greek god Eros as an apothecary, bow on back, robe with vials, stylized low-poly game character, T-pose, full body"
- Refine to a "Stylized" or "Realistic" art style — pick whichever looks most consistent across the set. Recommend the same style for all 8.
- Download → "Download Model" → GLB format, 8K texture is fine.
- Drop into
public/avatars-3d/<id>.glb. Reload the page.
Sizing & alignment
The voxel body is about 1.6u tall, feet at y=0. If your GLB lands too tall
or floating, edit the <PlaygroundNpcGlb scale={...} yOffset={...}> call
inside playground-world-3d.tsx. Default scale=1, yOffset=0. Most
Meshy/Tripo GLBs come pre-scaled close to 1.6m.
Performance budget
- Keep each GLB under 2 MB compressed (gzip).
- Triangle budget ~10k per character is fine; more is wasteful.
- Avoid 4K textures — 1024 or 2048 max.
If a GLB is missing, the voxel body shows automatically — no errors, no broken state. Mix-and-match is fine (only have Athena's GLB? Just Athena gets the upgrade).