Baritone 9minecraft Client Mod Wiki

Baritone is the AI pathfinding engine that powers many of Minecraft's most popular utility clients. Give it a single chat command and it will walk, mine, build, farm, and explore the world for you, calculating the fastest possible route in real time while breaking blocks, placing bridges, climbing, and dodging hazards on its own.

This wiki is the complete reference for the Baritone 9minecraft Client Mod on the Fabric and NeoForge loaders. It covers everything a regular player needs to drive Baritone from chat, and everything a developer needs to control Baritone from their own mod through its public API.

• What it is: a goal-based pathfinder + automation system (the same engine trusted on anarchy servers).
• What it is not: an X-ray, a kill-aura, or a combat hack. Baritone only handles movement, mining, and building.
• License: Baritone is released under LGPL 3.0, which is why it can be embedded as a library inside other clients and mods.

1. Install the mod. Drop the Fabric or NeoForge jar into your mods folder (see the How to Install section on the main download page). Baritone has no other dependencies.
2. Launch the game and join any single-player world or server.
3. Open chat (press T) and type a command. Every Baritone command starts with the prefix #.
4. Type #help first — the command list is clickable and supports tab-completion.

A good first test:

#goto 100 64 100

Baritone immediately starts walking to those coordinates, tracing a glowing path as it goes. Type #stop at any time to cancel.

Tip: by default you can also type commands directly without the #, but that risks a typo leaking into public chat, so the # prefix is recommended.

Every command is prefixed with #. Arguments in <angle brackets> are required, [square brackets] are optional.

A goal is the objective Baritone tries to reach. Most commands create a goal for you, but understanding goal types helps when using the API or composite objectives.

• GoalBlock(x, y, z) — reach one exact block position.
• GoalXZ(x, z) — reach an X/Z column at any Y (best for long travel).
• GoalYLevel(y) — reach a specific height.
• GoalNear(x, y, z, range) — get within range blocks of a position.
• GoalGetToBlock(x, y, z) — stand adjacent to a block (used by #goto <block>).
• GoalComposite(...) — satisfy any one of several goals (closest wins).
• GoalRunAway(...) — maximize distance from a point (used by #invert).

#goal sets a goal and waits; #goto sets a goal and starts pathing immediately.

Baritone has hundreds of tunable settings. Change them live from chat:

• Toggle a boolean: #allowSprint (flips it on/off).
• Set a value: #followRadius 5 or #primaryTimeoutMS 2000.
• Reset: #allowSprint reset, or #reset for everything.
• Review: #modified lists everything you have changed.

Settings persist in baritone/settings.txt inside your game folder, so you can also edit them there.

Commonly tweaked settings

Strip-mine for diamonds, then stop after 32:

#mine 32 diamond_ore

Travel ten thousand blocks out without micromanaging:

#allowParkour true
#goto 10000 ~ 10000

Build a base from a schematic file you placed in schematics/:

#build mybase

Follow a friend across the map:

#follow player Steve

Auto-farm a wheat field within 20 blocks:

#farm 20

Explore to reveal new terrain (great for map-makers):

#explore

Because Baritone ships an api artifact under LGPL 3.0, other mods and custom clients can drive it programmatically. Add the baritone-api jar as a dependency (compile against the API package baritone.api), then control the primary Baritone instance.

Minimal example

import baritone.api.BaritoneAPI;
import baritone.api.pathing.goals.GoalXZ;
import baritone.api.pathing.goals.GoalBlock;

// Tune settings
BaritoneAPI.getSettings().allowSprint.value = true;
BaritoneAPI.getSettings().primaryTimeoutMS.value = 2000L;

// Send Baritone to an X/Z coordinate
BaritoneAPI.getProvider().getPrimaryBaritone()
    .getCustomGoalProcess()
    .setGoalAndPath(new GoalXZ(10000, 20000));

Key entry points

• BaritoneAPI.getProvider().getPrimaryBaritone() → the active IBaritone.
• IBaritone.getCustomGoalProcess() → setGoalAndPath(Goal), setGoal(Goal), path().
• IBaritone.getPathingBehavior() → cancel, status, current path.
• IBaritone.getMineProcess().mine(...) → start an auto-mine task.
• IBaritone.getBuilderProcess().build(...) → build a schematic.
• IBaritone.getExploreProcess() / getFollowProcess() → exploration and following.
• BaritoneAPI.getSettings() → every setting as a typed, mutable field.

Goal classes (package baritone.api.pathing.goals)

GoalBlock, GoalXZ, GoalYLevel, GoalNear, GoalGetToBlock, GoalComposite, GoalRunAway — construct one and hand it to setGoalAndPath.

Remember: distributing a client that bundles Baritone means complying with LGPL 3.0 (keep Baritone's source available and attributed).

My commands appear in public chat instead of running. Prefix every command with #, e.g. #goto. Direct (prefix-less) input is easy to trigger by accident.

Baritone walks into lava or off cliffs. Pathing avoids known hazards, but mob knockback or unloaded chunks can interfere. Lower risk with #allowParkour false and travel with full chunks loaded.

It refuses to break or place blocks. Check #allowBreak and #allowPlace — both must be enabled for mining and bridging.

#mine finds nothing. Make sure the block ID is correct (diamond_ore, not diamond) and that ores exist nearby; enable mineScanDroppedItems to auto-collect drops.

Building does nothing. The schematic must be in the schematics/ folder and referenced by name without the extension: #build mybase.

Is Baritone a cheat / will it get me banned? Baritone only automates movement and mining — it is a quality-of-life client. Server rules vary, so check whether automation is allowed before using it online.

Does it work with other client mods? Yes. Baritone is designed to coexist with other Fabric/NeoForge mods and is frequently embedded inside larger utility clients.