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

CurseForge Gradle Publish Plugin

github.com

  • Free plan
  • Windows
  • macOS
  • API
7.1 Club score Visit github.com

What CurseForge Gradle Publish Plugin is

CurseForge Gradle Publish Plugin is a free Gradle plugin for publishing build artifacts to CurseForge. A publication can specify a project ID, main artifact, game versions, display name, release type, changelog, and artifact relations. Publishing uses the CurseForge Upload API and requires an API token configured through the plugin's curseforge extension. If Fabric Loom and a remapJar or jar bundling task are detected, the plugin can preconfigure a publication with the Fabric loader and targeted Minecraft version. Documented ModDevGradle and NeoGradle integrations can infer NeoForge loader and Minecraft-version details. When Gradle's java-base plugin is detected, the plugin infers the supported Java version from the compileJava target. Compatibility requirements depend on the version: the 0.9.0 release notes require Java 21 or later and Gradle 9.0.0 or later. Those notes say older supported modding tools may require manual configuration, and that ForgeGradle integration was removed because it does not work with Gradle 9. The repository includes an MIT License.

Who it suits

It suits developers who use Gradle to publish CurseForge artifacts, particularly with the documented Fabric or NeoForge tooling. Users should check their Java, Gradle, and modding tool versions before relying on automatic configuration.

Good to know, and what to watch

  • Publications can include changelogs and artifact relations.
  • Fabric Loom can preconfigure publication details.
  • ModDevGradle and NeoGradle integrations infer version details.
  • Java version can be inferred from compileJava.
  • The repository includes an MIT License.
  • Publishing requires a CurseForge API token.
  • The 0.9.0 release requires Java 21 or later.
  • The 0.9.0 release requires Gradle 9.0.0 or later.
  • ForgeGradle integration was removed.

CurseForge Gradle Publish Plugin

Free

Free plan

Getting started

  1. Open the project repository on GitHub.
  2. Add the plugin to the Gradle project.
  3. Configure a CurseForge project ID and publication details in the curseforge extension.
  4. Provide the CurseForge Upload API token through user-specific Gradle properties rather than a version-controlled build script.
  5. Check the required Java, Gradle, and modding-tool versions for your setup.

Limits to check

The 0.9.0 release notes require Java 21 or later and Gradle 9.0.0 or later. Older versions of supported modding tools may not be detected automatically and may need manual configuration.

The verdict

The plugin can reduce repeated publication setup for supported Gradle modding workflows. Version requirements, API-token handling, and the removed ForgeGradle integration are important constraints to check.

Questions people ask

How much does the plugin cost?

It is listed as free and includes an MIT License.

What is needed to publish?

Publishing uses the CurseForge Upload API and requires an API token configured through the plugin’s curseforge extension.

Which mod loaders are supported?

Supported loaders listed are Fabric and NeoForge. The documented integrations include Fabric Loom, ModDevGradle, and NeoGradle.

What Java and Gradle versions are required?

The 0.9.0 release notes require Java 21 or later and Gradle 9.0.0 or later. The compatibility table also gives Gradle 9.0.0 as the minimum for plugin 0.9.0.

Does it integrate with ForgeGradle?

No. The 0.9.0 release notes say ForgeGradle integration was removed because it is incompatible with Gradle 9.

How should I protect the API token?

The README warns that a token hardcoded in a version-controlled build script can be exposed and suggests user-specific Gradle properties.

What the maker publishes

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

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