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

Mod Publish Plugin

github.com

  • Free plan
  • Self-hosted
6.8 Club score Visit github.com

What Mod Publish Plugin is

Mod Publish Plugin is a free Gradle plugin for publishing Minecraft mods to several destinations from one build. Its typesafe DSL configures multiple locations with little repeated setup; after configuration, run the Gradle publishMods task. Supported destinations include CurseForge, Modrinth, GitHub, Gitea, GitLab, Forgejo, Codeberg and Discord. The plugin is independent of mod loader and supports Groovy build scripts, with listed loaders including Fabric and Forge. Failed publishing attempts are retried, and the common maxRetries setting defaults to 3 but can be changed. Dry-run mode saves release assets to the build directory for checking. Platform access tokens can be supplied through environment variables in the documented examples. CurseForge publishing requires at least one supported environment: client, server or both. The project describes its API as stable, prioritizes backward compatibility and uses major version bumps for breaking changes. It is self-hosted, installed through the Gradle Plugin Portal, and version 2.0.0 requires Gradle 9.0.0 or newer.

Who it suits

This plugin suits Minecraft mod developers publishing releases to several services from Gradle. It is useful for Fabric or Forge projects using Groovy or other Gradle build scripts.

Good to know, and what to watch

  • Publishes to eight listed destinations
  • Typesafe DSL reduces repeated configuration
  • Retries failed publishing attempts
  • Dry runs save release assets
  • Stable API emphasizes compatibility
  • Version 2.0.0 requires Gradle 9.0.0
  • CurseForge needs a supported environment
  • Self-hosted setup is required
  • No paid plans or usage limits stated

Mod Publish Plugin

Free

Free plan

The verdict

Mod Publish Plugin centralizes Minecraft mod publishing in a Gradle workflow with retries and dry-run support. Its broad destination list is balanced by the Gradle version requirement and CurseForge configuration condition.

What the maker publishes

API stability
The project says its API is stable, backwards compatibility is a high priority, and breaking changes are indicated by a major version bump. source
Authentication
Platform access tokens can be provided through environment variables in the documented configuration examples. source
Compatibility
The plugin is mod loader independent, and Groovy build scripts are fully supported. source
Configuration
A typesafe DSL lets users configure publishing to multiple locations with minimal repetition. source
CurseForge requirement
CurseForge publishing requires at least one supported environment to be set: client, server, or both. source
Destinations
It supports publishing to CurseForge, Modrinth, GitHub, Gitea, GitLab, Forgejo, Codeberg, and Discord. source
Dry run
Dry run mode saves release assets to the build directory for testing. source
Installation
The plugin is hosted on the Gradle Plugin Portal and is added through a Gradle plugins block. source
Notable version requirement
Version 2.0.0 raised the minimum supported Gradle version to 9.0.0. source
Publishing workflow
After configuring destinations, users run the Gradle `publishMods` task to publish to them. source
Purpose
It is a Gradle plugin for publishing Minecraft mods to a range of destinations. source
Reliability
The plugin retries on failure. source
Retries setting
The common `maxRetries` option defaults to 3 and can be configured. source
Support
The documentation directs users with questions to the Mod Publish Plugin Discord channel on the Team Reborn Discord. source

Checked against the maker's pages on 8 Oct 2026.