baritone/IMPACT.md

5.0 KiB

Integration between Baritone and Impact

Impact 4.4 will have Baritone included on release, however, if you're impatient, you can install Baritone into Impact 4.3 right now!

An Introduction

There are some basic steps to getting Baritone setup with Impact.

  • Acquiring a build of Baritone
  • Placing Baritone in the libraries directory
  • Modifying the Impact Profile JSON to run baritone
  • How to use Baritone

Acquiring a build of Baritone

There are 3 methods of acquiring a build of Baritone (While it is still in development)

Official Release (Not always up to date)

https://github.com/cabaletta/baritone/releases

For Impact 4.3, there is no Baritone integration yet, so you will want baritone-standalone-X.Y.Z.jar.

Any official release will be GPG signed by leijurv (44A3EA646EADAC6A) and ZeroMemes (73A788379A197567). Please verify that the hash of the file you download is in checksums.txt and that checksums_signed.asc is a valid signature by those two public keys of checksums.txt.

The build is deterministic, and you can verify Travis did it properly by running docker build --no-cache -t cabaletta/baritone . && docker run --rm -it cabaletta/baritone sh scripts/build.sh yourself and comparing the shasum. Note that for some godawful reason this doesn't work on Mac, the shasums are different even though docker is supposed to work the same everywhere. I get the same shasums as Travis when the host is Linux though.

Building Baritone yourself

There are a few steps to this

  • Clone this repository
  • Setup the project as instructed in the README
  • Run the build gradle task. You can either do this using IntelliJ's gradle UI or through a command line
    • Windows: gradlew build
    • Mac/Linux: ./gradlew build
  • The build should be exported into /build/libs/baritone-X.Y.Z.jar

Cutting Edge Release

If you want to trust @Plutie#9079, you can download an automatically generated build of the latest commit from his Jenkins server, found here.

Placing Baritone in the libraries directory

/libraries is a neat directory in your Minecraft Installation Directory that contains all of the dependencies that are required from the game and some mods. This is where we will be putting baritone.

  • Locate the libraries folder, it should be in the Minecraft Installation Directory
  • Create 3 new subdirectories starting from libraries
    • cabaletta
      • baritone
        • X.Y.Z
  • Copy the build of Baritone that was acquired earlier, and place it into the X.Y.Z folder
    • The full path should look like <Minecraft>/libraries/cabaletta/baritone/X.Y.Z/baritone-X.Y.Z.jar

Modifying the Impact Profile JSON to run baritone

The final step is "registering" the Baritone library with Impact, so that it loads on launch.

  • Ensure your Minecraft launcher is closed
  • Navigate back to the Minecraft Installation Directory
  • Find the versions directory, and open in
  • In here there should be a 1.12.2-Impact_4.3 folder.
    • If you don't have any Impact folder or have a version older than 4.3, you can download Impact here.
  • Open the folder and inside there should be a file called 1.12.2-Impact_4.3.json
  • Open the JSON file with a text editor that supports your system's line endings
    • For example, Notepad on Windows likely will NOT work for this. You should instead use a Text Editor like Notepad++ if you're on Windows. (For other systems, I'm not sure what would work the best so you may have to do some research.)
  • Find the libraries array in the JSON. It should look something like this.
    "libraries": [
        {
            "name": "net.minecraft:launchwrapper:1.12"
        },
        {
            "name": "com.github.ImpactDevelopment:Impact:4.3-1.12.2",
            "url": "https://impactdevelopment.github.io/maven/"
        },
        {
            "name": "com.github.ImpactDeveloment:ClientAPI:3.0.2",
            "url": "https://impactdevelopment.github.io/maven/"
        },
        ...
    
  • Create a new object in the array, between the Impact and ClientAPI dependencies preferably.
    {
        "name": "cabaletta:baritone:X.Y.Z"
    },
    
  • Now find the "minecraftArguments": "..." text near the top.
  • At the very end of the quotes where it says --tweakClass clientapi.load.ClientTweaker", add on the following so it looks like:
    • --tweakClass clientapi.load.ClientTweaker --tweakClass baritone.launch.BaritoneTweakerOptifine"
  • If you didn't close your launcher for this step, restart it now.
  • You can now launch Impact 4.3 as normal, and Baritone should start up

How to use Baritone

Instructions on how to use Baritone are limited, and you may have to read a little bit of code (Really nothing much just plain English), you can view that here.