Mappings migrieren

Wenn du vorhast, deinen Mod auf die Version 26.1 oder höher zu aktualisieren, musst du von Yarn auf Mojang Mappings migrieren.

Es gibt zwei Möglichkeiten, dies zu erreichen: Du kannst entweder das Loom Gradle Plugin oder das Ravel IntelliJ IDEA Plugin verwenden.

Loom bietet eine halbautomatische Migration der Mappings über die Aufgabe migrateMappings, unterstützt jedoch keine Migration von in Kotlin geschriebenem Code.

Ravel ist ein Plugin für IntelliJ IDEA, das einen GUI-Dialog für die Migration hinzufügt. Im Gegensatz zu Loom unterstützt Ravel jedoch auch Kotlin. Darüber hinaus könnte Ravel bei komplexeren Projekten eine bessere Leistung als Loom erzielen, da es IDE zur Lösung von Änderungen verwendet.

INFO

Die Fabric-API verwendete Ravel, um von Yarn zu Mojang Mappings zu migrieren. Siehe PR #4690 im Fabric API Repository.

Keine der beiden Optionen ist perfekt, und du musst die Ergebnisse weiterhin überprüfen und manuelle Korrekturen vornehmen, insbesondere bei der Migration von Mixins.

Loom Gradle Plugin Ravel IntelliJ IDEA Plugin

Was ist mit den Mappings los?

In der Vergangenheit hat die Minecraft: Java Edition Verschleierung eingesetzt, was zur Entwicklung von Verschleierungskarten geführt hat, die Fabric Loom für Modding verwendet. Es gab zwei Möglichkeiten: entweder die Fabric-eigenen Yarn-Mappings oder die offiziellen Mojang-Mappings.

Mojang hat kürzlich die erste Version von Minecraft: Java Edition mit nicht verschleiertem Code veröffentlicht, und das Fabric-Projekt hat beschlossen, [die Pflege von Drittanbieter-Mappings](https://fabricmc.net/ 2025/10/31/obfuscation.html) ab dieser Version nicht mehr weiterzuentwickeln. Wenn du vorhast, deinen Mod auf diese Version zu aktualisieren, musst du vor dem Update zunächst zu Mojangs Mappings wechseln.

Was sind Mappings?

Minecraft: Die Java Edition war seit ihrer Veröffentlichung bis zur Version 1.21.11 verschleiert, was bedeutet, dass in ihrem Code für Menschen lesbare Klassennamen wie Creeper durch unverständliche Zeichenfolgen wie brc ersetzt wurden. Um das Modding zu vereinfachen, verwendet Fabric Loom Verschleierungskarten: Referenzen, die verschleierte Klassennamen wie brc wieder in menschenfreundliche Namen wie CreeperEntity übersetzen.

Als erfahrener Fabric-Entwickler bist du auf drei Hauptgruppen von Namen gestoßen:

• Intermediary: Das von kompilierten Fabric-Mods verwendete Mapping-Set; beispielsweise kann brc zu class_1548 werden. Der Sinn hinter Intermediary besteht darin, über verschiedene Versionen hinweg eine stabile Reihe von Namen anzubieten, da sich verschleierte Klassennamen mit jeder neuen Version von Minecraft ändern. Dadurch können Mods, die für eine bestimmte Version entwickelt wurden, oft auch auf anderen Versionen funktionieren, solange die betroffenen Teile des Spiels nicht zu stark verändert wurden.
• Yarn: Ein von Fabric entwickeltes Open- Source-Mapping-Set, mit dem Menschen Mods schreiben können. Die meisten Fabric-Mods verwendeten Yarn-Mappings, da diese vor ihrer Einstellung im Jahr 2025 der Standard waren. Ein Beispiel für eine Zuordnung könnte CreeperEntity sein.
• Mojang Mappings: Die offiziellen Verschleierungsmappings des Spiels, die 2019 von Mojang veröffentlicht wurden, um die Mod-Entwicklung zu unterstützen. Insbesondere fehlen in den Verschleierungsmappings von Mojang Parameternamen und Javadocs, weshalb einige Benutzer zusätzlich Parchment über die offiziellen Mappings legen. Ein Beispiel für eine Zuordnung könnte Creeper sein.

Minecraft 26.1 ist nicht verschleiert und enthält Parameternamen, sodass keine Mappings für die Verschleierung erforderlich sind.