Skip to content
SPECIFICTION
Get listed

Minotaur

github.com

API
Visit github.com
Spec score 7.1 #25 of 35 in Minecraft Mod Development Tools

Spec sheet

Purpose
Minotaur is a Gradle plugin for interfacing with Modrinth by uploading build artifacts and syncing project descriptions.Read 10 Oct 2026 · github.com
Intended users
Modrinth describes Minotaur as a way for creators to integrate their build tools and automatically upload new versions when they release them.Read 4 Oct 2026 · modrinth.com
Support
The README says Modrinth supports Minotaur and contrasts that support with the alternative mc-publish GitHub Action.Read 10 Oct 2026 · github.com
License
The repository lists the GNU LGPL-2.1 license.Read 10 Oct 2026 · github.com
Additional files
The plugin supports uploading additional files alongside a version.Read 10 Oct 2026 · github.com
API configuration
The API endpoint is configurable and defaults to `https://api.modrinth.com/v2`.Read 4 Oct 2026 · github.com
Authentication
Publishing requires a Modrinth personal access token with CREATE_VERSION scope, and body syncing requires PROJECT_WRITE scope.Read 10 Oct 2026 · github.com
Automatic detection
Game versions and loaders can usually be detected automatically when using ForgeGradle and Fabric Loom.Read 10 Oct 2026 · github.com
Build script support
The README shows setup examples for both Groovy and Kotlin Gradle DSLs.Read 10 Oct 2026 · github.com
Build scripts
The README shows usage with both Groovy and Kotlin Gradle DSLs.Read 4 Oct 2026 · github.com
Current release
The Gradle Plugin Portal lists version 2.10.0 as the latest version, created September 16, 2026.Read 4 Oct 2026 · plugins.gradle.org
Destructive limitation
The README warns that after a project body is changed through syncing, it cannot be recovered.Read 4 Oct 2026 · github.com
Dry run
Its debugMode option prints upload data without actually uploading the version.Read 10 Oct 2026 · github.com
Integration
Minotaur uses the Modrinth API and documents ForgeGradle and Fabric Loom detection; its API endpoint defaults to https://api.modrinth.com/v2.Read 10 Oct 2026 · github.com
Notable limit
The README warns that once a synced project body is changed, it cannot be restored through the task.Read 10 Oct 2026 · github.com
Project body sync
The `modrinthSyncBody` task can sync text such as a project's README to its Modrinth project body.Read 4 Oct 2026 · github.com
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.Read 10 Oct 2026 · github.com
Publishing
The `modrinth` Gradle task uploads a version to Modrinth.Read 10 Oct 2026 · github.com
Release metadata
Uploads can specify a version number, changelog, release type, supported game versions, mod loaders, and dependencies.Read 10 Oct 2026 · github.com
Safety option
With `debugMode` enabled, Minotaur prints the upload data without actually uploading the version.Read 4 Oct 2026 · github.com
Token handling
The usage examples read the token from the MODRINTH_TOKEN environment variable and caution that it should remain private.Read 10 Oct 2026 · github.com
Upload metadata
The plugin supports version numbers, changelogs, release types, game versions, loaders, and dependencies.Read 4 Oct 2026 · github.com

Where Specifiction places it

Alternatives to MinotaurAll alternatives →