Code export

A regular Three.js Group

The factory returns a Three.Group made from primitives, generated geometry and standard PBR materials. It does not download a GLB, OBJ or third-party art pack at runtime.

Runtime contract

root.userData.sculptRuntime exposes stable names for nodes, sockets and colliders. Your animation and interaction code can use the contract without depending on child-array positions.

const runtime = model.userData.sculptRuntime;
runtime.nodes.lid.rotation.x = Math.PI * -0.35;
weapon.attach(runtime.sockets.handR);

React Three Fiber

Create the model once with useMemo and mount it with a primitive. Dispose cloned materials if you replace them at runtime.

const model = useMemo(() => createObjectModel(), []);
return <primitive object={model} />;