tutorial:setup
This is an old revision of the document!
Table of Contents
Setting up a mod development environment
Prerequisites
- A Java Development Kit (JDK) for Java 8 or newer https://adoptopenjdk.net/
- Any IDE, for example Intellij IDEA
Steps
- Copy the starting files from fabric-example-mod (or from the Kotlin version, if you wish to use Kotlin,) excluding the
LICENSE
andREADME.md
files - as those apply to the template itself, not necessarily to your mod. - Edit
gradle.properties
:- Make sure to set
archives_base_name
andmaven_group
to your preferred values. - Make sure to update the versions of Minecraft, the mappings and the loader - all of which can be queried through this website - to match the versions you wish to target.
- Add any other dependencies you plan to use in
build.gradle
.
- Import the build.gradle file to your IDE. Follow these instructions to import the project to Visual Studio Code.
- For IntelliJ, press
Add Configuration…
and then selectMinecraft Client
and pressOK
. For Eclipse, If you would like to have the IDE run configs you can rungradlew eclipse
. - Happy modding!
You can generate the Minecraft sources for reference (since IDEA already has a decompiler this is only useful for searching through the code) :
Run the genSources
Gradle task. If your IDE doesn't have Gradle integration, then run the following command in the terminal: gradlew genSources
(or .gradlew genSources
on Linux/MacOS).
Getting started
Try adding an item or a block. It’s also a good idea to visit Applying changes without restarting Minecraft.
Advice
- While Fabric API is not strictly necessary for developing mods, its primary goal is to provide cross-compatibility and hooks where the game engine does not, and as such it is highly recommended!
- As Fabric is in early development, occasionally, with development of fabric-loom (our Gradle build plugin) issues may crop up which require a manual clearing (deleting) of the cache (which can be found in
.gradle/caches/fabric-loom
). Those will generally be announced as they are identified. - Don't hesitate to ask questions! We're here to help you and work with you to make your dream mod a reality.
Troubleshooting
Missing sounds
Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the downloadAssets
task manually - either using IDE's built-in menu or by simply running gradlew downloadAssets
.
tutorial/setup.1572965708.txt.gz · Last modified: 2019/11/05 14:55 by fudge