Minotaur

What it does

Additional files

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

API configuration

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

Authentication

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

Automatic detection

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

Build scripts

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

Build script support

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

Current release

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

Destructive limitation

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

Dry run

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

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 2001

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 2001

License

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

Notable limit

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

Project body sync

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

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 2001

Publishing

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

Purpose

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

Release metadata

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

Safety option

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

Support

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

Token handling

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

Upload metadata

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