Mod Publish Plugin

What Mod Publish Plugin is

Mod Publish Plugin is a free Gradle plugin for publishing Minecraft mods to services including CurseForge, Modrinth, GitHub, Gitea, GitLab, Forgejo, Codeberg, and Discord. Its typesafe DSL lets a project configure several destinations without repeating as much setup. Once those destinations are configured, users run the Gradle `publishMods` task to send releases. The plugin retries failed attempts; the shared `maxRetries` setting starts at 3 and can be changed. Dry-run mode saves release assets in the build directory so they can be checked without publishing. It supports Groovy build scripts and does not depend on a particular mod loader; Fabric and Forge are listed as supported loaders. CurseForge publishing requires at least one of the client or server environments to be enabled. Access tokens can be provided through environment variables in the documented examples. The project describes its API as stable and prioritizes backward compatibility, with breaking changes marked by a major version increase. It is self-hosted, distributed through the Gradle Plugin Portal, and version 2.0.0 raised the minimum Gradle version to 9.0.0.

Who it suits

It suits Minecraft mod developers who publish releases to multiple destinations through Gradle and want to configure those destinations in build scripts. Users of version 2.0.0 or later need Gradle 9.0.0 or newer.

Getting started

1. Open the project on GitHub or the Gradle Plugin Portal
2. Add the plugin through a Gradle plugins block
3. Configure one or more destinations with the typesafe DSL
4. Provide platform access tokens through environment variables
5. Enable a CurseForge client or server environment when publishing there
6. Run the Gradle publishMods task

Verdict

Mod Publish Plugin brings multi-destination Minecraft mod publishing into a Gradle task, with dry runs and retry configuration. Check the Gradle requirement and configure a supported environment for CurseForge before relying on those destinations.