Better Than Adventure
for X Minecraft Launcher

This repo contains files and instructions on getting Better Than Adventure (both regular as well as Babric version for modding) to work on X Minecraft Launcher (XMCL).

Table of Contents

• Instructions
• Troubleshooting
• Adding New Versions
• Credits & Legal Notice

Instructions

Import the version folders

1. Download the zip file from release and save it somewhere temporary.
2. Launch XMCL, open the "Store Location" folder (where your instances, libraries, etc resides) from your XMCL Settings page:
   
3. Open the zip you downloaded with any archive utility and extract the versions/ folder to the XMCL "Store Location" folder you opened. If prompted to "Write into" existing folder of same name, accecpt it.

Warning

Make sure the arcive utility you use preserves the folder struture when extracting, which means the whole versions/ folder with the bta-*/ and bta-*-babric/ sub-folders inside. If not, configure it to do so. Or you can just drag and drop the versions/ folder if utility has GUI.

Install Java 17 (Skip if you have it already)

Better Than Adventure uses Java 17 instead of Java 8.

Go to the site below for installer and runtime archive download links, install instructions are also included.
https://adoptium.net/temurin/releases?version=17&os=any&arch=any

Create the instance

1. In XMCL, Create a new instance:

   • For Minecraft section, click on the bug icon, then search & pick b1.7.3
     
     
     

   • For Local Version section at the very bottom, choose bta-<version you imported> (ex. bta-7.3_04).

     • WARNING: Do NOT choose the option with "-babric" postfix, that is for later.

   • For JavaLocation, choose 17.0.x (ex. 17.0.17)

2. Once the instance is created, select it if not already, click on the gear icon at the top-right corner of launcher:
   

3. On the right side, find JVM Options field, and add in the following JVM options:

   -XX:+UseG1GC -Dsun.rmi.dgc.server.gcInterval=2147483646 -XX:+UnlockExperimentalVMOptions -XX:G1NewSizePercent=20 -XX:G1ReservePercent=20 -XX:MaxGCPauseMillis=50 -XX:G1HeapRegionSize=32M
   

4. Press the blue INSTALL button, let XMCL install everything.

5. You are done! Launch the instance and enjoy. If you want modding support, keep reading.

Modding support with Babric

Warning

Make sure you followed the previous section to install the regular version first. Otherwise the steps below will not work.

1. Go back to the instance's settings page if not already.
2. On the left side at the bottom of the page, find Local Version and select bta-<version-babric-<babric version>(ex. bta-7.3_04-babric-0.15.6).
3. XMCL will prompt "Your modification is unsaved" at the bottom middle, click Save to save changes.
4. Click INSTALL to let XMCL install additional libraries files.

Adding New Versions

(WIP)

Troubleshooting

If you encounter problems, post them in issues and I'll investigate. Useful items to include in your posts:

• Generate a report by clicking on Feedback botton at the top-right corner next to your account name, then click GENERATE REPORT. Open the generated report.zip file, then open main.log and copy the content inside, pasting them in a code block in your post.
• View instance logs and crash reports by clicking on the first icon above Launch/Install button:
  
  Choose the most recent problematic launch's report, copy the content then paste them in a code block in your post.

Credits & Legal Notice

Better Than Adventure by Mak and jonkadelic. Fabric intergration (Babric) from Turnip-Labs

This project makes use of, or provides a launcher integration for, the mod Better Than Adventure by Mak and jonkadelic and Fabric Integration (Babric) from Turnip-Labs.

This project does not itself distribute any files from stated parties. All downloads performed by the project are directly linked to perspective official sources and repository:

• Better Than Adventure jarmods and libraries: https://github.com/Turnip-Labs/bta-fabric-instance-repo/releases
• Fabric integration (Babric): https://github.com/Turnip-Labs/bta-fabric-instance-repo/releases

I am not responsible for the contents of the linked mod or any subsequent modifications by the original authors.

Minecraft® from Microsoft Corporation

Minecraft® is a trademark of Microsoft Corporation.

This project is not affiliated with, endorsed by, or in any way officially connected with Microsoft Corporation or Mojang Synergies AB. All product names, logos, and brands are property of their respective owners.

X Minecraft Launcher

This project integrates with X Minecraft Launcher (XMCL), an open-source Minecraft launcher released under the MIT License.