How sakura-ryoko/litematica works
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: DataManager.java Persistent data · LitematicaSchematic.java Schematic data · EntityDataManager.java Entity data sync · SchematicPlacementManager.java Placement manager
Components 20
Player interaction
- Area selection
src/main/java/fi/dy/masa/litematica/selection/SelectionManager.java - Selection UI
src/main/java/fi/dy/masa/litematica/gui/GuiAreaSelectionManager.java
Schematic lifecycle
- Schematic data
src/main/java/fi/dy/masa/litematica/schematic/LitematicaSchematic.java - Schematic UI
src/main/java/fi/dy/masa/litematica/gui/GuiSchematicLoad.java - Schematic buffers
src/main/java/fi/dy/masa/litematica/schematic/transmit/SchematicBufferManager.java - Schematic projects
src/main/java/fi/dy/masa/litematica/schematic/projects/SchematicProjectsManager.java
Placement and rendering
- Placement model
src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java - Placement manager
src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacementManager.java - Schematic world
src/main/java/fi/dy/masa/litematica/world/WorldSchematic.java - Chunk management
src/main/java/fi/dy/masa/litematica/world/ChunkManagerSchematic.java - Schematic renderer
src/main/java/fi/dy/masa/litematica/render/LitematicaRenderer.java
Build operations
- Material lists
src/main/java/fi/dy/masa/litematica/materials/MaterialListBase.java - Schematic verifier
src/main/java/fi/dy/masa/litematica/schematic/verifier/SchematicVerifier.java - Scheduled tasks
src/main/java/fi/dy/masa/litematica/scheduler/TaskScheduler.java - Easy place
src/main/java/fi/dy/masa/litematica/util/PlacementHandler.java
State and configuration
- Persistent data
src/main/java/fi/dy/masa/litematica/data/DataManager.java - Entity data sync
src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java - Configuration
src/main/java/fi/dy/masa/litematica/config/Configs.java - Hotkeys
src/main/java/fi/dy/masa/litematica/config/Hotkeys.java
Other components
- Player
Connections 24
- Player → Selection UI: edits areas
- Selection UI → Area selection: manages
src/main/java/fi/dy/masa/litematica/gui/GuiAreaSelectionManager.java - Area selection → Persistent data: persists selection
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
src/main/java/fi/dy/masa/litematica/schematic/transmit/SchematicBufferManager.java - Schematic projects → Schematic data: organizes projects
- Persistent data → Area selection: loads and saves
src/main/java/fi/dy/masa/litematica/data/DataManager.java - Persistent data → Placement manager: loads and saves
src/main/java/fi/dy/masa/litematica/data/DataManager.java - Persistent data → Schematic projects: loads and saves
src/main/java/fi/dy/masa/litematica/data/DataManager.java - Placement manager → Placement model: manages placements
src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java - Placement model → Schematic data: positions schematic
src/main/java/fi/dy/masa/litematica/schematic/placement/SchematicPlacement.java - Schematic world → Chunk management: manages chunks
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
src/main/java/fi/dy/masa/litematica/util/PlacementHandler.java - Entity data sync → Persistent data: uses shared state
src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java - Entity data sync → Schematic world: synchronizes entities
src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java - Entity data sync → Configuration: checks options
src/main/java/fi/dy/masa/litematica/data/EntityDataManager.java - Player → Hotkeys: configures keys