Minotaur

What it does

Additional files

The plugin supports uploading additional files alongside a version.checked 10 Oct 2026

API configuration

The API endpoint is configurable and defaults to `https://api.modrinth.com/v2`.checked 4 Oct 2026

Authentication

Publishing requires a Modrinth personal access token with CREATE_VERSION scope, and body syncing requires PROJECT_WRITE scope.checked 10 Oct 2026

Automatic detection

Game versions and loaders can usually be detected automatically when using ForgeGradle and Fabric Loom.checked 10 Oct 2026

Build scripts

The README shows usage with both Groovy and Kotlin Gradle DSLs.checked 4 Oct 2026

Build script support

The README shows setup examples for both Groovy and Kotlin Gradle DSLs.checked 10 Oct 2026

Current release

The Gradle Plugin Portal lists version 2.10.0 as the latest version, created September 16, 2026.checked 4 Oct 2026

Destructive limitation

The README warns that after a project body is changed through syncing, it cannot be recovered.checked 4 Oct 2026

Dry run

Its debugMode option prints upload data without actually uploading the version.checked 10 Oct 2026

Integration

Minotaur uses the Modrinth API and documents ForgeGradle and Fabric Loom detection; its API endpoint defaults to https://api.modrinth.com/v2.checked 10 Oct 2026

Intended users

Modrinth describes Minotaur as a way for creators to integrate their build tools and automatically upload new versions when they release them.checked 4 Oct 2026

License

The repository lists the GNU LGPL-2.1 license.checked 10 Oct 2026

Notable limit

The README warns that once a synced project body is changed, it cannot be restored through the task.checked 10 Oct 2026

Project body sync

The `modrinthSyncBody` task can sync text such as a project's README to its Modrinth project body.checked 4 Oct 2026

Project description sync

The separate `modrinthSyncBody` task can sync text such as a README.md to a Modrinth project body, with marked comment sections excluded.checked 10 Oct 2026

Publishing

The `modrinth` Gradle task uploads a version to Modrinth.checked 10 Oct 2026

Purpose

Minotaur is a Gradle plugin for interfacing with Modrinth by uploading build artifacts and syncing project descriptions.checked 10 Oct 2026

Release metadata

Uploads can specify a version number, changelog, release type, supported game versions, mod loaders, and dependencies.checked 10 Oct 2026

Safety option

With `debugMode` enabled, Minotaur prints the upload data without actually uploading the version.checked 4 Oct 2026

Support

The README says Modrinth supports Minotaur and contrasts that support with the alternative mc-publish GitHub Action.checked 10 Oct 2026

Token handling

The usage examples read the token from the MODRINTH_TOKEN environment variable and caution that it should remain private.checked 10 Oct 2026

Upload metadata

The plugin supports version numbers, changelogs, release types, game versions, loaders, and dependencies.checked 4 Oct 2026