mcmeta

Published metadata per Minecraft version lives on branches mc/<mcVersion>. This repository is updated by the harvester action in uebliche/mcmeta-harvest.

Two convenience branches exist:

• latest (newest release from Mojang manifest)
• latest-snapshot (newest non-release, including snapshots/betas)

Proxy branches (Velocity):

• proxy/velocity-<api>
• proxy/velocity-latest

Proxy branches (BungeeCord):

• proxy/bungeecord-<api>
• proxy/bungeecord-latest

Web viewer

The web viewer now lives in the uebliche docs under /mcmeta/viewer.

Gradle plugin (local include)

A small Gradle plugin is available in gradle-plugin/. It loads mcmeta versions, buildability metadata, and exposes them as Gradle extra properties.

The includeBuild("gradle-plugin") line only points Gradle at the local plugin build. The plugin ID is still net.uebliche.mcmeta.

Example settings.gradle.kts:

pluginManagement {
  includeBuild("gradle-plugin")
}

Example build.gradle.kts:

plugins {
  id("net.uebliche.mcmeta")
}

mcmeta {
  minecraftVersion = "1.21.4"
}

dependencies {
  val fabricLoader = extra["mcmetaFabricLoaderVersion"] as String?
  val yarnMappings = extra["mcmetaYarnVersion"] as String?
  val fabricBuildable = extra["mcmetaFabricBuildable"] as Boolean?
  val fabricMappingChannel = extra["mcmetaFabricMappingChannel"] as String?
  val fabricBlockedBy = extra["mcmetaFabricBlockedBy"] as String?
  val paperBuild = extra["mcmetaPaperVersion"] as String?
  val velocityVersion = extra["mcmetaVelocityVersion"] as String?
  val foliaBuild = extra["mcmetaFoliaVersion"] as String?
  val jdk = extra["mcmetaJdkVersion"] as Int?
  // use versions in your dependencies
}

For Fabric projects, the plugin also exposes a shared mapping resolver object:

dependencies {
  minecraft "com.mojang:minecraft:${resolvedMinecraftVersion}"
  (project.ext.has("mcmetaFabricSupport")
      ? project.ext.mcmetaFabricSupport
      : project.rootProject.ext.mcmetaFabricSupport)
      .applyMappings(project, delegate)
}

applyMappings(...) enforces the shared policy mojang -> yarn -> intermediary and fails early when buildability.json (or the derived fallback data on older branches) marks the selected Minecraft version as blocked.

Additional extras now include:

• mcmetaFabricBuildable
• mcmetaFabricBlockedBy
• mcmetaFabricMappingChannel
• mcmetaFabricMappingVersion
• mcmetaFabricAvailableMappingChannels
• mcmeta<Loader>Buildable
• mcmeta<Loader>BlockedBy

Optional: auto repositories + dependencies

Enable repository and dependency wiring explicitly in the extension:

mcmeta {
  minecraftVersion = "1.21.4"
  repositories {
    all()
  }
  dependencies {
    enabled = true
    fabricLoader = true
    fabricApi = true
    neoForge = true
    paperApi = true
    velocityApi = true
    velocityAnnotationProcessor = true
  }
}

Override dependency configurations if your project uses custom names:

mcmeta {
  dependencies {
    enabled = true
    fabricLoader = true
    configurations {
      fabricLoader = "modImplementation"
      fabricApi = "modImplementation"
      paperApi = "compileOnly"
      velocityApi = "compileOnly"
      velocityAnnotationProcessor = "annotationProcessor"
    }
  }
}

Example project

Platform examples live in:

• examples/platforms

Manifold preprocessor (optional)

Enable Manifold preprocessor support to get numeric symbols for all Mojang versions (including snapshots) and a MC_VER value for the requested Minecraft version. This allows expressions like:

#if MC_VER >= MC_1_20_5
// code for 1.20.5+
#endif

Gradle example:

mcmeta {
  minecraftVersion = "1.21.4"
  enableManifoldPreprocessor = true
  // optional override
  // manifoldPreprocessorVersion = "2025.1.22"
}

Publishing (GitHub Packages)

The same workflow also publishes to GitHub Packages:

• https://maven.pkg.github.com/uebliche/mcmeta
• Uses GITHUB_TOKEN with packages:write permission.

To consume via Gradle Plugin DSL, add the repo in settings.gradle.kts:

pluginManagement {
  repositories {
    maven {
      url = uri("https://maven.pkg.github.com/uebliche/mcmeta")
      credentials {
        username = System.getenv("GITHUB_ACTOR")
        password = System.getenv("GITHUB_TOKEN")
      }
    }
    gradlePluginPortal()
  }
}