Skip to content

mcmetaMinecraft metadata service

Versioned data with a hosted viewer in the docs.

mcmeta preview

Web viewer

The web viewer is hosted inside the docs and reads the same versioned mcmeta branches that power the data feeds. Use it to browse release and snapshot streams, inspect download metadata, and copy version details into build or CI notes.

What you can do inside the viewer:

  • Scan release metadata (release date, protocol/data/pack formats).
  • Open download links for version json, client/server jars, and mappings.
  • See extra metadata when it exists (for example Yarn mapping versions or Purpur build numbers).

Open web viewer

Gradle plugin

The Gradle plugin mirrors mcmeta version data into Gradle properties so build logic can pin Minecraft versions without hard-coding them. It also exposes an extras map for optional metadata such as Yarn mapping versions or Purpur build numbers, keeping multi-loader and CI builds consistent with the mcmeta branches.

When offline, the Gradle plugin can fall back to local mcmeta harvest backups stored in tools/mcmeta-harvest-backup. If an exact Minecraft version is not available, it will use the newest backup that shares the same major.minor and log a warning. If that still fails, it uses the newest available backup.

For NeoForge loader projects that already apply ModDevGradle, the plugin wires run tasks (client/server/data) using the requested Minecraft version.

mcmeta proxy stack

The mcmeta proxy stack serves harvested metadata and Maven-style artifacts from Hetzner Object Storage. Requests to the standard Maven layout are rewritten to match the storage layout so only the required jars are stored.

Rewrite rule used by the proxy:

  • /{group}/{artifact}/{version}/{file} -> /{artifact}/{version}/{file}

Upload harvested artifacts into the bucket using the rewritten path pattern.

Feature checklist

Track feature progress in the checklist.

Feature highlights

  • Version branches
  • Web viewer
  • Gradle plugin
  • Add feature checklist page to track project progress.
  • Add a dedicated mcmeta proxy stack (nginx + S3-backed origin) for serving harvested artifacts.
  • Document the artifact path rewrite pattern for mcmeta proxy downloads.
  • Configure ModDevGradle run tasks for NeoForge loader projects once the plugin is applied.
  • Show the requested Minecraft version in the web viewer metadata panel.
  • Expose Yarn mapping versions in mcmeta metadata and Gradle plugin extras.
  • Show Yarn mapping versions in the mcmeta viewer.
  • Add Purpur build versions to mcmeta artifacts and viewer.
  • Expose Purpur versions via Gradle plugin extras.
  • Add mcmeta docs and changelog pages.
  • Show Minecraft download links (version json, client/server jars, mappings) in the viewer.
  • Surface release metadata (protocol/data/pack formats, release date) in the viewer.