baritone/README.md
elongated muskrat cbb3483456
updated compatible versions to future badge
updated the compatible versions to the future integrations badge
2020-07-16 14:35:17 -03:00

7.3 KiB

Baritone

HitCount GitHub All Releases

Build Status Release License Codacy Badge Minecraft Minecraft Minecraft Minecraft Code of Conduct Known Vulnerabilities Contributions welcome Issues GitHub issues-closed Pull Requests Code size GitHub repo size Lines of Code GitHub contributors GitHub commits Impact integration KAMI Blue integration ForgeHax integration Aristois add-on integration rootNET integration WWE integration Future integration forthebadge forthebadge

A Minecraft pathfinder bot.

Baritone is the pathfinding system used in Impact since 4.4. There's a showcase video made by @Adovin#0730 on Baritone which I recommend. Here's a (very old!) video I made showing off what it can do.

The easiest way to install Baritone is to install Impact, which comes with Baritone. The second easiest way (for 1.12.2 only) is to install the v1.2.* api-forge jar from releases. For 1.12.2 Forge, just click here. Otherwise, see Installation & setup. Once Baritone is installed, look here for instructions on how to use it.

For 1.15.2, click here and see description. If you need Forge 1.15.2, look here, follow the instructions, and get the api-forge jar.

This project is an updated version of MineBot, the original version of the bot for Minecraft 1.8.9, rebuilt for 1.12.2 through 1.15.2. 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 a 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 is in compliance 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.