Modding: Difference between revisions
imported>Ambos m (Added BTA! 1.7.7.0_01 Babric instance) |
imported>Ambos (Added multiplayer section) |
||
Line 8: | Line 8: | ||
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]) | 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]) | ||
=== Installation === | === Singleplayer === | ||
==== Installation ==== | |||
We are going to use Babric, which is a modification of Fabric for Minecraft Beta 1.7.3. | We are going to use Babric, which is a modification of Fabric for Minecraft Beta 1.7.3. | ||
Line 14: | Line 16: | ||
# [https://github.com/MultiMC/Launcher/wiki/Import-Instance Import the instance] into your launcher | # [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]) | # 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]) | ||
# Download the JAR file | # Download the JAR file | ||
# Put it inside your <code>.minecraft/mods</code> folder in your Babric BTA! instance directory | # 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/tag/v1.7.7.0_01 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 == | == Developers == | ||
Line 33: | Line 43: | ||
# Open <code>File > Settings</code> and head to <code>Build, Execution, Development > Build Tools > Gradle</code>. Change <code>Build and run using</code> and <code>Run tests using</code> to <code>IntelliJ IDEA</code> | # Open <code>File > Settings</code> and head to <code>Build, Execution, Development > Build Tools > Gradle</code>. Change <code>Build and run using</code> and <code>Run tests using</code> to <code>IntelliJ IDEA</code> | ||
# Open <code>File > Project Structure</code>, select <code>Project</code> and set <code>Compiler output</code> to your project's path/out. | # Open <code>File > Project Structure</code>, select <code>Project</code> and set <code>Compiler output</code> to your project's path/out. | ||
# Make sure your Client and Server run configurations have <code>-Dfabric.gameVersion=1.7.7.0</code> in <code>VM options</code> | # Make sure your Client and Server run configurations have <code>-Dfabric.gameVersion=1.7.7.0</code> in <code>VM options</code> (even for 1.7.7.0_01) | ||
# Done. Now all that's left is to change every mention of <code>examplemod</code> to your own mod id. | # Done. Now all that's left is to change every mention of <code>examplemod</code> to your own mod id. | ||
Revision as of 09:33, 15 August 2023
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.
- Download the Babric MultiMC instance for BTA! 1.7.7.0_01, 1.7.7.0 (archive) or 1.7.6.2_02 (archive)
- Import the instance into your launcher
Finding and adding mods
- Search through the
#mods-and-community-downloads
channel on the official BTA! Discord server or find mods on Github (example) - Download the JAR file
- Put it inside your
.minecraft/mods
folder in your Babric BTA! instance directory
Multiplayer
Installation
- Download the Babric server for 1.7.7.0_01
- Add your mods to the
mods
directory - Customize your server (see Setting up a Server)
- Run
start.bat
if you are on Windows orstart.sh
if you are on GNU/Linux
Developers
Prerequisites
- Install IntelliJ IDEA and MinecraftDev plugin
Set up the development environment
- 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
- Import the project in IntelliJ IDEA, close it and open it again.
- Create a new run configuration by going in
Run > Edit Configurations
. Then click on the plus icon and select Gradle. In theTasks and Arguments
field enterbuild
. Running it will build your finished jar files and put them inbuild/libs/
- Open
File > Settings
and head toBuild, Execution, Development > Build Tools > Gradle
. ChangeBuild and run using
andRun tests using
toIntelliJ IDEA
- Open
File > Project Structure
, selectProject
and setCompiler output
to your project's path/out. - Make sure your Client and Server run configurations have
-Dfabric.gameVersion=1.7.7.0
inVM options
(even for 1.7.7.0_01) - 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.