Use Quilt Mappings on Loom

Last update: Dec 7, 2022

Related tags

Overview

Quilt Mappings on Loom

The time has finally arrived! Quilt Mappings are now usable in Loom!

Ever wanted to use mappings other than Yarn or MojMap?

Quilt Mappings is a Yarn derivative that allows inspiration from MojMap, which allows Quilt Mappings to map the obscure constants in Minecraft code and more. This gradle plugin allows Quilt Mappings to be used in Loom and Fabric environments. Currently, only 1.17.1+ has support, with no plans of backporting to earlier versions.

Benefits of Quilt Mappings:

Faster turn around.
- For the past couple weeks, Quilt Mappings has been out before intermediary. While this doesn't help too much in loom, it is something to look forward to in the future.
Consistent names.
- Quilt Mapping names are never mismatched, meaning you won't find issues where names swap between versions.
Familiarity of Yarn with the completeness of MojMap.
- While not complete, Quilt Mappings has the goal of 100% mapping coverage for Minecraft. Any help toward this goal would be appreciated as well!

How to use Quilt Mappings:

settings.gradle:

pluginManagement {
    repositories {
        maven { url = "https://maven.quiltmc.org/repository/release" }
    }
}

build.gradle:

plugins {
  // ...
  id "org.quiltmc.quilt-mappings-on-loom" version "QMoL_VERSION"
}

// ...

dependencies {
   mappings(loom.layered {
      addLayer(quiltMappings.mappings("org.quiltmc:quilt-mappings:${minecraft_version}+build.${project.quilt_mappings}:v2"))
   })
}

QMoL Versions

Replace QMoL_VERSION in build.gradle with the version corresponding to the version of Loom being used:

Loom Version	QMoL Version
0.10	3.1.2
0.11.31-	4.0.0
0.11.32+	4.1.0

Comments

Fix loss of initializer parameters, add unpick support

Fixes final mapping file not containing any initializer parameters.

Should we change the hash code of the mappings so that when the plugin is updated, the old mappings aren't used? As it is now, updating to 4.0.1 without deleting the cached mappings file, or changing the mappings dependency to an uncached one, doesn't have any effect

opened by ByMartrixx 6
Set Java compatibility level to 16

Loom is still on Java 16 and no Java 17 features are used. This is slightly more convenient for people who want to use this on 1.17.1 without updating their jdk

opened by TheEpicBlock 2
Change quilt-to-intermediary saved file name to prevent Windows-based errors

If using Windows, the attempted previous name would fail because of the : character. My change grabs only the version rather than the entire artifact name to hopefully prevent crashes

opened by sschr15 1
Avoid loom removing parameters

Because loom switches the result mappings source namespace to intermediary, parameters are lost because intermediary doesn't contain the method. This change just completes intermediary with those names to keep them

opened by ByMartrixx 0
Depend on loom 0.11

No source changes were necessary, but net.fabricmc.loom.configuration.providers.MinecraftProvider being moved to net.fabricmc.loom.configuration.providers.minecraft.MinecraftProvider necessitated building against loom 0.11. I changed the version to 4.0.0 since I assume this breaks compatibility with loom 0.10.

opened by leo60228 0
Update README.md

Adds new/current QMoL_VERSION to the table, however I'm not sure which loom version this corresponds to.

I also figured it'd be a good idea to mention the necessary changes for gradle.properties - specifically since quilt_mappings is expected to be there (unless I'm misunderstanding something)

opened by xanderstuff 4

Owner

GitHub

Official Quilt template mod.

Quilt Template Mod The official Quilt template Mod. You can use it as a template for your own mods! Usage In order to use this mod as a template: Crea

32 May 7, 2022

Win32 and DirectX mappings for java using Project Panama. Ignore the C# tag, it's just reference code used for decompilation

JWin32 A Project Panama-based mapping + wrapper generator for win32 headers. IMPORTANT As of 0.5.0, no prebuilt jars will be provided. You must genera