# Baritone: the Minecraft pathfinding bot that walks where you click

> Baritone is a Java pathfinding mod for Minecraft that turns a chat command into a walking route. It is built for players who want automated travel and mining, not for anyone expecting a hands-off bot.

**cabaletta/baritone** — google maps for block game

- Repository: https://github.com/cabaletta/baritone
- Stars: 9,247 · Forks: 2,062
- Language: Java
- License: LGPL-3.0
- Published: 2026-09-21 · Updated: 2026-09-21 · Language: en
- Canonical page: https://hysenlabs.com/projects/cabaletta-baritone

## What Baritone actually does for a Minecraft player

The README calls Baritone "a Minecraft pathfinder bot" and the repository description calls it "google maps for block game". Both land on the same idea: you name a destination, and the mod computes a route and walks it. The pathfinding is the product. The README states that Baritone has been the pathfinding system used in Impact since version 4.4, which tells you the code has been embedded in third-party clients rather than only shipped standalone.

The intended user is a Minecraft player on a supported game version who wants to travel, mine or build without steering manually. The topics list on the repository includes astar, astar-pathfinding, pathfinding, minecraft, forgegradle and gradle, so the algorithmic core is A* search over the world, not a recorded macro that replays keystrokes. That distinction matters: a recorded route breaks when terrain changes, while a search recomputes.

It is not a general automation framework. The README does not describe a scripting API for arbitrary tasks, and it does not document a scheduler or a task queue. If your goal is a bot that plays the whole game, Baritone gives you movement and the commands built on top of it, and nothing more.

## How the pathfinder is wired into the game

The repository layout is the clearest evidence of the architecture. There are separate top-level directories named forge, fabric and neoforge, plus a shared src directory, a buildSrc directory and a tweaker directory. The default branch is named 1.21.4. This is a multi-loader mod: the same pathfinding code is compiled against different mod loaders through loader-specific entry points, which is why one project produces jars for Forge, Fabric and NeoForge.

The README's download table is split into Forge, Fabric and NeoForge columns, and the version badges run from Minecraft 1.12.2 up through 1.21.3. A single build therefore does not fit every game version. The Dockerfile installs openjdk-21-jdk and git, copies the repository to /code, and runs ./gradlew build, so Java 21 is the toolchain the project expects.

The search itself is A* over the block world, per the repository topics. The README does not document the cost function, the node representation or how chunk loading interacts with the search, so anyone who needs those details has to read src. Treat the README as a usage document, not an architecture document.

## Installing Baritone and running a first goto

The README's quick download table links release jars per loader and per Minecraft version, for example baritone-api-forge-1.2.19.jar for 1.12.2 Forge. Pick the jar that matches both your loader and your game version, drop it in your mods folder, and start the game. The README does not describe a launcher-specific install path beyond that table, and SETUP.md exists in the repository for the longer version.

Once in game, Baritone is driven from chat. Commands are prefixed with a hash. The README does not list the command set inline; USAGE.md is the file that covers it, and the release notes for v1.12.0, v1.11.3 and v1.10.8 are the place to check for behaviour changes between versions.

If you would rather build from source, the repository ships a Dockerfile that does it for you:

```dockerfile
FROM ubuntu:focal

ENV DEBIAN_FRONTEND noninteractive

RUN apt update -y

RUN apt install \
          openjdk-21-jdk \
	  git \
          --assume-yes

COPY . /code

WORKDIR /code

RUN ./gradlew build
```

The image installs JDK 21, copies the checkout into /code and runs the Gradle build. Expect a Gradle build of a Java mod, not a one-line install; the README gives no build duration. For a local build outside Docker, the repository includes gradlew and gradlew.bat, so the wrapper is the intended entry point.

## Where Baritone stops being the right tool

The README describes a pathfinder, not an agent. It does not document a way to hand Baritone a goal and walk away while it decides what to do next. Commands are issued by the player, and the documentation gives no evidence of a planning layer above pathfinding.

Server rules are the second boundary, and the README does not address them at all. Automated movement on a multiplayer server is a policy question the project is silent on; nothing in the README tells you whether a given server permits it. That silence is not permission.

Version coverage is uneven. The version badges span 1.12.2 to 1.21.3, and the download table is organised per loader, so a player on a Minecraft version with no matching release jar has no supported install path from the README. Building from source does not fix that either, because the loader directories target specific game versions.

