Registry Dumper 3000: ваш главный помощник в отладке модифицированного Minecraft
Когда вы собираете модпак, создаёте датапаки или разрабатываете собственный мод, рано или поздно возникает вопрос: что именно загрузилось в игру после слияния всех ресурсов, тегов и рецептов? Ответить на него помогает Registry Dumper 3000 — узкоспециализированный инструмент, который выгружает на диск полную структуру реестров, тегов, рецептов и ресурсных папок в удобном для анализа виде.
Зачем нужен Registry Dumper 3000?
В основе Minecraft лежит система реестров: блоки, предметы, жидкости, биомы, структуры, данжи — всё это регистрируется и обрабатывается игрой в определённом порядке. Когда в сборке установлены десятки или сотни модов, а поверх них наложены датапаки и ресурспаки, финальное состояние контента может сильно отличаться от ожидаемого. Registry Dumper 3000 делает «слепок» этого состояния и сохраняет его в папку dump/ прямо в корне игровой директории. Вы получаете не догадки, а точные данные, с которыми можно работать.
Основные возможности мода
Мод выгружает несколько категорий данных, каждую из которых можно включать или отключать в конфиге:
- Встроенные реестры (BuiltInRegistries.REGISTRY). Все стандартные реестры, доступные на этапе загрузки. Формат вывода — TXT или JSON, с опциональным указанием имён классов для записей, что критически важно при отладке модов.
- Рантайм-реестры. Реестры, полученные из
RegistryAccessсервера, то есть финальное состояние, которое видит сервер после обработки всех модов и датапаков. - Сырые JSON-файлы тегов. Прямой дамп тегов из ресурс-менеджера с автоматическим определением типа реестра. Поддерживает даже теги, добавленные модами, и позволяет сохранять исходное форматирование или pretty-print.
- Развёрнутые рантайм-теги. Финальное содержимое тегов после слияния всех источников. Вы видите, какие элементы реально попали в тег, а не то, что прописано в отдельных файлах.
- Сырые JSON-файлы рецептов. Все рецепты из
data/*/recipes/, сгруппированные по типу. Ошибки парсинга и неизвестные типы обрабатываются безопасно. - Ресурсные папки датапаков по правилам. Гибкая система на основе конфигурационных правил позволяет выгружать произвольные директории из
data/: таблицы добычи, предикаты, модификаторы предметов, достижения, функции, генерацию мира (биомы, структуры, шумовые карты, плотность и многое другое), измерения, типы урона, шаблоны брони, музыкальные диски и т.д. По умолчанию покрыт широкий спектр папок, включая специфичные для Forge и NeoForge модификаторы лута, биомов и структур. - Клиентские ассеты (опционально). Может выгружать ресурсы клиента: языковые файлы, модели, блокстейты, текстуры, звуки, шрифты, шейдеры и атласы. По умолчанию отключено из-за большого объёма.
- Неизвестные папки. Режим catch-all для любых директорий в
data/, которые не попали под явные правила. Помогает обнаружить скрытые ресурсы, добавленные модами.
Для кого этот мод?
Registry Dumper 3000 — инструмент сугубо технический. Он не добавляет геймплейных механик, блоков или предметов. Его аудитория — разработчики модпаков, создатели датапаков, мододелы и администраторы серверов, которые сталкиваются с конфликтами тегов, переопределением рецептов, ошибками в путях ресурсов или неожиданными записями в реестрах. Если вы хотя бы раз ломали голову над тем, почему крафт не работает, а тег не содержит нужный предмет, — этот мод для вас. Кстати, для быстрого тестирования подобных утилит отлично подходит лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню и сразу запустить нужную сборку без лишних манипуляций с файлами.
Как начать работу
Установка предельно проста: поместите файл мода в папку mods и запустите игру или сервер. После первого запуска автоматически создастся конфигурационный файл config/registry_dumper_3000.json. Откройте его и настройте, какие секции дампа вам нужны. По умолчанию активированы основные реестры, теги и рецепты. После повторного запуска в папке dump/ появятся структурированные каталоги с именами вроде registry_builtin, registry_runtime, tags, recipes и другие. Каждый крупный раздел сопровождается файлом _summary.txt с краткой сводкой и количеством записей.
Конфигурация и тонкая настройка
JSON-конфиг даёт полный контроль над поведением мода. Вы можете выбрать формат вывода (TXT или JSON) для поддерживаемых дампов, включить pretty-print для читаемости, ограничить дамп однократным выполнением за сессию, задать триггеры (клиент или сервер), настроить правила для ресурсных папок и даже активировать экспериментальный дамп стека ресурсов. Если вы работаете с огромными модпаками, отключайте ненужные секции, чтобы не генерировать гигабайты данных.
Производительность и ограничения
Мод способен создать очень много файлов. Включение клиентских ассетов или catch-all для неизвестных папок может заметно увеличить время запуска и занять место на диске. Pretty-print для JSON также повышает нагрузку на процессор. Рекомендуется активировать только те разделы, которые действительно нужны для текущей задачи. В остальном мод работает по принципу «запустил — получил данные — отключил», не влияя на производительность игры после завершения дампа.
Заключение
Registry Dumper 3000 — незаменимый помощник в арсенале любого технического специалиста по Minecraft. Он превращает непрозрачный процесс загрузки контента в читаемый набор файлов, позволяя быстро находить причины конфликтов, проверять финальное содержимое тегов и рецептов, а также исследовать, как моды и датапаки взаимодействуют друг с другом. Если ваша работа связана с отладкой модифицированной среды, этот инструмент сэкономит вам часы ручного поиска. Просто настройте конфиг под свои задачи, запустите игру — и папка dump/ расскажет всё, что скрыто под капотом Minecraft.