ThreeJSON

中文 | English

JSON-driven Three.js scene runtime: build 3D scenes from configuration instead of hand-writing large chunks of Three.js boilerplate.

Official website：https://threejson.org/

Repository: github.com/nnrj/threejson · Issues: GitHub Issues

npm：threejson - npm 、@threejson/assets - npm

Demos: ThreeJSON Examples SceneEditor: ThreeJSON SceneEditor

Exact description:

ThreeJSON is a JSON-driven declarative scene runtime for Three.js, designed for persistent, mutable and extensible 3D worlds — from human-authored scenes to AI and Agent-driven generation and control.

Use in your project

npm install threejson

In addition, certain built-in models rely on the assets package (which contains textures, sample scene JSONs, etc.). By default, no manual setup is required as ThreeJSON will automatically fetch them via CDN.

If you prefer to host or use them locally, you can install the assets package separately:

npm install @threejson/assets

Development environment

To run tests, examples, and external tools (agent bridges, MCP) in this repo, use Node.js 24+.

git clone https://github.com/nnrj/threejson.git
cd threejson
nvm use          # reads .nvmrc
npm ci && npm test

See docs/zh/development.md (Chinese; English: docs/en/development.md).

Use in your project

npm install threejson

In addition, certain built-in models rely on the assets package (which contains textures, sample scene JSONs, etc.). By default, no manual setup is required as ThreeJSON will automatically fetch them via CDN.

If you prefer to host or use them locally, you can install the assets package separately:

npm install @threejson/assets

The philosophy of ThreeJSON, distilled into four lines:

Scene as Data — The scene is data. Runtime as Engine — The runtime is the engine.