Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

ForgeGradle

docs.minecraftforge.net

  • Free plan
  • Windows
  • macOS
  • Linux

What ForgeGradle is

ForgeGradle is a Gradle plugin and Minecraft mod development framework used by Forge and FML. Its documentation guides developers through setting up a mod development environment and does not teach Java, Groovy, or Gradle themselves. Setup requires a Java Development Kit and familiarity with an integrated development environment. The guide provides commands to generate configurations for Eclipse, IntelliJ IDEA, and Visual Studio Code. Run configurations can specify arguments, working directories, task names, environment properties, and system properties; Forge run types include client, server, data, and gameTestServer. Developers can select human-readable mappings during development and use a reobf task to convert a mod JAR to SRG mappings for production. Dependencies can be added from repositories or a local flat directory and wrapped with fg.deobf. An optional Jar-in-Jar system packages selected dependencies inside a mod JAR and writes metadata during the build. The documentation covers Minecraft versions 1.12 through 1.19, plus 1.19.4. ForgeGradle is free, and the repository identifies its license as LGPL-2.1.

Who it suits

ForgeGradle is for developers setting up Minecraft mods with Forge or FML. It assumes Java Development Kit access and familiarity with an IDE and build tooling.

Good to know, and what to watch

  • Free to use, with no pricing or usage limits stated.
  • Provides run configuration commands for three IDEs.
  • Supports client, server, data, and gameTestServer run types.
  • Offers dependency handling and optional Jar-in-Jar packaging.
  • Requires a Java Development Kit and IDE familiarity.
  • Documentation does not teach Java, Groovy, or Gradle.
  • Default stable and snapshot mappings are typically incomplete and unavailable as of Minecraft 1.17.

ForgeGradle

Free

Free plan

Getting started

  1. Install a Java Development Kit
  2. Prepare an integrated development environment
  3. Add the MinecraftForge Maven repository to your Gradle build
  4. Apply the net.minecraftforge.gradle plugin
  5. Generate run configurations for Eclipse, IntelliJ IDEA, or Visual Studio Code
  6. Add mod dependencies through repositories or a local flat directory

Limits to check

The documentation’s default stable and snapshot mapping sets are generally incomplete and are no longer available as of Minecraft 1.17. The documentation also covers ForgeGradle itself rather than teaching Java, Groovy, or Gradle.

The verdict

ForgeGradle provides build and development setup tools for Forge and FML mod projects. It is a more suitable starting point for developers who already know their IDE and build environment than for those seeking a general Gradle tutorial.

Questions people ask

What does ForgeGradle cost?

ForgeGradle is free, with a listed price of free and no stated pricing or usage limits.

Which operating systems are supported?

It runs on Linux, macOS, and Windows.

Which Minecraft versions are covered?

The documentation lists versions 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, and 1.19.4.

What IDEs can receive generated run configurations?

The setup guide provides commands for Eclipse, IntelliJ IDEA, and Visual Studio Code.

What license does the repository use?

The ForgeGradle GitHub repository identifies its license as LGPL-2.1.

What the maker publishes

Audience
The documentation describes setting up a development environment for Minecraft mod development. source
Bundled dependencies
The optional Jar-in-Jar system bundles selected dependencies inside a mod JAR and writes metadata during the build. source
Compatibility limit
The documented default stable and snapshot mapping sets are typically incomplete and are no longer available as of Minecraft 1.17. source
Dependency support
Mod dependencies can be added through repositories or a local flat directory, and are wrapped with fg.deobf before use. source
Distribution
The docs show adding the MinecraftForge Maven repository and the net.minecraftforge.gradle plugin to a Gradle build. source
Documentation scope
The ForgeGradle documentation says it covers ForgeGradle and is not a Java, Groovy, or Gradle tutorial. source
Forge run types
Forge provides client, server, data, and gameTestServer run configurations. source
IDE support
The guide provides commands to generate run configurations for Eclipse, IntelliJ IDEA, and Visual Studio Code. source
License
The ForgeGradle GitHub repository identifies its license as LGPL-2.1. source
Mappings
ForgeGradle lets users choose a human-readable mapping set and converts the mod JAR to SRG mappings for production with a reobf task. source
Prerequisite
The setup guide requires a Java Development Kit and familiarity with an integrated development environment. source
Purpose
ForgeGradle is a Gradle plugin and Minecraft mod development framework used by Forge and FML. source
Run configurations
ForgeGradle run configurations can set arguments, working directories, task names, environment properties, and system properties. source

Checked against the maker's pages on 4 Oct 2026.