# jannisx11/blockbench architecture

> Architecture diagram of the GitHub repository jannisx11/blockbench, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jannisx11/blockbench
- Repository: https://github.com/jannisx11/blockbench

## Overview

Blockbench is a desktop and web low-poly model editor for creating, texturing, animating, previewing, and exporting 3D assets. The principal workflow is to edit a model in the outliner and modeling tools, inspect it in the viewport, then save or export it through project and format support. The README also documents dedicated Minecraft formats and plugins. The graph reflects documented capabilities and visible imports; several subsystem internals were not sampled, so their specific runtime connections are omitted.

Main entry points: [`js/interface/interface.js`](https://github.com/jannisx11/blockbench/blob/master/js/interface/interface.js) (Editor interface), [`js/io/project.ts`](https://github.com/jannisx11/blockbench/blob/master/js/io/project.ts) (Project management), [`js/preview/preview.ts`](https://github.com/jannisx11/blockbench/blob/master/js/preview/preview.ts) (3D preview), [`js/file_system.ts`](https://github.com/jannisx11/blockbench/blob/master/js/file_system.ts) (File system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Model authoring"]
  node_outliner["Model hierarchy<br/>[outliner.js]"]
  node_model_edit["Model editing<br/>[mesh_editing.js]"]
  node_transform["Transforms and gizmos<br/>[transform.js]"]
  node_uv["UV editing<br/>[uv.js]"]
  node_texturing["Texture painting<br/>[painter.js]"]
end

subgraph group_visuals["Preview and animation"]
  node_preview["3D preview<br/>[preview.ts]"]
  node_display["Display modes<br/>[display_mode.js]"]
  node_animation["Animation tools<br/>[timeline.js]"]
end

subgraph group_exchange["Projects and formats"]
  node_project["Project management<br/>[project.ts]"]
  node_filesystem["File system<br/>[file_system.ts]"]
  node_io["Model import/export<br/>[model_loader.ts]"]
  node_standard_formats["Standard formats<br/>[gltf.js]"]
  node_minecraft_formats["Minecraft formats<br/>[bedrock.js]"]
end

subgraph group_platform["Application platform"]
  node_interface["Editor interface<br/>[interface.js]"]
  node_api["Blockbench API<br/>[api.ts]"]
  node_plugins["Plugin system<br/>[plugin_loader.ts]"]
  node_state[("Saved preferences<br/>[state_memory.ts]")]
end

node_artist(("Artist"))

node_artist -->|"uses"| node_interface
node_interface -->|"uses"| node_api
node_interface -->|"loads"| node_outliner
node_interface -->|"loads"| node_model_edit
node_interface -->|"loads"| node_transform
node_interface -->|"loads"| node_uv
node_interface -->|"loads"| node_texturing
node_interface -->|"loads"| node_preview
node_interface -->|"loads"| node_animation
node_interface -->|"loads"| node_display
node_interface -->|"loads"| node_project
node_interface -->|"loads"| node_io
node_interface -->|"loads"| node_plugins
node_project -->|"uses"| node_filesystem
node_filesystem -->|"uses"| node_state
node_project -->|"uses"| node_standard_formats
node_interface -->|"loads"| node_standard_formats
node_interface -->|"loads"| node_minecraft_formats
node_preview -->|"uses"| node_outliner
node_plugins -.->|"extends"| node_api

click node_interface "https://github.com/jannisx11/blockbench/blob/master/js/interface/interface.js"
click node_api "https://github.com/jannisx11/blockbench/blob/master/js/api.ts"
click node_plugins "https://github.com/jannisx11/blockbench/blob/master/js/plugin_loader.ts"
click node_outliner "https://github.com/jannisx11/blockbench/blob/master/js/outliner/outliner.js"
click node_model_edit "https://github.com/jannisx11/blockbench/blob/master/js/modeling/mesh_editing.js"
click node_transform "https://github.com/jannisx11/blockbench/blob/master/js/modeling/transform.js"
click node_uv "https://github.com/jannisx11/blockbench/blob/master/js/uv/uv.js"
click node_texturing "https://github.com/jannisx11/blockbench/blob/master/js/texturing/painter.js"
click node_preview "https://github.com/jannisx11/blockbench/blob/master/js/preview/preview.ts"
click node_display "https://github.com/jannisx11/blockbench/blob/master/js/display_mode/display_mode.js"
click node_animation "https://github.com/jannisx11/blockbench/blob/master/js/animations/timeline.js"
click node_project "https://github.com/jannisx11/blockbench/blob/master/js/io/project.ts"
click node_filesystem "https://github.com/jannisx11/blockbench/blob/master/js/file_system.ts"
click node_io "https://github.com/jannisx11/blockbench/blob/master/js/io/model_loader.ts"
click node_standard_formats "https://github.com/jannisx11/blockbench/blob/master/js/formats/standards/gltf.js"
click node_minecraft_formats "https://github.com/jannisx11/blockbench/blob/master/js/formats/bedrock/bedrock.js"
click node_state "https://github.com/jannisx11/blockbench/blob/master/js/util/state_memory.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_outliner,node_model_edit,node_transform,node_uv,node_texturing toneBlue
class node_preview,node_display,node_animation toneAmber
class node_project,node_filesystem,node_io,node_standard_formats,node_minecraft_formats toneMint
class node_interface,node_api,node_plugins,node_state toneRose
class node_artist toneIndigo
```

## Components

### Model authoring

- [Model hierarchy](https://github.com/jannisx11/blockbench/blob/master/js/outliner/outliner.js): `js/outliner/outliner.js`
- [Model editing](https://github.com/jannisx11/blockbench/blob/master/js/modeling/mesh_editing.js): `js/modeling/mesh_editing.js`
- [Transforms and gizmos](https://github.com/jannisx11/blockbench/blob/master/js/modeling/transform.js): `js/modeling/transform.js`
- [UV editing](https://github.com/jannisx11/blockbench/blob/master/js/uv/uv.js): `js/uv/uv.js`
- [Texture painting](https://github.com/jannisx11/blockbench/blob/master/js/texturing/painter.js): `js/texturing/painter.js`

### Preview and animation

- [3D preview](https://github.com/jannisx11/blockbench/blob/master/js/preview/preview.ts): `js/preview/preview.ts`
- [Display modes](https://github.com/jannisx11/blockbench/blob/master/js/display_mode/display_mode.js): `js/display_mode/display_mode.js`
- [Animation tools](https://github.com/jannisx11/blockbench/blob/master/js/animations/timeline.js): `js/animations/timeline.js`

### Projects and formats

- [Project management](https://github.com/jannisx11/blockbench/blob/master/js/io/project.ts): `js/io/project.ts`
- [File system](https://github.com/jannisx11/blockbench/blob/master/js/file_system.ts): `js/file_system.ts`
- [Model import/export](https://github.com/jannisx11/blockbench/blob/master/js/io/model_loader.ts): `js/io/model_loader.ts`
- [Standard formats](https://github.com/jannisx11/blockbench/blob/master/js/formats/standards/gltf.js): `js/formats/standards/gltf.js`
- [Minecraft formats](https://github.com/jannisx11/blockbench/blob/master/js/formats/bedrock/bedrock.js): `js/formats/bedrock/bedrock.js`

### Application platform

- [Editor interface](https://github.com/jannisx11/blockbench/blob/master/js/interface/interface.js): `js/interface/interface.js`
- [Blockbench API](https://github.com/jannisx11/blockbench/blob/master/js/api.ts): `js/api.ts`
- [Plugin system](https://github.com/jannisx11/blockbench/blob/master/js/plugin_loader.ts): `js/plugin_loader.ts`
- [Saved preferences](https://github.com/jannisx11/blockbench/blob/master/js/util/state_memory.ts): `js/util/state_memory.ts`

### Other components

- **Artist**

## Connections

- Artist → Editor interface: uses
- Editor interface → Blockbench API: uses (evidence: `js/interface/interface.js`)
- Editor interface → Model hierarchy: loads
- Editor interface → Model editing: loads
- Editor interface → Transforms and gizmos: loads
- Editor interface → UV editing: loads
- Editor interface → Texture painting: loads
- Editor interface → 3D preview: loads (evidence: `js/preview/preview.ts`)
- Editor interface → Animation tools: loads
- Editor interface → Display modes: loads
- Editor interface → Project management: loads (evidence: `js/io/project.ts`)
- Editor interface → Model import/export: loads
- Editor interface → Plugin system: loads
- Project management → File system: uses (evidence: `js/io/project.ts`)
- File system → Saved preferences: uses (evidence: `js/file_system.ts`)
- Project management → Standard formats: uses (evidence: `js/io/project.ts`)
- Editor interface → Standard formats: loads
- Editor interface → Minecraft formats: loads
- 3D preview → Model hierarchy: uses (evidence: `js/preview/preview.ts`)
- Plugin system → Blockbench API: extends
