FREEDOM251

Freedom251 › Minecraft Mod Development Tools

Minotaur

Paid API

Visit Minotaur Alternatives

Minotaur's own site

What Minotaur is

Minotaur is a free, open-source Gradle plugin for sending build artifacts to Modrinth and keeping project text synchronized. Its `modrinth` task publishes a version with a version number, changelog, release type, game versions, loaders, dependencies, and additional files. ForgeGradle and Fabric Loom projects can often provide automatic game-version and loader detection, with Fabric and Forge listed as supported loaders. A separate `modrinthSyncBody` task can copy text such as a README into a Modrinth project body, excluding marked comment sections. The API endpoint can be changed and defaults to `https://api.modrinth.com/v2`. Publishing requires a personal token with `CREATE_VERSION`; body syncing requires `PROJECT_WRITE`. Tokens are commonly read from `MODRINTH_TOKEN`. `debugMode` prints upload data without publishing. The README warns that a synchronized body cannot be recovered after it is changed. Version 2.10.0 is listed as the latest release, dated September 16, 2026, under LGPL-2.1.

Who it suits

Minotaur suits creators using Gradle, especially ForgeGradle or Fabric Loom projects, who want release uploads and project-body synchronization through Modrinth. It is also relevant to teams managing release metadata and dependencies in build scripts.

What it does well

  • Free and open source
  • Supports Groovy and Kotlin Gradle DSLs
  • Uploads detailed release metadata
  • Can detect loaders and game versions
  • Offers a debug upload mode

What to know first

  • Synced project bodies cannot be recovered
  • Publishing requires a scoped personal token
  • Body syncing needs a separate permission scope

Verdict

Minotaur connects Gradle release tasks with Modrinth publishing, metadata, dependencies, and optional README synchronization. Review the irreversible body-sync warning and token scopes before enabling automation.

Facts from Minotaur's own pages

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

Where Minotaur stands on Freedom251

Look at these too