Mappings migrieren unter Verwendung von Ravel 1.21.11

Lerne, wie du die verschleierten Mappings deines Mods unter Verwendung von Ravel migrierst.

WARNING

Diese Seite ist für die Version 1.21.11 geschrieben. Dokumentationen für ältere Versionen sind möglicherweise unvollständig.

Ravel ist ein Plugin für IntelliJ IDEA, um Quelldateien zu Remappen, basierend auf IntelliJ's PSI und Mapping-IO. Es unterstützt remapping von Java, Kotlin, Mixins (geschrieben in Java), Class Tweakers und Access Wideners.

Installiere es über den JetBrains Marketplace oder lade die ZIP-Datei von GitHub Releases herunter und installiere es, indem du auf das Zahnrad-Icon in den Plugin-Einstellungen klickst und dann auf Plugin von Datenträger installieren klickst.

Mappings migrieren

WARNING

Committe alle Änderungen, bevor du versuchst, deine Quellen zu remappen! Ändere deine gradle.properties oder build.gradle noch nicht!

Klicke zunächst mit der rechten Maustaste auf eine im Editor geöffnete Datei und wähle Refactor > Remap Using Ravel

Es wird sich ein Dialog, wie dieser, öffnen. Du kannst den Dialog auch öffnen, indem du im oberen Menü auf Refactor klickst.

Füge anschließend die Mappings hinzu, indem du auf das +-Icon klickst. Klicke auf die Download-Option, wenn du diese noch nicht hast.

INFO

Wenn du die Download Schaltfläche nicht siehst, aktualisiere Ravel auf Version 0.3 oder höher.

• Für die Migration von Yarn zu Mojang Mappings füge zunächst die Yarn mappings.tiny hinzu, wähle named als Quell-Namensraum und official als Ziel-Namensraum. Füge dann die Mojang client.txt hinzu und wähle target als Quell-Namensraum und source als Ziel-Namensraum.
• Für die Migration von Mojang Mappings zu Yarn füge zunächst die Mojang client.txt hinzu, wobei du diesmal source als Quelle und target als Ziel auswählst. Füge dann die Yarn mappings.tiny hinzu und wähle official als Quelle und named als Ziel.

Wähle dann die Module aus, die du remappen möchtest, indem du auf das Icon + oder das Icon links davon klickst, um alle Module hinzuzufügen.

Klicke anschließend auf OK und warte, bis das Remapping abgeschlossen ist.

Gradle aktualisieren

Nachdem das Remapping abgeschlossen ist, ersetze deine Mappings in der Datei build.gradle deines Mods.

dependencies {
    mappings "net.fabricmc:yarn:${project.yarn_mappings}:v2"
    mappings loom.officialMojangMappings() 
    // Or the reverse if you're migrating from Mojang Mappings to Yarn
}

Aktualisiere auch deine gradle.properties, entferne die Option yarn_mappings oder aktualisiere sie entsprechend der von dir verwendeten Option.

yarn_mappings=1.21.11+build.3 

Finale Änderungen

Der Großteil der Arbeit ist geschafft! Du solltest nun deinen Quellcode durchgehen, um nach möglicherweise veralteten Mixin-Zielen oder Code zu suchen, der nicht remapped wurde.

Bei Problemen, die von Ravel erkannt werden, kannst du (Ctrl+Shift+F) nach TODO(Ravel) suchen.

Tools wie mappings.dev oder Linkie sind hilfreich, um sich mit deinen neuen Mappings vertraut zu machen.