- Home
- Minecraft Mod Development Tools
- CurseForge Gradle Publish Plugin
CurseForge Gradle Publish Plugin
What it is
CurseForge Gradle Publish Plugin is a free Gradle plugin for publishing build artifacts to CurseForge. A publication can specify a CurseForge project ID, main artifact, game versions, display name, release type, changelog, and artifact relationships. Publishing uses the CurseForge Upload API and requires a token configured in the plugin’s curseforge extension. The README warns against placing that token in a version-controlled build script, suggesting user-specific Gradle properties instead. With Fabric Loom and a remapJar or jar bundling task detected, the plugin can create a publication preconfigured with the Fabric loader and targeted Minecraft version. Documented ModDevGradle and NeoGradle integrations can infer NeoForge and Minecraft-version details. When Gradle’s java-base plugin is present, the Java version can be inferred from the compileJava target. Compatibility requirements depend on the plugin version: the repository lists Gradle 9.0.0 as the minimum for version 0.9.0, whose release notes also require Java 21 or later. Those notes warn that older supported modding tools may need manual configuration and say ForgeGradle support was removed because it is incompatible with Gradle 9. The repository includes an MIT License.
For and against
For
- Free software under the MIT License
- Configurable publication details and artifact relationships
- Fabric and NeoForge tool integrations are documented
- Can infer Java version from compileJava target
Against
- Version 0.9.0 requires Java 21 or later
- Version 0.9.0 requires Gradle 9.0.0 or later
- Older modding tools may need manual configuration
- ForgeGradle integration was removed
The verdict
The plugin supports publishing configured artifacts to CurseForge and can derive some publication details from supported modding tools. Confirm compatibility and keep the API token out of version-controlled build scripts.
Who it suits
This plugin suits developers who publish build artifacts to CurseForge from Gradle projects, especially those using Fabric or NeoForge tooling. It is relevant to teams that can meet the stated Java and Gradle requirements and configure an API token securely.
Plans and prices
CurseForge Gradle Publish Plugin
MIT-licensed software
Read 7 Oct 2026 · github.com
On the record
- Authentication
- Publishing uses the CurseForge Upload API and requires an API token configured through the plugin's curseforge extension.github.com · read 7 Oct 2026
- Current version listing
- The Gradle Plugin Portal lists version 0.11.0 as latest and marks Gradle configuration cache compatibility with a check.plugins.gradle.org · read 7 Oct 2026
- Fabric integration
- When Fabric Loom and a remapJar or jar bundling task are detected, the plugin can create a publication preconfigured with the Fabric loader and targeted Minecraft version.github.com · read 7 Oct 2026
- Gradle compatibility
- The repository compatibility table lists Gradle 9.0.0 as the minimum for plugin 0.9.0, and says unlisted maximum Gradle versions are assumed to work with the latest Gradle version.github.com · read 7 Oct 2026
- Java version inference
- When Gradle's java-base plugin is detected, the plugin automatically infers the supported Java version from the compileJava target.github.com · read 7 Oct 2026
- License
- The repository includes the MIT License, which grants permission to use, copy, modify, merge, publish, distribute, sublicense, and sell the software subject to its terms.github.com · read 7 Oct 2026
- NeoForge integrations
- The plugin documents integrations with ModDevGradle and NeoGradle that can infer NeoForge loader and Minecraft-version information for publications.github.com · read 7 Oct 2026
- Publication configuration
- Publications can configure a CurseForge project ID, main artifact, game versions, display name, release type, changelog, and artifact relations.github.com · read 7 Oct 2026
- Publisher
- The repository license copyright notice names Leon Linhart.github.com · read 7 Oct 2026
- Purpose
- A Gradle plugin for publishing build artifacts to CurseForge.github.com · read 7 Oct 2026
- Removed integration
- The 0.9.0 release notes say ForgeGradle integration was removed because it is incompatible with Gradle 9.github.com · read 7 Oct 2026
- Token handling
- The README warns that hardcoding an API token in a version-controlled build script can expose it and suggests using user-specific Gradle properties.github.com · read 7 Oct 2026
- Toolchain limitation
- The 0.9.0 release notes say it requires Java 21 or later and Gradle 9.0.0 or later, and warn that older versions of supported modding tools may fail auto-detection and need manual configuration.github.com · read 7 Oct 2026
