Skip to content
SPECIFICTION
Get listed

CurseForge Gradle Publish Plugin

github.com

Free plan WindowsmacOSAPI
Visit github.com
Spec score 8.0 #11 of 35 in Minecraft Mod Development Tools

What it is

CurseForge Gradle Publish Plugin publishes build artifacts to CurseForge from a Gradle build. A publication can specify a CurseForge project ID, main artifact, game versions, display name, release type, changelog, and artifact relationships. It uses the CurseForge Upload API and needs an API token in the plugin’s curseforge extension. The README warns that keeping the token in a version-controlled build script can expose it; user-specific Gradle properties are suggested instead.

For mod projects, the plugin can derive publication details from other tools. With Fabric Loom and a remapJar or jar bundling task, it can create a publication preconfigured for Fabric and the targeted Minecraft version. Its ModDevGradle and NeoGradle integrations can infer NeoForge and Minecraft-version details. When Gradle’s java-base plugin is present, it infers the Java version from the compileJava target.

The plugin is free, with an MIT license. Release 0.9.0 requires Java 21 or later and Gradle 9.0.0 or later. That release removed ForgeGradle integration because it is incompatible with Gradle 9.

Spec sheet

Purpose
A Gradle plugin for publishing build artifacts to CurseForge.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
Authentication
Publishing uses the CurseForge Upload API and requires an API token configured through the plugin's curseforge extension.Read 7 Oct 2026 · github.com
Current version listing
The Gradle Plugin Portal lists version 0.11.0 as latest and marks Gradle configuration cache compatibility with a check.Read 7 Oct 2026 · plugins.gradle.org
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
Java version inference
When Gradle's java-base plugin is detected, the plugin automatically infers the supported Java version from the compileJava target.Read 7 Oct 2026 · github.com
NeoForge integrations
The plugin documents integrations with ModDevGradle and NeoGradle that can infer NeoForge loader and Minecraft-version information for publications.Read 7 Oct 2026 · github.com
Publication configuration
Publications can configure a CurseForge project ID, main artifact, game versions, display name, release type, changelog, and artifact relations.Read 7 Oct 2026 · github.com
Publisher
The repository license copyright notice names Leon Linhart.Read 7 Oct 2026 · github.com
Removed integration
The 0.9.0 release notes say ForgeGradle integration was removed because it is incompatible with Gradle 9.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com

Plans and prices

CurseForge Gradle Publish Plugin Free MIT-licensed software Read 7 Oct 2026 · github.com

Every CurseForge Gradle Publish Plugin plan and price →

Strong points and limits

Strong points

  • Publication fields include changelog and artifact relations.
  • Can infer Fabric publication details from Loom tasks.
  • ModDevGradle and NeoGradle integration can infer loader details.
  • Java version can be inferred from compileJava target.

Limits

  • Release 0.9.0 requires Java 21 or later.
  • Release 0.9.0 requires Gradle 9.0.0 or later.
  • ForgeGradle integration was removed.
  • Older mod-tool versions may need manual configuration.

Who it suits

It suits developers publishing mod artifacts to CurseForge from Gradle projects, especially those using Fabric or NeoForge integrations. Teams should be prepared to configure an API token and check their Java, Gradle, and mod-tool versions.

Verdict

This is a focused publishing plugin with publication settings and mod-tool integrations that can reduce manual configuration. Check the Java and Gradle requirements and secure the API token outside version-controlled build scripts.

Where Specifiction places it

Alternatives to CurseForge Gradle Publish PluginAll alternatives →