Example Forge Mod for Minecraft 1.7.10

An example mod for Minecraft 1.7.10 with Forge focussed on a stable, updatable setup.

Motivation

We had our fair share in struggles with build scripts for Minecraft Forge. There are quite a few pitfalls from non-obvious error messages. This Example Project provides you a build system you can adapt to over 90% of Minecraft Forge mods and can easily be updated if need be.

Getting started

Fork this repository (you can keep the fork to simplify merging any build script updates in the future)
Clone repository
Replace placeholders (edit values in gradle.properties, change example package and class names, etc.)
Run ./gradlew setupDecompWorkspace (if build fails with Could not find :forgeBin:1.7.10-10.13.4.1614-1.7.10. this should fix it)
Make sure to checkout the rest sections of this file.
You are good to go!

Features

Updatable: Replace build.gradle with a newer version
Optional API artifact (.jar)
Optional version replacement in Java files
Optional shadowing of dependencies
Simplified setup of Mixin and example
Optional named developer account for consistent player progression during testing
Boilerplate forge mod as starting point
Improved warnings for pitfalls
Git Tags integration for versioning
GitHub CI
Jitpack CI

Files

build.gradle: This is the core script of the build process. You should not need to tamper with it, unless you are trying to accomplish something out of the ordinary. Do not touch this file! You will make a future update near impossible if you do so!
gradle.properties: The core configuration file. It includes
dependencies.gradle: Add your mod's dependencies in this file. This is separate from the main build script, so you may replace the build.gradle if an update is available.
repositories.gradle: Add your dependencies' repositories. This is separate from the main build script, so you may replace the build.gradle if an update is available.
jitpack.yml: Ensures that your mod is available as import over Jitpack.
.github/workflows/gradle.yml: A simple CI script that will build your mod any time it is pushed to master or main and publish the result as release in your repository. This feature is free with GitHub if your repository is public.

Feedback wanted

If you tried out this build script we would love to head your opinion! Is there any feature missing for you? Did something not work? Please open an issue and we will try to resolve it asap!

Forge's Access Transformers

You may activate Forge's Access Transformers by defining a configuration file in gradle.properties.

Check out the example-access-transformers brach for a working example!

For Advanced Modders: Mixins

You may activate Mixin in 'gradle.properties'. In that case a mixin configuration (usually named mixins.mymodid.json) will be generated automatically, and you only have to write the mixins itself. Dependencies are handled as well. Take a look at the examples in com.myname.mymodid.mixinplugin.* and com.myname.mymodid.mixins.*. The use of a MixinPlugin allows the injection into any mod and not just vanilla Minecraft.

Check out the example-mixins brach for a working example!

Happy modding,
SinTh0r4s, TheElan and basdxz

TheElan / ExampleMod1.7.10