Forge Universe documentation
Forge Universe is a physics-oriented world model (JSON v1) with in-browser renderers for Platonic solids and a sphere. One scene file can drive SVG projections, a static HTML gallery, WebGL flythroughs, and per-solid detail flyouts.
Start here
| Guide | What you learn |
|---|---|
| Overview | Capabilities, architecture, and hash registry |
| World model v1 | Scene JSON schema — nodes, camera, sim |
| Simulation | Rigid-body loop, sim schema, UniverseSim API |
| Construction assets | GLB import, articulation, Uca demo |
| Omniverse import | USD → GLB → scene node workflow |
| Universe vs Omniverse | Comparison matrix, when to use each, non-goals |
| JavaScript API | UniverseWorld and renderer modules |
| Renderers | 2D SVG, static gallery, flyout, WebGL paths |
| Scene fixtures | Bundled assets/scenes/*.json files |
| Verification | Unit tests, oracles, PDCA gates |
Live demos
| Demo | Hash | Page |
|---|---|---|
| 2D projections | Up2 |
/demos/projections-2d.html |
| Static 3D gallery | Us3 |
/demos/static-solids.html |
| Solid detail flyout | Ufl |
Click any tile on static 3D |
| Drone flythrough | Udr |
/demos/drone-flythrough.html |
| Sim bounce | Usb |
/demos/sim-bounce.html |
| Construction assets | Uca |
/demos/construction-assets.html |
| Construction realistic | Ucr |
/demos/construction-realistic.html |
Primitives
Six solid types share the same node interface (type, pose, size or radius):
- Tetrahedron (
Ute) - Hexahedron / cube (
Uhx) - Octahedron (
Uoc) - Dodecahedron (
Udo) - Icosahedron (
Uic) - Sphere (
Ups)
Maintainer dual-wiki
Human specs live in the repo under docs/design/universe/. Machine oracles in docs/design/universe/oracles/ drive Playwright verification. Design contracts with KS-style hashes are in docs/design/catalog/.