Skip to content

cabaletta/baritone

 
 

Repository files navigation

Warning: Old Branch!!

Click here to go to the current Baritone readme.

This branch (master) is Baritone for Minecraft 1.12.2. This is the original version of Minecraft that Baritone was written for, and it was the primary development branch for over 5 years. As such, it's quite mature, and arguably more reliable than Baritone for newer versions of Minecraft. Nevertheless, as of August 2023, with 2b2t's update from 1.12.2 to 1.19.4, I decided to move Baritone's primary development branch accordingly. PRs should now be made against the 1.19.4 branch going forward. This branch might see some fixes going forward, particularly to newer features such as #elytra, but it won't be the primary focus anymore.

The other intermediary branches (1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19.2, and 1.19.3) will probably not receive any updates at all. You can find their last releases in the releases tab, or in the quick download links table.

For 1.16.5 and 1.18.2, the latest release is fully up to date with the code. ZacSharp merged master into some of those versions even after they were deprecated, if you are for some reason really interested in the latest Baritone bugfixes on these versions of Minecraft, you can build from source as of these commits: 1.13.2, 1.14.4, 1.15.2, 1.17.1, 1.19.2. For 1.19.3, merging this commit into it is trivial and is left as an exercise for the reader. For other versions in between these (for example people always ask in the Discord for 1.16.1), you'll have to figure it out yourself.

Baritone

GitHub All Releases

Minecraft Minecraft Minecraft Minecraft Minecraft Minecraft Minecraft Minecraft Minecraft Minecraft

Build Status Release License Codacy Badge Code of Conduct Known Vulnerabilities Contributions welcome Issues GitHub issues-closed Pull Requests GitHub contributors GitHub commits Code size GitHub repo size Lines of Code yes

Impact integration Lambda integration ForgeHax integration Aristois add-on integration rootNET integration Future integration RusherHack integration

forthebadge forthebadge

A Minecraft pathfinder bot.

Baritone is the pathfinding system used in Impact since 4.4. Here's a (very old!) video I made showing off what it can do.

Baritone Discord Server

Quick download links:

Forge Fabric
1.12.2 Forge
1.16.5 Forge 1.16.5 Fabric
1.17.1 Forge 1.17.1 Fabric
1.18.2 Forge 1.18.2 Fabric
1.19.2 Forge 1.19.2 Fabric
1.19.3 Forge 1.19.3 Fabric
1.19.4 Forge 1.19.4 Fabric
1.20.1 Forge 1.20.1 Fabric

Message for 2b2t players looking for 1.19/1.20 Baritone Download it from right above ^. But also please check back in a few days for Baritone Elytra (vid 1 vid 2), which will be ported to 1.19/1.20 soon! It will work on 2b2t with its anticheat, that was the whole point of Baritone Elytra (it's fully vanilla compatible). Also join the discord. Thanks!

How to immediately get started: Type #goto 1000 500 in chat to go to x=1000 z=500. Type #mine diamond_ore to mine diamond ore. Type #stop to stop. For more, read the usage page and/or watch this tutorial playlist. Also try #elytra for Elytra flying in the Nether using fireworks.

For other versions of Minecraft or more complicated situations or for development, see Installation & setup. Also consider just installing Impact, which comes with Baritone and is easier to install than wrangling with version JSONs and zips. For 1.16.5, click here and see description. Once Baritone is installed, look here for instructions on how to use it. There's a showcase video made by @Adovin#6313 on Baritone which I recommend.

This project is an updated version of MineBot, the original version of the bot for Minecraft 1.8.9, rebuilt for 1.12.2 onwards. Baritone focuses on reliability and particularly performance (it's over 30x faster than MineBot at calculating paths).

Have committed at least once a day from Aug 1, 2018, to Aug 1, 2019.

1Leijurv3DWTrGAfmmiTphjhXLvQiHg7K2

Getting Started

Here are some links to help to get started:

Stars over time

Stargazers over time

API

The API is heavily documented, you can find the Javadocs for the latest release here. Please note that usage of anything located outside of the baritone.api package is not supported by the API release jar.

Below is an example of basic usage for changing some settings, and then pathing to an X/Z goal.

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

BaritoneAPI.getProvider().getPrimaryBaritone().getCustomGoalProcess().setGoalAndPath(new GoalXZ(10000, 20000));

FAQ

Can I use Baritone as a library in my custom utility client?

That's what it's for, sure! (As long as usage complies with the LGPL 3.0 License)

How is it so fast?

Magic. (Hours of leijurv enduring excruciating pain)

Additional Special Thanks To:

YourKit-Logo

YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications.

YourKit is the creator of the YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.

We thank them for granting Baritone an OSS license so that we can make our software the best it can be.

Why is it called Baritone?

It's named for FitMC's deep sultry voice.