</>MCP Agents Market
Plugin

img2threejs

by img2threejs12.6kPythonUpdated 2026-08-22

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

Claude CodeCodexOpenCode

img2threejs is a Claude Code plugin that converts a single reference image into a fully procedural, animation-ready Three.js model written entirely in TypeScript code. Unlike photogrammetry or mesh extraction tools, it rebuilds objects from geometric primitives and procedural shaders through a staged pipeline with automated quality gates. The plugin is designed to be token-efficient by using deterministic Python scripts for validation and gating, reserving AI model tokens only for visual judgment and code generation. It supports hard-surface objects, characters, and specialized CS2 weapon reconstruction with detail inventories and strict quality controls.

Key Features

Procedural code-only 3D reconstruction from a single reference image using Three.js primitives and shaders
Staged sculpting pipeline with eight gated passes: blockout, structural, form, material, surface, lighting, interaction, and optimization
Detail-first analysis with strict quality gates that enumerate identity-defining features before code generation
Token-efficient design using pure Python 3.10+ stdlib scripts for validation, leaving AI tokens for visual judgment only
Animation-ready output with runtime hierarchy including pivots, sockets, colliders, and userData.tick for idle animations
Specialized CS2 weapon reconstruction with family-specific contracts, projection-first finishes, and structural review gates
Material reference pipeline with per-region analysis, PBR extraction, and deterministic comparison gates
Multi-subject support including hard-surface objects, humanoid characters with anatomy-aware reconstruction, and dioramas

Use Cases

  • 01Generate animation-ready 3D game assets from concept art or reference photos
  • 02Reconstruct CS2 weapons with exact family identity and painted-region coverage for game modding
  • 03Create procedural Three.js models for web-based 3D showcases without external mesh files
  • 04Build code-based 3D prototypes from product photos for interactive web experiences
  • 05Generate diffable, version-controllable TypeScript 3D models instead of binary mesh files
  • 06Produce token-efficient 3D reconstructions for AI-assisted game development workflows

Related Plugins

View more

img2threejs — FAQ

What is img2threejs?+

img2threejs is a Claude Code plugin that transforms a single reference image into a procedural Three.js 3D model written entirely in TypeScript code, with no mesh files or external assets. It uses a staged pipeline with quality gates to ensure the output matches the reference image's proportions, materials, and details.

How do I install img2threejs for Claude Code?+

Clone the repository into your Claude skills directory using git clone, or create a symlink if you use multiple AI coding assistants. Then invoke it in Claude Code by attaching an image and running the /img2threejs command with your reconstruction instructions.

Which AI coding assistants support img2threejs?+

img2threejs works with Claude Code, Codex, and OpenCode as a skill/plugin. It is agent-agnostic and uses whatever vision and browser tools the host provides.

Do I need API keys or external dependencies to use img2threejs?+

No API keys are required. The core pipeline uses only Python 3.10+ standard library with zero external dependencies. Optional reference-fidelity tooling (SAM2, Depth Anything V2, MediaPipe) can be added separately but is not required.

Is img2threejs free to use?+

Yes, img2threejs is free and open source under the Apache License 2.0. You can use, modify, and distribute it freely.

What are the limitations of single-image 3D reconstruction?+

A single image cannot reveal hidden sides or guarantee exact geometry for unseen faces. The plugin states plainly when output is approximate or stylized, and it infers hidden features by mirroring visible ones rather than inventing detail. Multi-view reconstruction is planned for future versions.

How do I install img2threejs?+

Open the source repository on GitHub and follow its README. img2threejs is a plugin — MCP Agents Market links you directly to the official repo.

Is img2threejs free?+

img2threejs is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches