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.tinyhinzu, wählenamedals Quell-Namensraum undofficialals Ziel-Namensraum. Füge dann die Mojangclient.txthinzu und wähletargetals Quell-Namensraum undsourceals Ziel-Namensraum. - Für die Migration von Mojang Mappings zu Yarn füge zunächst die Mojang
client.txthinzu, wobei du diesmalsourceals Quelle undtargetals Ziel auswählst. Füge dann die Yarnmappings.tinyhinzu und wähleofficialals Quelle undnamedals 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.
groovy
dependencies {
mappings "net.fabricmc:yarn:${project.yarn_mappings}:v2"
mappings loom.officialMojangMappings()
// Or the reverse if you're migrating from Mojang Mappings to Yarn
}1
2
3
4
5
2
3
4
5
Aktualisiere auch deine gradle.properties, entferne die Option yarn_mappings oder aktualisiere sie entsprechend der von dir verwendeten Option.
properties
yarn_mappings=1.21.11+build.3 1
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.


