quilt-mappings-on-loom/README.md

44 lines
1.6 KiB
Markdown

# 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](https://github.com/QuiltMC/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, 1.17.1+ is only has support, with no plans of backporting to earlier versions.
## **Benefits of Quilt Mappings:**
1. 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.
2. Consistent names.
- Quilt Mapping names are never mismatched, meaning you won't find issues where names swap between versions.
3. 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`:
```groovy
pluginManagement {
repositories {
maven { url = "https://maven.quiltmc.org/repository/release" }
}
}
```
`build.gradle`
```groovy
plugins {
// ...
id "org.quiltmc.quilt-mappings-on-loom" version "3.1.0"
}
// ...
dependencies {
mappings(loom.layered {
addLayer(quiltmappings.mappings("org.quiltmc:quilt-mappings:${minecraft_version}+build.${project.quilt_mappings}:v2"))
})
}
```