# cabaletta/baritone architecture

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

- Interactive diagram: https://gitdiagram.com/cabaletta/baritone
- Repository: https://github.com/cabaletta/baritone

## Overview

Baritone is a Minecraft pathfinding bot. A player issues commands or supplies a goal; command handling and registered processes select work, pathing control manages process ownership, and pathing behavior executes movement through game controls. The repository also exposes an API, handles Minecraft events, caches world data, supports schematic building and selections, and includes a specialized Elytra pathfinder. The graph uses the tree, README, and shown excerpts/index references; several subsystem links are dashed where implementation calls were not shown.

Main entry points: [`src/main/java/baritone/Baritone.java`](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/Baritone.java) (Baritone instance), [`src/main/java/baritone/behavior/PathingBehavior.java`](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/behavior/PathingBehavior.java) (Path execution behavior), [`src/main/java/baritone/event/GameEventHandler.java`](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/event/GameEventHandler.java) (Game event bus), [`src/main/java/baritone/command/manager/CommandManager.java`](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/manager/CommandManager.java) (Command manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and commands"]
  node_api["Public API<br/>[BaritoneAPI.java]"]
  node_commands["Command manager"]
  node_defaults["Default commands"]
  node_parser["Argument parsing"]
end

subgraph group_control["Pathing and control"]
  node_baritone["Baritone instance<br/>[Baritone.java]"]
  node_processes["Automation processes"]
  node_controlmgr["Pathing control"]
  node_pathbehavior["Path execution behavior"]
  node_search["A* path search"]
  node_movement["Movement planning"]
  node_elytra["Elytra navigation"]
end

subgraph group_world["World and building"]
  node_cache[("World cache<br/>[CachedWorld.java]")]
  node_worldprovider["World provider<br/>[WorldProvider.java]"]
  node_schematics["Schematic building"]
  node_selection["Selections"]
  node_renderer["Selection renderer"]
end

subgraph group_integration["Minecraft integration"]
  node_events["Game event bus"]
  node_mixins["Game hooks"]
  node_inputs["Input overrides"]
end

node_player(("Player"))
node_minecraft["Minecraft client"]

node_player -.->|"issues commands"| node_commands
node_api -->|"provides instance"| node_baritone
node_commands -->|"registers"| node_defaults
node_commands -.->|"parses arguments"| node_parser
node_commands -.->|"dispatches requests"| node_processes
node_mixins -->|"posts game events"| node_events
node_events -->|"updates world state"| node_worldprovider
node_events -->|"queues chunks"| node_cache
node_events -->|"refreshes block access"| node_baritone
node_processes -.->|"submit pathing commands"| node_controlmgr
node_controlmgr -->|"controls execution"| node_pathbehavior
node_controlmgr -->|"checks active path"| node_pathbehavior
node_pathbehavior -.->|"requests paths"| node_search
node_pathbehavior -.->|"executes movements"| node_movement
node_inputs -.->|"overrides controls"| node_minecraft
node_inputs -.->|"ticks on events"| node_events
node_baritone -.->|"owns processes"| node_processes
node_baritone -->|"exposes manager"| node_selection
node_selection -->|"creates renderer"| node_renderer
node_baritone -.->|"owns provider"| node_worldprovider
node_schematics -.->|"uses selected regions"| node_selection
node_processes -.->|"includes flight process"| node_elytra
node_pathbehavior -.->|"drives player controls"| node_inputs

click node_api "https://github.com/cabaletta/baritone/blob/1.21.4/src/api/java/baritone/api/BaritoneAPI.java"
click node_baritone "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/Baritone.java"
click node_commands "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/manager/CommandManager.java"
click node_defaults "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/defaults/DefaultCommands.java"
click node_parser "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/argparser/ArgParserManager.java"
click node_events "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/event/GameEventHandler.java"
click node_mixins "https://github.com/cabaletta/baritone/blob/1.21.4/src/launch/java/baritone/launch/mixins/MixinClientPlayNetHandler.java"
click node_processes "https://github.com/cabaletta/baritone/tree/1.21.4/src/main/java/baritone/process"
click node_controlmgr "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/utils/PathingControlManager.java"
click node_pathbehavior "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/behavior/PathingBehavior.java"
click node_search "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/pathing/calc/AStarPathFinder.java"
click node_movement "https://github.com/cabaletta/baritone/tree/1.21.4/src/main/java/baritone/pathing/movement"
click node_inputs "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/utils/InputOverrideHandler.java"
click node_cache "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/cache/CachedWorld.java"
click node_worldprovider "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/cache/WorldProvider.java"
click node_elytra "https://github.com/cabaletta/baritone/tree/1.21.4/src/main/java/baritone/process/elytra"
click node_schematics "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/utils/schematic/SchematicSystem.java"
click node_selection "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/selection/SelectionManager.java"
click node_renderer "https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/selection/SelectionRenderer.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_api,node_commands,node_defaults,node_parser,node_minecraft toneBlue
class node_baritone,node_processes,node_controlmgr,node_pathbehavior,node_search,node_movement,node_elytra toneAmber
class node_cache,node_worldprovider,node_schematics,node_selection,node_renderer toneMint
class node_events,node_mixins,node_inputs toneRose
class node_player toneIndigo
```

## Components

### API and commands

- [Public API](https://github.com/cabaletta/baritone/blob/1.21.4/src/api/java/baritone/api/BaritoneAPI.java): `src/api/java/baritone/api/BaritoneAPI.java`
- [Command manager](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/manager/CommandManager.java): `src/main/java/baritone/command/manager/CommandManager.java`
- [Default commands](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/defaults/DefaultCommands.java): `src/main/java/baritone/command/defaults/DefaultCommands.java`
- [Argument parsing](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/command/argparser/ArgParserManager.java): `src/main/java/baritone/command/argparser/ArgParserManager.java`

### Pathing and control

- [Baritone instance](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/Baritone.java): `src/main/java/baritone/Baritone.java`
- [Automation processes](https://github.com/cabaletta/baritone/tree/1.21.4/src/main/java/baritone/process): `src/main/java/baritone/process`
- [Pathing control](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/utils/PathingControlManager.java): `src/main/java/baritone/utils/PathingControlManager.java`
- [Path execution behavior](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/behavior/PathingBehavior.java): `src/main/java/baritone/behavior/PathingBehavior.java`
- [A* path search](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/pathing/calc/AStarPathFinder.java): `src/main/java/baritone/pathing/calc/AStarPathFinder.java`
- [Movement planning](https://github.com/cabaletta/baritone/tree/1.21.4/src/main/java/baritone/pathing/movement): `src/main/java/baritone/pathing/movement`
- [Elytra navigation](https://github.com/cabaletta/baritone/tree/1.21.4/src/main/java/baritone/process/elytra): `src/main/java/baritone/process/elytra`

### World and building

- [World cache](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/cache/CachedWorld.java): `src/main/java/baritone/cache/CachedWorld.java`
- [World provider](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/cache/WorldProvider.java): `src/main/java/baritone/cache/WorldProvider.java`
- [Schematic building](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/utils/schematic/SchematicSystem.java): `src/main/java/baritone/utils/schematic/SchematicSystem.java`
- [Selections](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/selection/SelectionManager.java): `src/main/java/baritone/selection/SelectionManager.java`
- [Selection renderer](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/selection/SelectionRenderer.java): `src/main/java/baritone/selection/SelectionRenderer.java`

### Minecraft integration

- [Game event bus](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/event/GameEventHandler.java): `src/main/java/baritone/event/GameEventHandler.java`
- [Game hooks](https://github.com/cabaletta/baritone/blob/1.21.4/src/launch/java/baritone/launch/mixins/MixinClientPlayNetHandler.java): `src/launch/java/baritone/launch/mixins/MixinClientPlayNetHandler.java`
- [Input overrides](https://github.com/cabaletta/baritone/blob/1.21.4/src/main/java/baritone/utils/InputOverrideHandler.java): `src/main/java/baritone/utils/InputOverrideHandler.java`

### Other components

- **Player**
- **Minecraft client**

## Connections

- Player → Command manager: issues commands
- Public API → Baritone instance: provides instance (evidence: `src/api/java/baritone/api/BaritoneAPI.java`)
- Command manager → Default commands: registers (evidence: `src/main/java/baritone/command/manager/CommandManager.java`)
- Command manager → Argument parsing: parses arguments
- Command manager → Automation processes: dispatches requests
- Game hooks → Game event bus: posts game events (evidence: `src/launch/java/baritone/launch/mixins/MixinClientPlayNetHandler.java`)
- Game event bus → World provider: updates world state (evidence: `src/main/java/baritone/event/GameEventHandler.java`)
- Game event bus → World cache: queues chunks (evidence: `src/main/java/baritone/event/GameEventHandler.java`)
- Game event bus → Baritone instance: refreshes block access (evidence: `src/main/java/baritone/event/GameEventHandler.java`)
- Automation processes → Pathing control: submit pathing commands
- Pathing control → Path execution behavior: controls execution (evidence: `src/main/java/baritone/utils/PathingControlManager.java`)
- Pathing control → Path execution behavior: checks active path (evidence: `src/main/java/baritone/utils/PathingControlManager.java`)
- Path execution behavior → A* path search: requests paths
- Path execution behavior → Movement planning: executes movements
- Input overrides → Minecraft client: overrides controls
- Input overrides → Game event bus: ticks on events
- Baritone instance → Automation processes: owns processes (evidence: `src/main/java/baritone/Baritone.java`)
- Baritone instance → Selections: exposes manager (evidence: `src/main/java/baritone/Baritone.java`)
- Selections → Selection renderer: creates renderer (evidence: `src/main/java/baritone/selection/SelectionManager.java`)
- Baritone instance → World provider: owns provider (evidence: `src/main/java/baritone/Baritone.java`)
- Schematic building → Selections: uses selected regions
- Automation processes → Elytra navigation: includes flight process
- Path execution behavior → Input overrides: drives player controls
