Blame (Forge): диагностика ошибок в Minecraft, о которых молчат логи
Когда модифицированный Minecraft внезапно вылетает при генерации мира или команды перестают работать без единого намёка в консоли, поиск причины превращается в пытку. Стандартные логи часто молчат, а стектрейсы отсутствуют. Именно для таких случаев создан Blame — небольшой, но мощный диагностический мод для Forge, который берёт на себя роль детектива.
Blame не добавляет новых блоков, мобов или механик. Его задача — расшифровывать молчаливые сбои и выводить максимум информации в файл latest.log, который находится в папке logs. Мод работает только на стороне сервера или в одиночной игре; клиентам, подключающимся к серверу, он не нужен. Если вы играете на Fabric, существует отдельная версия — просто найдите Blame Fabric на CurseForge.
Что умеет Blame: полный список возможностей
Разработчик TelepathicGrunt собрал внушительный арсенал проверок, которые активируются автоматически при запуске игры. Вот ключевые функции мода:
- Перехват крашей команд. Обычно модифицированные команды падают без вывода ошибок. Blame принудительно печатает стектрейс в лог, если команда завершилась аварийно.
- Поиск сломанных команд при старте мира. Мод обнаруживает команды, у которых вызов .executes() находится вне цепочки .then(), и сообщает о них.
- Детализация ошибок генерации мира. Если во время создания ландшафта крашится фича, структура или карвер, Blame выводит дополнительную информацию — название проблемного элемента и причину.
- Логирование незарегистрированных объектов. ConfiguredFeatures, ConfiguredStructures и ConfiguredCarvers, которые моды забыли зарегистрировать, будут перечислены в логе. Это критично, потому что такие пропуски ломают генерацию других модов.
- Обнаружение ранней загрузки DynamicRegistry. Некоторые моды инициализируют реестр слишком рано, что приводит к ошибкам вроде «Unknown Biome ID». Blame фиксирует этот момент и указывает виновника.
- Анализ повреждённых JSON-файлов. Если датапак или мод содержат битый JSON для мировых генераций, мод не только укажет путь к файлу, но и покажет его содержимое.
- Проверка loot tables. При попытке сгенерировать добычу из отсутствующей таблицы (например, пустой сундук) Blame запишет предупреждение с именем недостающей таблицы.
- Контроль spacing и separation структур. Если у структуры spacing равен нулю или separation больше либо равен spacing, игра гарантированно крашится. Blame сообщит имя проблемной структуры.
- Удобная группировка ошибок рецептов и loot tables. Логи становятся чище: повторяющиеся ошибки парсинга объединяются, что упрощает чтение и отправку отчётов.
- Исправление бага MC-190122. В ванилле неправильно подсчитывалось количество загруженных рецептов. Blame корректирует это число, помогая при отладке.
- Диагностика кастомных ChunkGenerator'ов. Если структура не добавлена в FlatGenerationSettings.STRUCTURES, мод выведет её название при краше.
- Отслеживание отсутствующих template pool. Jigsaw-структуры, ссылающиеся на несуществующий пул шаблонов, будут записаны в лог — так вы узнаете, почему структура генерируется не полностью.
- Логирование обращений к несуществующим NBT-файлам. Полезно для мододелов, работающих со структурами и процессорами.
- Предупреждение о ранней загрузке TagCollectionManager. Если теги загружаются до регистрации всех модов, это может сломать чужие теги. Blame предупредит о такой ситуации.
- Детализация сбоев structure processor'ов. При краше процессора во время генерации структуры мод выводит блок, его NBT и имя NBT-файла, вызвавшего ошибку.
Такой набор инструментов делает Blame незаменимым для всех, кто собирает модпаки или разрабатывает собственные моды. При этом мод не требует настройки — достаточно поместить его в папку mods. Кстати, если вы не хотите возиться с ручной установкой, лаунчер foxygame.net предлагает удобный способ: прямо в интерфейсе можно найти и скачать Blame, а также настроить профиль Forge буквально в пару кликов.
Blame в связке с другими инструментами
Для версий Minecraft 1.17 и выше разработчик рекомендует использовать мод Cyanide вместо встроенного парсинга JSON — он обеспечивает более качественный анализ файлов worldgen. Также для полного дампа всех реестров пригодится мод TellMe от Masady. Обе утилиты прекрасно дополняют Blame и не конфликтуют между собой.
Для разработчиков: интеграция Blame в среду разработки
Если вы мододел и хотите использовать Blame в dev-окружении Forge, добавьте его как зависимость runtimeOnly. Пропишите в build.gradle репозиторий maven: url "https://nexus.resourcefulbees.com/repository/maven-public/". Затем в блоке dependencies укажите runtimeOnly fg.deobf("com.telepathicgrunt:Blame:<версия>"), где <версия> — актуальный номер, например 1.16.5-3.2.1-forge. Не забудьте добавить в оба run-конфига (client и server) свойства для работы миксинов:
- property 'mixin.env.remapRefMap', 'true'
- property 'mixin.env.refMapRemappingFile', "${projectDir}/build/createSrgToMcp/output.srg"
После обновления Gradle и запуска задачи генерации запусков (genEclipseRuns, genIntellijRuns или genVSCodeRuns) в консоли IDE появится сообщение об инициализации Blame — значит, всё работает.
Заключение
Blame — это тот редкий случай, когда один маленький мод экономит часы отладки. Он не влияет на производительность, не добавляет визуального шума и активируется только тогда, когда что-то идёт не так. Если вы столкнулись с загадочными крашами при создании мира, пустыми сундуками или командами, которые просто не работают, Blame станет вашим лучшим помощником. А благодаря удобным лаунчерам вроде foxygame.net установка занимает считанные секунды, позволяя сразу перейти к поиску и устранению проблем.