# sakura-ryoko/litematica architecture

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

- Interactive diagram: https://gitdiagram.com/sakura-ryoko/litematica
- Repository: https://github.com/sakura-ryoko/litematica

## Overview

Litematica is a client-side Minecraft schematic mod. Its central workflow is to define an area, capture or load schematic data, position and render the schematic in a virtual world, then inspect or act on the planned build. The tree also shows material lists, verification, projects, task-based operations, and easy-place support. Connections are conservative: indexed references support several links, while links to unsampled subsystems are dashed and marked unverified.

Main entry points: [`src/main/java/fi/dy/masa/litematica/data/DataManager.java`](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/data/DataManager.java) (Persistent data), [`src/main/java/fi/dy/masa/litematica/schematic/LitematicaSchematic.java`](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/LitematicaSchematic.java) (Schematic data), [`src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java`](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java) (Entity data sync), [`src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacementManager.java`](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacementManager.java) (Placement manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Player interaction"]
  node_selection["Area selection"]
  node_selectiongui["Selection UI"]
end

subgraph group_schematics["Schematic lifecycle"]
  node_schematic["Schematic data"]
  node_schematicui["Schematic UI"]
  node_buffer["Schematic buffers"]
  node_projects["Schematic projects"]
end

subgraph group_world["Placement and rendering"]
  node_placement["Placement model"]
  node_placementmanager["Placement manager"]
  node_virtualworld["Schematic world"]
  node_chunks["Chunk management"]
  node_renderer["Schematic renderer"]
end

subgraph group_operations["Build operations"]
  node_materials["Material lists"]
  node_verifier["Schematic verifier"]
  node_tasks["Scheduled tasks<br/>[TaskScheduler.java]"]
  node_easyplace["Easy place"]
end

subgraph group_state["State and configuration"]
  node_data[("Persistent data<br/>[DataManager.java]")]
  node_entitydata["Entity data sync"]
  node_config["Configuration<br/>[Configs.java]"]
  node_hotkeys["Hotkeys<br/>[Hotkeys.java]"]
end

node_player(("Player"))

node_player -.->|"edits areas"| node_selectiongui
node_selectiongui -->|"manages"| node_selection
node_selection -->|"persists selection"| node_data
node_player -.->|"chooses schematic"| node_schematicui
node_schematicui -.->|"loads or saves"| node_schematic
node_buffer -->|"buffers data"| node_schematic
node_projects -.->|"organizes projects"| node_schematic
node_data -->|"loads and saves"| node_selection
node_data -->|"loads and saves"| node_placementmanager
node_data -->|"loads and saves"| node_projects
node_placementmanager -.->|"manages placements"| node_placement
node_placement -.->|"positions schematic"| node_schematic
node_virtualworld -->|"manages chunks"| node_chunks
node_placementmanager -->|"schedules rebuilds"| node_renderer
node_schematic -.->|"renders preview"| node_renderer
node_player -.->|"inspects materials"| node_materials
node_player -.->|"checks build"| node_verifier
node_tasks -.->|"runs operations"| node_player
node_player -.->|"places blocks"| node_easyplace
node_easyplace -->|"checks options"| node_config
node_entitydata -->|"uses shared state"| node_data
node_entitydata -->|"synchronizes entities"| node_virtualworld
node_entitydata -->|"checks options"| node_config
node_player -.->|"configures keys"| node_hotkeys

click node_selection "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/selection/SelectionManager.java"
click node_selectiongui "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/gui/GuiAreaSelectionManager.java"
click node_schematic "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/LitematicaSchematic.java"
click node_schematicui "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/gui/GuiSchematicLoad.java"
click node_buffer "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/transmit/SchematicBufferManager.java"
click node_projects "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/projects/SchematicProjectsManager.java"
click node_placement "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java"
click node_placementmanager "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacementManager.java"
click node_virtualworld "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/world/WorldSchematic.java"
click node_chunks "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/world/ChunkManagerSchematic.java"
click node_renderer "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/render/LitematicaRenderer.java"
click node_materials "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/materials/MaterialListBase.java"
click node_verifier "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/verifier/SchematicVerifier.java"
click node_tasks "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/scheduler/TaskScheduler.java"
click node_easyplace "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/util/PlacementHandler.java"
click node_data "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/data/DataManager.java"
click node_entitydata "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java"
click node_config "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/config/Configs.java"
click node_hotkeys "https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/config/Hotkeys.java"

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_selection,node_selectiongui toneBlue
class node_schematic,node_schematicui,node_buffer,node_projects toneAmber
class node_placement,node_placementmanager,node_virtualworld,node_chunks,node_renderer toneMint
class node_materials,node_verifier,node_tasks,node_easyplace toneRose
class node_data,node_entitydata,node_config,node_hotkeys,node_player toneIndigo
```

## Components

### Player interaction

- [Area selection](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/selection/SelectionManager.java): `src/main/java/fi/dy/masa/litematica/selection/SelectionManager.java`
- [Selection UI](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/gui/GuiAreaSelectionManager.java): `src/main/java/fi/dy/masa/litematica/gui/GuiAreaSelectionManager.java`

### Schematic lifecycle

- [Schematic data](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/LitematicaSchematic.java): `src/main/java/fi/dy/masa/litematica/schematic/LitematicaSchematic.java`
- [Schematic UI](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/gui/GuiSchematicLoad.java): `src/main/java/fi/dy/masa/litematica/gui/GuiSchematicLoad.java`
- [Schematic buffers](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/transmit/SchematicBufferManager.java): `src/main/java/fi/dy/masa/litematica/schematic/transmit/SchematicBufferManager.java`
- [Schematic projects](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/projects/SchematicProjectsManager.java): `src/main/java/fi/dy/masa/litematica/schematic/projects/SchematicProjectsManager.java`

### Placement and rendering

- [Placement model](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java): `src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java`
- [Placement manager](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacementManager.java): `src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacementManager.java`
- [Schematic world](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/world/WorldSchematic.java): `src/main/java/fi/dy/masa/litematica/world/WorldSchematic.java`
- [Chunk management](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/world/ChunkManagerSchematic.java): `src/main/java/fi/dy/masa/litematica/world/ChunkManagerSchematic.java`
- [Schematic renderer](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/render/LitematicaRenderer.java): `src/main/java/fi/dy/masa/litematica/render/LitematicaRenderer.java`

### Build operations

- [Material lists](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/materials/MaterialListBase.java): `src/main/java/fi/dy/masa/litematica/materials/MaterialListBase.java`
- [Schematic verifier](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/schematic/verifier/SchematicVerifier.java): `src/main/java/fi/dy/masa/litematica/schematic/verifier/SchematicVerifier.java`
- [Scheduled tasks](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/scheduler/TaskScheduler.java): `src/main/java/fi/dy/masa/litematica/scheduler/TaskScheduler.java`
- [Easy place](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/util/PlacementHandler.java): `src/main/java/fi/dy/masa/litematica/util/PlacementHandler.java`

### State and configuration

- [Persistent data](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/data/DataManager.java): `src/main/java/fi/dy/masa/litematica/data/DataManager.java`
- [Entity data sync](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java): `src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java`
- [Configuration](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/config/Configs.java): `src/main/java/fi/dy/masa/litematica/config/Configs.java`
- [Hotkeys](https://github.com/sakura-ryoko/litematica/blob/26.3/src/main/java/fi/dy/masa/litematica/config/Hotkeys.java): `src/main/java/fi/dy/masa/litematica/config/Hotkeys.java`

### Other components

- **Player**

## Connections

- Player → Selection UI: edits areas
- Selection UI → Area selection: manages (evidence: `src/main/java/fi/dy/masa/litematica/gui/GuiAreaSelectionManager.java`)
- Area selection → Persistent data: persists selection (evidence: `src/main/java/fi/dy/masa/litematica/data/DataManager.java`)
- Player → Schematic UI: chooses schematic
- Schematic UI → Schematic data: loads or saves
- Schematic buffers → Schematic data: buffers data (evidence: `src/main/java/fi/dy/masa/litematica/schematic/transmit/SchematicBufferManager.java`)
- Schematic projects → Schematic data: organizes projects
- Persistent data → Area selection: loads and saves (evidence: `src/main/java/fi/dy/masa/litematica/data/DataManager.java`)
- Persistent data → Placement manager: loads and saves (evidence: `src/main/java/fi/dy/masa/litematica/data/DataManager.java`)
- Persistent data → Schematic projects: loads and saves (evidence: `src/main/java/fi/dy/masa/litematica/data/DataManager.java`)
- Placement manager → Placement model: manages placements (evidence: `src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java`)
- Placement model → Schematic data: positions schematic (evidence: `src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java`)
- Schematic world → Chunk management: manages chunks (evidence: `src/main/java/fi/dy/masa/litematica/world/ChunkManagerSchematic.java`)
- Placement manager → Schematic renderer: schedules rebuilds
- Schematic data → Schematic renderer: renders preview
- Player → Material lists: inspects materials
- Player → Schematic verifier: checks build
- Scheduled tasks → Player: runs operations
- Player → Easy place: places blocks
- Easy place → Configuration: checks options (evidence: `src/main/java/fi/dy/masa/litematica/util/PlacementHandler.java`)
- Entity data sync → Persistent data: uses shared state (evidence: `src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java`)
- Entity data sync → Schematic world: synchronizes entities (evidence: `src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java`)
- Entity data sync → Configuration: checks options (evidence: `src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java`)
- Player → Hotkeys: configures keys
