CurseForge Gradle Publish Plugin

What CurseForge Gradle Publish Plugin is

CurseForge Gradle Publish Plugin is a free tool for publishing build artifacts to CurseForge from a Gradle project. Each publication can be configured with a CurseForge project ID, the main artifact, supported game versions, display name, release type, changelog, and artifact relations. Publishing uses the CurseForge Upload API and requires an API token set through the plugin’s curseforge extension.

The plugin can derive some publication details from mod development tools. When it detects Fabric Loom and a remapJar or jar bundling task, it can create a publication preconfigured with the Fabric loader and targeted Minecraft version. Its documented integrations with ModDevGradle and NeoGradle can infer NeoForge loader and Minecraft-version information. If Gradle’s java-base plugin is present, the plugin can infer the supported Java version from the compileJava target.

Compatibility requirements depend on the plugin and build tool versions. The 0.9.0 release notes require Java 21 or later and Gradle 9.0.0 or later; the repository compatibility table also gives Gradle 9.0.0 as the minimum for plugin 0.9.0. Those release notes warn that older versions of supported modding tools may not be detected automatically and can require manual configuration. ForgeGradle integration was removed because it is incompatible with Gradle 9. The repository includes an MIT License. The plugin supports Windows and macOS, and the Gradle Plugin Portal lists version 0.11.0 as the latest version with Gradle configuration cache compatibility marked.

Who it suits

This plugin suits Minecraft mod developers who build with Gradle and want to publish artifacts to CurseForge. It is useful for projects using Fabric Loom, ModDevGradle, or NeoGradle, where some publication details can be inferred from the build setup.

Limits

The 0.9.0 release requires Java 21 or later and Gradle 9.0.0 or later. Older supported modding tools may need manual configuration, and ForgeGradle integration was removed.

Getting started

1. Open the project repository on GitHub.
2. Add the plugin to your Gradle build.
3. Configure a CurseForge project ID and publication details through the plugin’s curseforge extension.
4. Provide a CurseForge API token using user-specific Gradle properties rather than hardcoding it in a version-controlled build script.
5. Run the Gradle publication task to upload the configured artifact through the CurseForge Upload API.

Verdict

Choose this plugin if you publish Gradle-built mod artifacts to CurseForge and use a supported Fabric or NeoForge setup. Check the Java, Gradle, and modding-tool requirements first; ForgeGradle integration is not available.