Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

CurseForgeGradle

github.com

  • Free plan
  • API
7.0 Club score Visit github.com

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

CurseForgeGradle

Free

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.