CurseForgeGradle
github.com
- Free plan
- API
What CurseForgeGradle is
CurseForgeGradle is a free, open-source Gradle plugin for publishing build artifacts to CurseForge. It uploads through CurseForge’s official API and can send files to multiple CurseForge projects in one process. The project says it supports all games on CurseForge, while automatic game-version detection focuses on Minecraft and can be disabled. With the relevant Gradle plugins present, it detects Forge, Fabric, Quilt, and NeoForge; Rift is also listed as supported. Task-based publishing lets a build configure changelogs, release types, game versions, mod loaders, environments, display names, Java versions, client or server tags, and project relationships. An API token is required, and the README recommends keeping it in an environment variable or build secret. Uploads default to alpha and are not held for manual release unless configured. The default endpoint is the legacy CurseForge API. Version 1.3.33 is listed on the Gradle Plugin Portal.
Who it suits
CurseForgeGradle suits developers using Gradle projects to publish artifacts, especially Java-based projects and Minecraft mod builds. It is also useful when publishing to several CurseForge projects or configuring detailed release metadata.
Good to know, and what to watch
- Free and open source
- Official CurseForge upload API
- Multiple-project publishing
- Automatic loader detection
- Task-based release configuration
- API token required
- Alpha is the default release type
- Legacy API endpoint by default
- Manual release requires configuration
Plans
Every plan and priceCurseForgeGradle
Open source
The verdict
CurseForgeGradle provides task-driven CurseForge publishing with broad metadata and loader support. Teams should secure the required token and review default release handling before automating uploads.
What the maker publishes
- API endpoint
- The default API endpoint is the legacy CurseForge API, which the project says supports all games on CurseForge. source
- 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. source
- Compatibility
- The README lists automatic loader detection for Forge, Fabric, Quilt, and NeoForge Gradle plugins. source
- Dependencies
- Files can be marked with incompatibility, requirement, embedded, tool, optional, or other project relationships. source
- Distribution
- The plugin is hosted on the Gradle Plugin Portal; its listed latest version is 1.3.33. source
- Distribution
- The plugin is hosted on the Gradle Plugin Portal and can be applied through the Gradle plugins DSL. source
- File metadata
- Upload metadata can include changelogs, display names, game versions, mod loaders, Java versions, and client or server environment tags. source
- Game coverage
- The project says it supports all games on CurseForge. source
- Game coverage
- The plugin supports all games on CurseForge. source
- Intended users
- The README demonstrates configuring the plugin in a Java based Gradle project to upload its main JAR. source
- Latest version
- The Gradle Plugin Portal lists version 1.3.33 as the latest version, created July 1, 2026. source
- Manual release
- An upload can be held for manual release after CurseForge approves it. source
- Mod loader integrations
- It detects Forge, Fabric, Quilt, and NeoForge when their listed Gradle plugins are present. source
- Multiple projects
- It can upload to multiple CurseForge projects at once. source
- Multiple projects
- A single configuration can upload to multiple CurseForge projects at once. source
- Publishing configuration
- Its task based publishing supports configuring changelogs, release types, game versions, mod loaders, environments, and project relations. source
- Publishing tasks
- Task based publishing supports advanced scripting and configuration. source
- Purpose
- CurseForgeGradle is a Gradle plugin for publishing build artifacts to CurseForge. source
- Purpose
- CurseForgeGradle is a Gradle plugin that publishes build artifacts to CurseForge. source
- Release default
- The release type defaults to alpha, and files are not held for manual release by default. source
- Release settings
- Uploads can be configured as alpha, beta, or release, with alpha as the default. source
- Security guidance
- The README says the CurseForge API token is like a password and advises storing it in an environment variable or build secret. source
- Upload API
- It uploads directly to CurseForge using the official upload API. source
- Upload API
- The plugin uploads directly to CurseForge using its official upload API. source
Checked against the maker's pages on 9 Oct 2026.