Official Codebase of 3DCodeVerse
3dcodeverse
A plugin for Claude Code, Codex and Antigravity (agy) that makes the host coding agent
good at real 3D: it writes raw, executable 3D code — Blender bpy, CadQuery, Three.js,
URDF, GLSL, moderngl — and the plugin builds, measures, renders and gates what it wrote, then
has a fresh-context judge score it.
- Tracks:
static_object·articulated_object·scene·graphics - Languages:
blender·cadquery·threejs·urdf_blender·scene_threejs·scene_blender·glsl_shader·opengl_python - Skills (
skills/):3dcodeverse(the controller: what 3D coding here is, the tracks and languages, every instrument, the workflow init → plan → code → check → judge → refine with its stop rules, and the quality rules every track shares),3d-lang-<language>× 8 (each language's files, frame, sandbox and every threshold the instruments measure) and thec3d-*craft bundles (parts that touch, bbox contract, repeats, scene lighting / placement / materials / motion, shader traps …). - Instruments (
3dcode, a command-line tool):init,validate-plan,build,check(every gate of the track),judge(commit + tag +judge-pack+ the judge's instruction),score, and the per-track probes —measure,check-contract,check-connectivity,cross-section,render-views,render-sheet,isolate,compare-reference,joint-sweep,scene-probe,check-placement,scene-views,shader-probe,gl-probe,gl-frames. Each prints a verdict, numbers, fix hints and the paths of the PNGs it wrote. - Judge (
agents/3d-judge.md): a subagent started with the one instruction3dcode judgeprints; it reads onlyjudge/rNN/brief.md+ the images and writesjudgment.json;3dcode scoredoes the arithmetic from the rubric's weights, penalties, floors and gate caps.
Everything model-side — writing code, looking at renders, judging — is the host agent's own model and billing. There is no pipeline, no vendor backend, no API key and no cost ledger in this package.
Install
git clone <this repo> 3dcodeverse && cd 3dcodeverse
bash harness/setup.sh # python package (console script `3dcode`) + runtime_js + headless Chrome + doctor
python -m codeverse3d.doctor # deps, Blender, node, GPU
claude plugin marketplace add . # Claude Code: the repo is a marketplace
claude plugin install 3dcodeverse@3dcodeverse
codex plugin marketplace add . # Codex
codex plugin add 3dcodeverse@3dcodeverse
agy plugin install harness # Antigravity
Prerequisites and troubleshooting: docs/INSTALL.md. Python 3.13, node ≥ 20.6; Blender
5.2 LTS for the blender languages; CadQuery and moderngl as extras.
Use
Ask the host agent for a 3D thing and name the language if you care:
Make a mid-century wooden dining chair in Blender bpy. Make a kitchen cabinet with one door and a drawer as a URDF mechanism. Make a small Japanese garden at dusk with a koi pond as a three.js scene. Make neon rain on a window as a GLSL shader.
The 3dcodeverse skill drives the rest: a workspace directory with spec.json, plan.json,
src/ (the code), artifacts/ (object.glb, renders, gates) and judge/rNN/ (brief, montages,
judgment, score). The deliverable is the best-scoring round's src/ and its artifacts.
Docs: docs/INSTALL.md (install / prerequisites / doctor) · docs/ARCHITECTURE.md (design,
the workspace, every instrument and gate, judging) · CLAUDE.md (working rules for changing
the plugin).