- Home
- Minecraft Mod Development Tools
- CurseForgeGradle
CurseForgeGradle
What it 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 version detection identifies Minecraft versions 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 is configured through tasks, with options for release type, changelog, game versions, loaders, environments, file metadata, and relationships to other projects. Uploads can be set as alpha, beta, or release, and alpha is the default. Files are not held for manual release by default, though an upload can be held after CurseForge approves it. An API token is required, and the project recommends keeping it in an environment variable or build secret. The default endpoint is the legacy CurseForge API. The plugin is hosted on the Gradle Plugin Portal, where version 1.3.33 is listed as latest. Its README demonstrates a Java-based Gradle project uploading its main JAR.
For and against
For
- Free and open source
- Uploads to multiple CurseForge projects
- Supports all games on CurseForge
- Detects several mod loaders from Gradle plugins
- Publishing tasks configure release metadata
Against
- Requires a CurseForge API token
- Release type defaults to alpha
- Files are not held for manual release by default
The verdict
CurseForgeGradle provides task-based publishing for Gradle projects, with options for metadata, loaders, and project relationships. Users need to manage an API token and review the alpha default before publishing.
Who it suits
It may suit Java developers who use Gradle to publish build artifacts to CurseForge. Its task-based configuration supports projects that need to set upload metadata or publish to multiple projects.
Plans and prices
CurseForgeGradle
Gradle plugin for publishing build artifacts to CurseForge · supports all games on CurseForge
Read 9 Oct 2026 · github.com
On the record
- API endpoint
- The default API endpoint is the legacy CurseForge API, which the project says supports all games on CurseForge.github.com · read 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.github.com · read 4 Oct 2026
- Compatibility
- The README lists automatic loader detection for Forge, Fabric, Quilt, and NeoForge Gradle plugins.github.com · read 9 Oct 2026
- Dependencies
- Files can be marked with incompatibility, requirement, embedded, tool, optional, or other project relationships.github.com · read 9 Oct 2026
- Distribution
- The plugin is hosted on the Gradle Plugin Portal and can be applied through the Gradle plugins DSL.github.com · read 9 Oct 2026
- File metadata
- Upload metadata can include changelogs, display names, game versions, mod loaders, Java versions, and client or server environment tags.github.com · read 9 Oct 2026
- Game coverage
- The plugin supports all games on CurseForge.github.com · read 9 Oct 2026
- Intended users
- The README demonstrates configuring the plugin in a Java based Gradle project to upload its main JAR.github.com · read 4 Oct 2026
- Latest version
- The Gradle Plugin Portal lists version 1.3.33 as the latest version, created July 1, 2026.plugins.gradle.org · read 9 Oct 2026
- Manual release
- An upload can be held for manual release after CurseForge approves it.github.com · read 9 Oct 2026
- Mod loader integrations
- It detects Forge, Fabric, Quilt, and NeoForge when their listed Gradle plugins are present.github.com · read 4 Oct 2026
- Multiple projects
- A single configuration can upload to multiple CurseForge projects at once.github.com · read 9 Oct 2026
- Publishing configuration
- Its task based publishing supports configuring changelogs, release types, game versions, mod loaders, environments, and project relations.github.com · read 4 Oct 2026
- Publishing tasks
- Task based publishing supports advanced scripting and configuration.github.com · read 9 Oct 2026
- Purpose
- CurseForgeGradle is a Gradle plugin that publishes build artifacts to CurseForge.github.com · read 9 Oct 2026
- Release default
- The release type defaults to alpha, and files are not held for manual release by default.github.com · read 4 Oct 2026
- Release settings
- Uploads can be configured as alpha, beta, or release, with alpha as the default.github.com · read 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.github.com · read 9 Oct 2026
