Міграція мапінгів за допомогою Ravel

Ravel — це плаґін для IntelliJ IDEA для переналаштування вихідних файлів на основі PSI IntelliJ і Mapping-IO. Він підтримує перемапування Java, Kotlin, міксинів (написані на Java), твікери класу і розширювачі доступу.

Установіть його з JetBrains Marketplace або завантажте ZIP-файл з випусків GitHub і встановіть його, натиснувши значок шестірні в налаштуваннях плаґіна та натиснувши Install Plugin From Disk.

![Установлення плаґіна IDEA з носія(/assets/develop/misc/migrating-mappings/idea_local_plugin.png)

Міграція мапінгів

WARNING

Унесіть будь-які зміни, перш ніж намагатися переналаштувати свої джерела! Поки що не змінюйте свій gradle.properties або build.gradle!

Далі натисніть ПКМ по файлу, відкритий у редакторі, і виберіть Refactor > Remap Using Ravel*

Відкриється таке діалогове вікно. Ви також можете відкрити діалогове вікно, натиснувши Refactor у верхньому меню.

Далі додайте мапінги, натиснувши значок +. Натисніть опцію завантаження, якщо у вас їх ще немає.

INFO

Якщо ви не бачите кнопку завантаження, оновіть Ravel до 0.3 або вище.

• Для переходу від мапінги Yarn до Mojang спочатку додайте файл Yarn mappings.tiny, виберіть named як source простір імен і official як destination простір імен. Потім додайте файл Mojang client.txt і виберіть target як source простір імен і source як destination простір імен.
• Для переходу від мапінгів Mojang до Yarn спочатку додайте client.txt Mojang, цього разу вибравши source як source і target як destination. Потім додайте Yarn mappings.tiny і виберіть official як source і named як destination.

Потім виберіть модулі, які потрібно змінити, натиснувши значок + або значок ліворуч, щоб додати всі модулі.

Потім натисніть OK і дочекайтеся завершення перемапування.

Оновлення Gradle

Після завершення перемапування замініть свої мапінги в build.gradle вашого мода.

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

Також оновіть свій gradle.properties, видаліть параметр yarn_mappings або оновіть його до того, який ви використовуєте.

yarn_mappings=1.21.11+build.3 

Кінцеві зміни

Ось і основна частина роботи виконана! Тепер ви захочете переглянути вихідний код, щоб перевірити потенційно застарілі цілі міксина або код, який не було перемаповано.

Для проблем, які виявляє Ravel, ви можете виконати пошук (Ctrl+Shift+F) за запитом TODO(Ravel).

Такі інструменти, як mappings.dev або Linkie, допоможуть ознайомитись із вашими новими мапінгами.