Finally, the README does not document rollback or a downgrade procedure. If a new release changes pathing behaviour in a way you dislike, the README states no way back beyond installing an older release jar yourself.

## Baritone against Litematica and other build helpers

Litematica is the comparison that comes up in search results alongside Baritone, and the two solve different halves of a build. Litematica is a schematic mod: it loads a saved structure and renders a ghost overlay so a player can place blocks against it. The placement is still manual. Baritone works from the world state toward a destination, and it is the movement layer.

The README's integration badges point at a different kind of neighbour. Impact, Lambda, ForgeHax, Aristois, rootNET, Future and RusherHack all embed or add on to Baritone, with badge labels naming specific versions such as Impact v1.6.3 and Lambda v1.2.17. Those are full client mods that bundle pathfinding rather than replace it. Choosing between Baritone standalone and a client that includes it is a question of how much other functionality you want in the same jar.

One search phrase, how to use baritone to build litematica, describes the combination rather than a competition, and the README does not document a Baritone-to-Litematica interface. Treat any such workflow as something you would assemble yourself.

## Licence, maintenance and what an upgrade costs

The licence badge in the README reads LGPL-3.0 with an anime exception, and the repository carries LICENSE and LICENSE-Part-2.jpg as separate files. The LGPL-3.0 part is the standard weak-copyleft licence for libraries; the anime exception is a project-specific addition whose terms are in those files, not in the README. Read both files before you redistribute a modified build. This is a description of what the repository states, not legal advice.

The project is not archived, and the last push was on 2026-09-19. Three releases landed on 2026-09-01: v1.12.0, v1.11.3 and v1.10.8. That pattern, three version lines released on the same day, suggests the project maintains parallel branches for different Minecraft versions rather than a single rolling release. Upgrading therefore means matching a release line to your game version, not always taking the newest tag.

The upgrade cost is mostly the loader matrix. A jar built for one loader and game version does not carry over to another, and the repository has separate forge, fabric and neoforge directories because of it. Budget for a rebuild or a re-download on every Minecraft version bump.

## Conclusion

Adopt Baritone if you play Minecraft on one of the supported versions and want a pathfinder you drive by hand, on Forge, Fabric or NeoForge. Do not adopt it if you expect a fully autonomous bot, or if your server treats automated movement as cheating. Before installing, check that your game version matches a release jar on the releases page, and confirm the LGPL-3.0 licence plus anime exception is acceptable to you.

## FAQ

### How do I install the Baritone Minecraft mod?

Download the release jar from the README's quick download table that matches both your mod loader and your Minecraft version, then place it in your mods folder. The README organises those links into Forge, Fabric and NeoForge columns.

### How do I install Baritone?

The README's quick download section links release jars per loader and per game version, for example baritone-api-forge-1.2.19.jar for 1.12.2 Forge. If you build from source instead, the repository's Dockerfile installs openjdk-21-jdk and runs ./gradlew build.

### How do I use Baritone commands?

Baritone is driven from in-game chat, and the README points to USAGE.md for the command reference rather than listing commands inline. The README does not reproduce the command set, so USAGE.md is the file to read.

### How do I use the Baritone mod?

You issue commands in chat and the pathfinder computes a route over the block world using A* search, which the repository topics list as astar and astar-pathfinding. The README describes Baritone as a Minecraft pathfinder bot and notes it has been used in Impact since version 4.4.

### How do I use Baritone to mine diamonds?

The README does not document a diamond-specific command, and it does not list the command set inline. Mining behaviour is covered by the command reference in USAGE.md, which is the file the README points to.

### How do I use Baritone to find structures?

The README does not document a structure-finding command, and it does not list the command set inline. Any such command would appear in USAGE.md, which is the file the README points to for usage.

## Sources

- [cabaletta/baritone on GitHub](https://github.com/cabaletta/baritone)
- [Issues](https://github.com/cabaletta/baritone/issues)
- [License: LGPL-3.0](https://github.com/cabaletta/baritone/blob/1.21.4/LICENSE)
- [README](https://github.com/cabaletta/baritone/blob/1.21.4/README.md)
- [Releases](https://github.com/cabaletta/baritone/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/cabaletta-baritone
