/fdd-xplat

A template for creating Fabric/Quilt/NeoForge mods using a shared code base

Primary LanguageJavaCreative Commons Zero v1.0 UniversalCC0-1.0

FDD-XPlat


This project is a Gradle template that allows you to build Forge/Fabric mods using shared code. You do not require any extra libraries like Architectury.

This project is powered by Unimined, and supports almost every Minecraft version.


Using this template

Before you start, please note that this project has been built on, and tested ONLY on IntelliJ idea. Other IDE's have not been tested, and cannot be guaranteed to work.

  1. Clone, download the project to your computer, or generate a new repository from this template

  2. Open up settings.gradle and replace rootProject.name = 'fdd-xplat' with the name of your project

  3. Open up gradle.properties and replace the following values:

    1. mod_author -> Your name
    2. mod_id -> The id of your mod. For example: myawesomemod
    3. mod_name -> The name of your mod. This will be used for the output jars
    4. minecraft_version -> The minecraft version your project targets
    5. fabric_loader -> The fabric loader version to use. Find this here
    6. fabric_api -> The Fabric API for your minecraft version. Find this here
    7. neoforge_version -> The NeoForge version for your Minecraft version to use. For example: 39-beta
  4. Open up fabric.mod.json from the Fabric module, and replace the following values:

    1. description -> Describe what your mod does
    2. homepage -> Your Modrinth/Curseforge/GitHub page of the mod
    3. sources -> Your GitHub repository of the mod
    4. license -> Your mod license
    5. icon -> Your mod icon
    6. minecraft -> The minecraft version(s) your mod supports
    7. If you do not plan on using mixins, remove the mixins section
  5. Open up mods.toml from the NeoForge module and replace the following values:

    1. loaderVersion -> The neoforge version code
    2. license -> Your mod license
    3. issueTrackerURL -> Your GitHub repository of the mod
    4. displayURL -> Your Modrinth/Curseforge/GitHub page of the mod
    5. logoFile -> Your mod icon
    6. description -> Your mod description
    7. versionRange -> [neoforgeVersionCode,) and [1.20.2,) (Replace with the minecraft versions your mod supports)
  6. If your default JVM/JDK is not Java 21 you will encounter an error when opening the project. This error is fixed by going to File > Settings > Build, Execution, Deployment > Build Tools > Gradle > Gradle JVM and changing the value to a valid Java 21 JVM. You will also need to set the Project SDK to Java 21. This can be done by going to File > Project Structure > Project SDK. Once both have been set open the Gradle tab in IDEA and click the refresh button to reload the project.

  7. Replace the contents of LICENSE with your mod license

  8. Replace the contents of readme.md with your mod readme


Development Guide

When using this template the majority of your mod is developed in the Common project. The Common project is compiled against the vanilla game and is used to hold code that is shared between the different loader-specific versions of your mod. The Common project has no knowledge or access to ModLoader specific code, apis, or concepts. Code that requires something from a specific loader must be done through the project that is specific to that loader, such as the NeoForge or Fabric project.

Loader specific projects such as the NeoForge and Fabric project are used to load the Common project into the game. These projects also define code that is specific to that loader. Loader specific projects can access all of the code in the Common project. It is important to remember that the Common project can not access code from loader specific projects.


License

This template is licensed under CC0-1.0 license. You can use your own license for the mods you make using this project