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.
Plans
Every plan and priceForgeGradle
Free plan
Getting started
- Install a Java Development Kit
- Prepare an integrated development environment
- Add the MinecraftForge Maven repository to your Gradle build
- Apply the net.minecraftforge.gradle plugin
- Generate run configurations for Eclipse, IntelliJ IDEA, or Visual Studio Code
- 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.