Contributing to BetterF3

If you would like to improve BetterF3, there are several ways you can help.

• You can make a financial donation by checking the "Sponsor this project" sidebar on the root GitHub page.
• You can contribute to the language files by either adding a PR or checking out our Crowdin Page.
• If you are a developer, check below!

Developers

Requirements

To help contribute to our project, you must follow these requirements:

• You need git installed. You can download it from here on Windows.
• You need Java 21 or later JDK. Check out Adoptium for most platforms.
• You must use either IntelliJ IDEA or Visual Studio Code. Other IDEs are unsupported and may or may not work.

Compiling

You can compile the source code here:

1. Clone this project to your local machine
2. This project is split into three parts.
   1. common holds all the common files between Forge and Fabric
   2. fabric holds all the files for only Fabric
   3. forge holds all the files for only Forge
3. Type ./gradlew build in a terminal to build the project. On Windows, leave out ./ at the beginning for all gradlew commands if nothing works.
4. cd into either the fabric or forge directory, then cd to build/libs and the compiled mod will be in the format betterf3-{version}-{modloader}.jar (subject to change).

Pull Requests

All pull requests must comply with our CheckStyle requirements.

• Run ./gradlew checkstyleMain to check if you comply.
• (Recommended) import the .checkstyle/checkstyle.xml file into your IDE.

Creating Modules

To create a new module, either in this mod or your own, follow the directions in CreateModule.md.