FREEDOM251

Freedom251 › Minecraft Mod Development Tools

CurseForgeGradle

Free plan API

Visit CurseForgeGradle Alternatives Pricing

CurseForgeGradle's own site

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 projects in one go. The project says it supports every game on CurseForge; automatic game-version detection is focused on Minecraft and can be disabled. When the corresponding Gradle plugins are present, it detects Forge, Fabric, Quilt, and NeoForge. Publishing tasks let developers configure release types, changelogs, game versions, loaders, environments, file metadata, and relationships to other projects. Supported metadata includes Java versions and client or server environment tags, while project relationships can mark dependencies, incompatibilities, embedded files, and optional items. Releases can be alpha, beta, or release, with alpha as the default; uploads are not held for manual release unless configured. An API token is required, and the project advises 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 example configures a Java-based Gradle project to upload its main JAR.

Who it suits

It suits developers who use Gradle to publish game-related build artifacts to CurseForge. Its task-based configuration and loader detection are relevant to Minecraft projects, while the project says it supports all CurseForge games.

What it does well

  • Uploads directly through CurseForge’s official API
  • Can publish to multiple projects at once
  • Detects Forge, Fabric, Quilt, and NeoForge plugins
  • Supports configurable metadata and project relationships
  • Version detection can be disabled

What to know first

  • Requires a CurseForge API token
  • Alpha is the default release type
  • Files are not held for manual release by default

Limits

The plugin is free. Uploads default to alpha, and files are not held for manual release unless that behavior is configured.

Plans

PlanBilled and limitsPrice
CurseForgeGradleGradle plugin for publishing build artifacts to CurseForge · supports all games on CurseForgeFree

As github.com lists them, read 9 Oct 2026. The maker's own page has the final word.

Getting started

  1. Open the project on GitHub.
  2. Add the plugin from the Gradle Plugin Portal to a Gradle project.
  3. Store a CurseForge API token in an environment variable or build secret.
  4. Configure publishing tasks, project details, and release settings.
  5. Run the configured task to upload a build artifact.

Verdict

CurseForgeGradle provides task-based publishing with configurable release details and project relationships. Developers should review the alpha default and token-handling guidance before configuring uploads.

Questions

How much does CurseForgeGradle cost?

The listed plan is free. The project describes the plugin as open source.

Which games and mod loaders does it support?

The project says it supports all games on CurseForge. It detects Forge, Fabric, Quilt, and NeoForge when their Gradle plugins are present; Rift is also listed as supported.

Does it support Minecraft version detection?

Yes. It can detect Minecraft game versions from the build environment, and that detection can be disabled.

What do I need to authenticate uploads?

An API token is required. The project advises storing it in an environment variable or build secret.

Can an upload be held for manual release?

Yes. An upload can be configured to wait for manual release after CurseForge approves it. Files are not held this way by default.

Facts from CurseForgeGradle's own pages

API endpoint
The default API endpoint is the legacy CurseForge API, which the project says supports all games on CurseForge. · github.com, 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, 4 Oct 2026
Compatibility
The README lists automatic loader detection for Forge, Fabric, Quilt, and NeoForge Gradle plugins. · github.com, 9 Oct 2026
Dependencies
Files can be marked with incompatibility, requirement, embedded, tool, optional, or other project relationships. · github.com, 9 Oct 2026
Distribution
The plugin is hosted on the Gradle Plugin Portal and can be applied through the Gradle plugins DSL. · github.com, 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, 9 Oct 2026
Game coverage
The plugin supports all games on CurseForge. · github.com, 9 Oct 2026
Intended users
The README demonstrates configuring the plugin in a Java based Gradle project to upload its main JAR. · github.com, 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, 9 Oct 2026
Manual release
An upload can be held for manual release after CurseForge approves it. · github.com, 9 Oct 2026
Mod loader integrations
It detects Forge, Fabric, Quilt, and NeoForge when their listed Gradle plugins are present. · github.com, 4 Oct 2026
Multiple projects
A single configuration can upload to multiple CurseForge projects at once. · github.com, 9 Oct 2026
Publishing configuration
Its task based publishing supports configuring changelogs, release types, game versions, mod loaders, environments, and project relations. · github.com, 4 Oct 2026
Publishing tasks
Task based publishing supports advanced scripting and configuration. · github.com, 9 Oct 2026
Purpose
CurseForgeGradle is a Gradle plugin that publishes build artifacts to CurseForge. · github.com, 9 Oct 2026
Release default
The release type defaults to alpha, and files are not held for manual release by default. · github.com, 4 Oct 2026
Release settings
Uploads can be configured as alpha, beta, or release, with alpha as the default. · github.com, 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, 9 Oct 2026
Upload API
The plugin uploads directly to CurseForge using its official upload API. · github.com, 9 Oct 2026
Version detection
It can automatically detect Minecraft game versions and mod loaders from the build environment. · github.com, 9 Oct 2026

Where CurseForgeGradle stands on Freedom251

Look at these too