Mod Publish Plugin
github.com
- Free plan
- Self-hosted
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
Plans
Every plan and priceMod Publish Plugin
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.