Editing Modding

Like vanilla versions of ''Minecraft'', it is possible to download and create mods for ''Better than Adventure!''. This page aims to provide resources to assist in mod creation and installation for ''Better than Adventure!''.

== Users ==
=== Prerequisites ===

* Verify your Java 17 installation ([https://fabricmc.net/wiki/player:tutorials:java:windows Windows], [https://fabricmc.net/wiki/player:tutorials:java:mac macOS] or [https://fabricmc.net/wiki/player:tutorials:java:linux Linux])
* Install [https://multimc.org/ MultiMC] or one of its fork ([https://polymc.org/ PolyMC], [https://prismlauncher.org/ Prism Launcher], ...)

Note: to avoid a common issue on GNU/Linux systems, both users and developers should use the [https://adoptium.net/ Temurin 17 JDK] ([https://aur.archlinux.org/packages/jdk17-temurin AUR package])

=== Singleplayer ===

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

# Download the Babric MultiMC instance for BTA! [https://github.com/Turnip-Labs/babric-instance-repo/releases/download/v1.7.7.0_02/bta_babric_instance_1.7.7.0_02.zip 1.7.7.0_02], [https://github.com/Turnip-Labs/babric-instance-repo/releases/download/v1.7.7.0_01/bta_babric_instance_1.7.7.0_01.zip 1.7.7.0_01], [https://github.com/Turnip-Labs/babric-instance-repo/releases/download/v1.7.7.0/instance.zip 1.7.7.0] ([https://cdn.discordapp.com/attachments/1046707025234640956/1137706168005963806/BTA_1.7.7.0_Babric.zip archive]) or [https://github.com/Turnip-Labs/babric-instance-repo/releases/download/v1.7.6.2_02/instance.zip 1.7.6.2_02] ([https://drive.google.com/file/d/1d_VocjEW2ItjIzbUAsrX_pBThH_zkZAn/view archive])
# [https://github.com/MultiMC/Launcher/wiki/Import-Instance Import the instance] into your launcher

==== Finding and adding mods ====
# Search through the <code>#mods-and-community-downloads</code> channel on the official BTA! Discord server or find mods on [https://github.com/ Github] ([https://github.com/Turnip-Labs example]), or on [https://bta-modding.nouma-vallee.fr/ BTA Modding] (by Nouma). 
# Download the JAR file
# Put it inside your <code>.minecraft/mods</code> folder in your Babric BTA! instance directory

=== Multiplayer ===

==== Installation ====

# Download the Babric server for [https://github.com/Turnip-Labs/babric-instance-repo/releases/download/v1.7.7.0_02/bta_babric_server_1.7.7.0_02.zip 1.7.7.0_02] or [https://github.com/Turnip-Labs/babric-instance-repo/releases/download/v1.7.7.0_01/bta_babric_server_1.7.7.0_01.zip 1.7.7.0_01]
# Add your mods to the <code>mods</code> directory
# Customize your server (see [[Setting up a Server]])
# Run <code>start.bat</code> if you are on Windows or <code>start.sh</code> if you are on GNU/Linux

== Developers ==

=== Prerequisites ===

* Install [https://www.jetbrains.com/idea/ IntelliJ IDEA] and [https://plugins.jetbrains.com/plugin/8327-minecraft-development/ MinecraftDev plugin]

=== Set up the development environment ===
Download or clone the [https://github.com/Turnip-Labs/bta-example-mod BTA Babric Example Mod] (or [https://github.com/Turnip-Labs/bta-example-mod-kotlin the Kotlin version] / [https://github.com/Turnip-Labs/bta-example-mod-scala the Scala version])  repository and follow the setup instructions

== Resources ==

=== Developers documentation ===

* [https://fabricmc.net/wiki/doku.php Fabric Wiki]
* [https://fabricmc.net/wiki/tutorial:mixin_introduction Introduction to Mixins]
* [https://github.com/SpongePowered/Mixin/wiki Mixin Official Wiki]
* [https://jenkins.liteloader.com/view/Other/job/Mixin/javadoc/index.html Mixin javadoc]
* [https://github.com/2xsaiko/mixin-cheatsheet/blob/master/README.md Mixin Cheatsheet]
* [https://discord.gg/FTUNJhswBT BTA modding Discord] (unofficial)

Note: Since ''Better than Adventure!'' is distributed without obfuscation, all Mixin classes must set the <code>remap</code> option to false. Also, when modding for [[Better than Adventure! 1.7.6.2_02|''Better than Adventure!'' 1.7.6.2_02]], set <code>loadMods</code> to false in option.txt to avoid errors showing up in the run client configurations logs.