CurseForgeGradle
CurseForgeGradle is a free, open-source Gradle plugin for publishing build artifacts to CurseForge.
What CurseForgeGradle is
CurseForgeGradle is a free, open-source Gradle plugin for publishing build artifacts to CurseForge. It uploads through CurseForge’s official upload API and can send files to multiple CurseForge projects at once. The project says it supports all games on CurseForge. Its automatic game-version detection focuses on Minecraft and can be disabled; when the relevant Gradle plugins are present, it detects Forge, Fabric, Quilt, and NeoForge. Rift is also listed as a supported loader. Publishing uses configurable tasks, with settings for release type, changelog, game versions, loaders, environments, file metadata, and relationships to other projects. Uploads can be marked alpha, beta, or release, with alpha as the default. Files are not held for manual release by default, though an upload can be configured for manual release after CurseForge approval. An API token is required, and the project advises storing it in an environment variable or build secret. The default endpoint is the legacy CurseForge API, which the project says supports all games on CurseForge. The plugin is hosted on the Gradle Plugin Portal; version 1.3.33 is listed as latest.
Good
- Free and open source.
- Uploads through CurseForge’s official API.
- Can publish to multiple projects at once.
- Configurable release metadata and project relationships.
- Detects several mod loaders from Gradle plugins.
Watch out
- Requires a CurseForge API token.
- Release type defaults to alpha.
- Manual release is not enabled by default.
Who it suits
CurseForgeGradle is for developers using Gradle who want to publish build artifacts to CurseForge, including from Java-based projects. It is particularly relevant to Minecraft projects using supported mod-loader plugins.
Verdict
CurseForgeGradle provides configurable publishing tasks for Gradle projects targeting CurseForge. Developers should secure the required API token and review the default alpha release setting before publishing.
Plans and prices
From CurseForgeGradle's own pricing page, checked 9 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| CurseForgeGradle | Free | Gradle plugin for publishing build artifacts to CurseForge · supports all games on CurseForge |
The facts
Each one read from CurseForgeGradle's own pages, with the date it was checked.
What it does
- API endpoint
- The default API endpoint is the legacy CurseForge API, which the project says supports all games on CurseForge.checked 4 Oct 2026
- Authentication
- An API token is required, and the README advises storing it in an environment variable or build secret rather than sharing it with a third party.checked 4 Oct 2026
- Compatibility
- The README lists automatic loader detection for Forge, Fabric, Quilt, and NeoForge Gradle plugins.checked 9 Oct 2026
- Dependencies
- Files can be marked with incompatibility, requirement, embedded, tool, optional, or other project relationships.checked 9 Oct 2026
- Distribution
- The plugin is hosted on the Gradle Plugin Portal and can be applied through the Gradle plugins DSL.checked 9 Oct 2026
- File metadata
- Upload metadata can include changelogs, display names, game versions, mod loaders, Java versions, and client or server environment tags.checked 9 Oct 2026
- Game coverage
- The plugin supports all games on CurseForge.checked 9 Oct 2026
- Intended users
- The README demonstrates configuring the plugin in a Java based Gradle project to upload its main JAR.checked 4 Oct 2026
- Latest version
- The Gradle Plugin Portal lists version 1.3.33 as the latest version, created July 1, 2026.checked 9 Oct 2026
- Manual release
- An upload can be held for manual release after CurseForge approves it.checked 9 Oct 2026
- Mod loader integrations
- It detects Forge, Fabric, Quilt, and NeoForge when their listed Gradle plugins are present.checked 4 Oct 2026
- Multiple projects
- A single configuration can upload to multiple CurseForge projects at once.checked 9 Oct 2026
- Publishing configuration
- Its task based publishing supports configuring changelogs, release types, game versions, mod loaders, environments, and project relations.checked 4 Oct 2026
- Publishing tasks
- Task based publishing supports advanced scripting and configuration.checked 9 Oct 2026
- Purpose
- CurseForgeGradle is a Gradle plugin that publishes build artifacts to CurseForge.checked 9 Oct 2026
- Release default
- The release type defaults to alpha, and files are not held for manual release by default.checked 4 Oct 2026
- Release settings
- Uploads can be configured as alpha, beta, or release, with alpha as the default.checked 9 Oct 2026
- Security guidance
- The README says the CurseForge API token is like a password and advises storing it in an environment variable or build secret.checked 9 Oct 2026
- Upload API
- The plugin uploads directly to CurseForge using its official upload API.checked 9 Oct 2026
- Version detection
- It can automatically detect Minecraft game versions and mod loaders from the build environment.checked 9 Oct 2026
Alternatives to CurseForgeGradle
- 1
Blockbench
Free planOpen sourceAndroidiOSWebAPI8.1Free plan - 2
IntelliJ IDEA
Free planAPIExtensionLinuxmacOS7.8Free plan - 3
Visual Studio Code
Free planWebLinuxmacOSWindows7.4Free plan - 4
Fabric
Free planAPILinuxmacOSSelf-hosted6.8Free plan - 5
Minecraft Development MCP Server
Free planAPILinuxmacOSSelf-hosted6.6Free plan - 6
Quilt Loom
Free planLinuxmacOSWindows6.6Free plan