Three.js Object Sculptor

Three.js Object Sculptor Turn the object in an attached image into a quality-gated, animation-ready procedural Three.js model built entirely with code. Three.js Object Sculptor is a Codex plugin for rebuilding the visible object in a user-provided attachment image as a code-only Three.js model. It does not try to do photogrammetry, download an art pack, or extract a perfect mesh from one image. Instead, it guides Codex through a sculpting workflow: validate the image, describe the object precisely, decompose it into geometry and material systems, build from blockout to detail, wire an animation-friendly hierarchy, then compare the browser render against the original reference. Demo Tower Ship Open the live tower ship demo Ancient Autumn Tree Open the live ancient autumn tree demo At A Glance • Name: Three.js Object Sculptor • Category: Codex plugin for image-to-procedural 3D workflows • Input: an attached object image, reference screenshot, or local image path • Output: a code-only procedural Three.js object factory, backed by an objectsculptspec • Primary goal: recreate the target object's silhouette, component structure, materials, lighting response, and action-ready hierarchy in browser-friendly Three.js code • Best for: animation-ready real-time props, game objects, scene dressing, destructible objects, product-style objects, botanical objects, mechanical parts, and stylized reference reconstructions • Not for: photogrammetry, exact mesh extraction, scanned assets, downloaded art packs, or guaranteed production-perfect geometry from one image What It Does • Validates whether an image is suitable for procedural 3D reconstruction. • Creates a pre-spec complexity assessment before code generation. • Writes an objectsculptspec with component hierarchy, materials, lighting, pivots, sockets, animation anchors, destruction anchors, and quality targets. • Enforces a staged build pipeline: blockout, structural pass, form refinement, material pass, surface pass, lighting pass, interaction pass, and optimization. • Generates a code-only Three.js factory skeleton from the current unlocked sculpt pass. • Designs the generated object as an action-ready hierarchy, so later animation, transformation, physics, or destruction requests have real pivots and attachment points to use. • Packages reference/render screenshots into one comparison sheet for AI vision review. • Records self-correction reviews with overall, layer, and critical feature scores. • Supports reference-derived procedural PBR evidence: albedo, roughness estimate, height, normal, and AO maps. Use Cases • Convert an attached object image into a procedural Three.js model generated entirely with TypeScript and geometry code. • Build animation-ready Three.js props with meaningful pivots, sockets, parent-child hierarchy, and transform anchors. • Recreate reference objects as browser-friendly procedural assets without relying on downloaded meshes or external art packs. • Generate a structured object spec before implementation, so Codex understands geometry, materials, lighting, local surface features, and interaction readiness. • Create destructible or transformable objects by planning detachable parts, fracture seams, colliders, and effect emitters before the model is coded. • Compare the rendered model against the original attachment with AI vision and block progress when critical features do not match. • Produce reusable procedural object factories for Three.js games, WebGPU demos, interactive prototypes, and visual experiments. Why This Exists Procedural 3D generation can fail in a very specific way: the silhouette is "kind of right", but the object loses the details that make it recognizable. This plugin is designed to slow Codex down at the right moments: • First understand what object class and complexity tier it is dealing with. • Define what "good enough" means for this specific object. • Build from coarse structure to fine surface response. • Fail a pass if an identity-defining feature is wrong, even when the overall score looks acceptable. The result is less "one-shot generated mesh" and more "Codex as a procedural sculptor with checkpoints": block out the form, attach the moving parts, layer the materials, then keep refining until the model reads like the object in the attachment.