Skip to content

Getting Started [1.13 to 1.18.2]

TonimatasDEV edited this page Oct 23, 2023 · 2 revisions

Set up your Gradle build script

You can integrate and automatically download JEI for your mod project using Gradle.
Just add the following to your build script (build.gradle):

Repositories

repositories {
  maven {
    url = "https://api.modrinth.com/maven"
  }
}

Dependencies using FG3

dependencies {
  /* minecraft dependency is here */

  // compile against the JEI API but do not include it at runtime
  compileOnly fg.deobf("mezz.jei:jei-${mc_version}:${jei_version}:api")
  // at runtime, use the full JEI jar
  runtimeOnly fg.deobf("mezz.jei:jei-${mc_version}:${jei_version}")
}

Choose a Version

${mc_version} gets replaced by the current Minecraft version. (i.e. 1.16.5)
${jei_version} gets replaced by the version of JEI you want to use (i.e 7.6.1.75)

For a list of available JEI versions, see CurseForge or the maven listing.

These properties can be set in a file named gradle.properties, placed in the same directory as your build.gradle file.

For this example, your gradle.properties would look like this:

mc_version=1.16.5
jei_version=7.6.1.75

Examples of working build.gradle

You can see the Botania build.gradle for an example of this being used.
There are many more examples from mods in the List of Plugin Implementations.

Troubleshooting

If you have not set up a project with gradle before, or are having issues with it in general, I recommend cpw's videos on how to set up Minecraft Forge projects in IntelliJ Idea.

TIP: I've watched these videos like 20 times, and only recently understand it.
There is no shame in having your hand held through the horrors of a broken build.gradle.

If you're still stuck and getting frustrated, check out the #ForgeGradle channel on IRC, ask for help, show them your build.gradle on gist, and wait for someone to reply. If you haven't used IRC before, know that sometimes it's busy and sometimes it takes a long while to get a reply. Make sure you ask your question right away, be patient, and wait around long enough for the reply.

Why compile against the API?

The example script only compiles against the API, which is very stable. When you run your mod (runtime), the full JEI will run as well so that you can still test with it in development.

If you make the mistake of compiling against the full mod jar and then use classes from JEI that are not in the API, your mod could break any time JEI updates.

If you find that you need a feature that is not in the API, be sure to ask on the issue tracker.