Skip to content

TwelveIterationMods/balm-mod

Repository files navigation

Balm Mod Template

This is a template project that can be used to setup a multi-loader Minecraft Mod development environment with Balm.

The gradle setup is heavily based on Jared's MultiLoader Template.

Getting Started

  • Click "Use this template" on GitHub to create a new repository based on this template.
  • Clone the repository to your local machine.
  • Open the project in IntelliJ IDEA.
  • Open gradle.properties and configure your mod's metadata.
  • Now that you've set a mod id, you should rename all instances of yourmod and YourMod to your mod id / name, both in code and in file names.
  • The majority of code lies in the common folder, while the mod-loader specific folders are only needed for implementing third party mod compatibility.
  • The template includes a basic example for most of Balm's features. Delete parts that you don't need before releasing your mod.
  • Don't forget to replace your mod's logo in common/src/main/resources/yourmod-icon.png.

If you need to add dependencies, do so in dependencies.gradle. I recommend leaving the build.gradle files untouched to make updating to newer versions of the template easier.

Structure

gradle.properties

Configure your mod's metadata in this file.

/dependencies.gradle

In these files, you can specify additional dependencies. You'll find Balm in there as well.

gradle/libs.versions.toml

This is a version catalog, specifying the versions of Balm, mod loaders, and Gradle plugins.

CHANGELOG.md

This file is used as a changelog for uploads to Modrinth and CurseForge.

LICENSE

You should replace this file with a license of your choice.

Unless you fully understand the implications of the license you choose, you should keep this as All Rights Reserved.

repositories.gradle

This is where Maven repositories for fetching dependencies are configured.

It is good practice to filter each repository to only the groups you expect to download from them.

Contributing

If you're interested in contributing to the mod, you can check out issues labelled as "help wanted".

When it comes to new features, it's best to confer with me first to ensure we share the same vision. You can join us on Discord if you'd like to talk.

Contributions must be done through pull requests. I will not be able to accept translations, code or other assets through any other channels.