Modding

Users

Prerequisites

• Verify your Java 17 installation (Windows, macOS or Linux)
• Install MultiMC or one of its fork (PolyMC, Prism Launcher, ...)

Note: to avoid a common issue on GNU/Linux systems, both users and developers should use the Temurin 17 JDK (AUR package)

Singleplayer

Installation

We are going to use Babric, which is a modification of Fabric for Minecraft Beta 1.7.3.

1. Download the Babric MultiMC instance for BTA! 1.7.7.0_01, 1.7.7.0 (archive) or 1.7.6.2_02 (archive)
2. Import the instance into your launcher

Finding and adding mods

1. Search through the #mods-and-community-downloads channel on the official BTA! Discord server or find mods on Github (example)
2. Download the JAR file
3. Put it inside your .minecraft/mods folder in your Babric BTA! instance directory

Multiplayer

Installation

1. Download the Babric server for 1.7.7.0_01
2. Add your mods to the mods directory
3. Customize your server (see Setting up a Server)
4. Run start.bat if you are on Windows or start.sh if you are on GNU/Linux

Developers

Prerequisites

• Install IntelliJ IDEA and MinecraftDev plugin

Set up the development environment

1. Download or clone the BTA Babric Example Mod (or BTA Babric Example Mod Kotlin) and put it somewhere: git clone https://github.com/Turnip-Labs/bta-minimal-mod.git
2. Import the project in IntelliJ IDEA, close it and open it again.
3. Create a new run configuration by going in Run > Edit Configurations. Then click on the plus icon and select Gradle. In the Tasks and Arguments field enter build. Running it will build your finished jar files and put them in build/libs/
4. Open File > Settings and head to Build, Execution, Development > Build Tools > Gradle. Change Build and run using and Run tests using to IntelliJ IDEA
5. Open File > Project Structure, select Project and set Compiler output to your project's path/out.
6. Make sure your Client and Server run configurations have -Dfabric.gameVersion=1.7.7.0 in VM options (even for 1.7.7.0_01)
7. Done. Now all that's left is to change every mention of examplemod to your own mod id.

Resources

Developers documentation

• Fabric Wiki
• Introduction to Mixins
• Mixin Official Wiki
• Mixin javadoc
• Mixin Cheatsheet
• BTA modding Discord (unofficial)

Note: Since BTA is distributed without obfuscation, all Mixin classes must set the remap option to false. Also, when modding for BTA! 1.7.6.2_02, set loadMods to false in option.txt to avoid errors showing up in the run client configurations logs.