CurseForge Gradle Publish Plugin
github.com
- Free plan
- Windows
- macOS
- API
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.
Plans
Every plan and priceCurseForge Gradle Publish Plugin
Free plan
Getting started
- Open the project repository on GitHub.
- Add the plugin to the Gradle project.
- Configure a CurseForge project ID and publication details in the curseforge extension.
- Provide the CurseForge Upload API token through user-specific Gradle properties rather than a version-controlled build script.
- 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.