StackDeobfuscator - это небольшой, но крайне полезный мод для разработчиков и продвинутых игроков Minecraft. Если вы хоть раз видели в консоли Майнкрафта что-то вроде net.minecraft.class_310 и ломали голову, что это за класс - этот мод для вас.

Что делает StackDeobfuscator?

По умолчанию Minecraft в продакшн-сборках использует обфусцированные имена классов и методов. Это нормально для обычной игры, но когда вылетает ошибка или краш-репорт - разобраться в такой простыне практически невозможно. StackDeobfuscator автоматически ремаппит (переводит) все логи и краш-репорты из нечитаемого вида в понятные имена, например:

• Было: net.minecraft.class_310
• Стало: net.minecraft.client.MinecraftClient

Разница колоссальная, особенно если вы разрабатываете моды или собираете сборку. Вместо того чтобы гадать, какой класс вызвал падение, вы сразу видите точное имя метода и класса.

Как это выглядит на практике

Вот пример типичного краш-репорта до и после установки мода:

До (стандартный обфусцированный вид):

[23:13:08] [Render thread/ERROR]: Reported exception thrown!
net.minecraft.class_148: Manually triggered debug crash
         at net.minecraft.class_309.method_1474(class_309.java:509)
         at net.minecraft.class_310.method_1574(class_310.java:1955)

После (с Yarn/Quilt маппингами):

[23:11:25] [Render thread/ERROR]: Reported exception thrown!
net.minecraft.util.crash.CrashException: Manually triggered debug crash
         at net.minecraft.client.Keyboard.pollDebugCrash(Keyboard.java:509)
         at net.minecraft.client.MinecraftClient.tick(MinecraftClient.java:1955)

Сразу видно, что проблема в Keyboard.pollDebugCrash - можно быстро найти нужный класс и исправить баг.

Поддерживаемые маппинги

Мод умеет работать с тремя основными наборами маппингов:

• Yarn - для версий Minecraft от 18w49a (снапшот 1.14) и выше
• Quilt - для версий 1.18.2+
• Mojang - официальные маппинги от Mojang, для версий 1.14.4 и 19w36a+

Маппинги скачиваются один раз и кешируются. Yarn и Quilt обновляются каждые 48 часов, так что вы всегда будете работать с актуальными данными.

Важно знать

• Мод устарел для версий Minecraft новее 1.21.11. Для старых версий (до 1.21.11) он всё ещё поддерживается и работает отлично.
• Если вам нужно быстро расшифровать стектрейс без установки мода - есть веб-версия на stackdeobf.net.
• Для настройки можно использовать конфиг, но по умолчанию мод работает из коробки.

Для кого этот мод

В первую очередь - для разработчиков модов и сборщиков модпаков. Если вы тестируете свои моды на сервере или в одиночной игре и хотите видеть понятные ошибки вместо обфусцированной каши - StackDeobfuscator сэкономит вам кучу времени. Обычным игрокам он вряд ли пригодится, но если вы любите копаться в логах - почему бы и нет.

Скачайте StackDeobfuscator и забудьте про class_310 в своих краш-репортах.