User Tools

Site Tools


Setting up a mod development environment


  • A Java 8+-compatible JDK (so 8, 9, 10, 11…)
    • Please note that, specifically on Java 11, there are issues connecting to our Maven - see this for more information.


The recommended approach to setting up a development environment is to do the following:

  1. Copy the starting files from fabric-example-mod, excluding the LICENSE and files - as those apply to the template itself, not necessarily to your mod.
  2. Edit
    • Make sure to set archives_base_name and maven_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 the Fabric website - to match the versions you wish to target.
    • Add any other dependencies you plan to use in build.gradle.
  3. Set up the environment with sources - this will allow working indexing and lookups in many common IDEs.
  4. Open the resulting project in your IDE of choice.
  5. Happy modding!


  • 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.
tutorial/setup.txt · Last modified: 2019/02/19 14:23 by mcrafterzz