Catalogue Vintage: бэкпорт удобного списка модов на старые версии Minecraft
Многие игроки до сих пор остаются верны классическим сборкам Minecraft 1.12.2 и даже 1.7.10. Именно для них был создан мод Catalogue Vintage — обратный перенос знаменитого мода MrCrayfish's Catalogue, который добавляет в главное меню аккуратный список установленных модификаций с иконками, описаниями и ссылками. По сути, это тот же MrCrayfish's Mod List, но адаптированный под устаревшие версии игры, где оригинальный Catalogue никогда не работал.
Зачем нужен Catalogue Vintage
В современных версиях Minecraft мод MrCrayfish's Catalogue стал стандартом де-факто для навигации по модам прямо из главного меню. Он позволяет быстро просмотреть информацию о каждом дополнении, перейти на страницу баг-трекера или просто полюбоваться красивым фоном. Catalogue Vintage привносит те же возможности в ретро-сборки, где раньше приходилось рыться в папке mods или полагаться на сторонние лаунчеры. Теперь всё отображается в едином стильном интерфейсе, что особенно ценно для тех, кто собирает тематические модпаки на базе 1.12.2 или 1.7.10.
Особенности и версии мода
Catalogue Vintage существует в двух основных ветках: 1.12.2-Cleanroom и 1.12.2-Forge. Разница между ними критична, потому что Cleanroom — это особая среда, нацеленная на чистоту кода и обратную совместимость, а Forge — классический загрузчик модов. На CurseForge версии для Cleanroom помечены как NeoForge, так как платформа не предоставляет отдельной категории для Cleanroom. Важно не перепутать: если вы играете на обычном Forge, выбирайте файл с пометкой Forge, иначе мод просто не запустится.
Ветка 1.7.10 также доступна, но её функционал несколько урезан из-за ограничений старого Forge. Например, мод не умеет читать кастомные свойства из файла mcmod.info — того самого, где прописываются название, описание и прочая мета-информация о модах. Разработчик поясняет, что легаси Forge не предоставляет нужных API для парсинга этих данных, поэтому часть возможностей реализовать пока нельзя. Впрочем, уже существует пулл-реквест, который добавляет чтение новых свойств, и если его примут, Cleanroom-версия перестанет обновляться отдельно.
Как установить и настроить
Установка Catalogue Vintage ничем не отличается от любого другого мода для старых версий: скачанный jar-файл помещается в папку mods, после чего игра запускается с совместимой версией Forge или Cleanroom. После загрузки в главном меню появится кнопка «Mods», открывающая список всех установленных дополнений. Интерфейс минималистичен, но информативен: для каждого мода показывается иконка, название, версия и краткое описание. Приятно, что разработчики могут задать фон и ссылку на баг-трекер — тогда страница мода станет ещё полезнее.
Кстати, если вы активно экспериментируете со старыми сборками, оцените удобство современных лаунчеров. Например, этот мод можно легко установить через лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню. Он автоматически подбирает совместимые версии и избавляет от ручного поиска файлов, что сильно экономит время при тестировании Catalogue Vintage на разных конфигурациях.
Новые свойства для разработчиков
Хотя в текущей публичной версии Catalogue Vintage не поддерживает чтение кастомных полей из mcmod.info, в пулл-реквесте уже реализована эта возможность. Разработчики модов могут добавить в свой mcmod.info несколько новых ключей, которые подхватит обновлённый Catalogue:
- iconFile — строка, указывающая на квадратный PNG-файл иконки. Если задан корректный путь, свойство iconItem игнорируется.
- iconItem — строка в формате "minecraft:stone" (допустимы метаданные). Используется как запасной вариант, когда iconFile не задан или не найден.
- backgroundFile — строка, указывающая на PNG-файл размером 512x256 пикселей. Он станет фоном страницы мода в списке.
- license — строка, которая отобразится внизу страницы с информацией о моде. Удобно для указания лицензии.
- issueTrackerUrl — ссылка на баг-трекер. При нажатии кнопки «Submit Bug» Catalogue откроет её в браузере.
Для тех, кто предпочитает аннотации, существует альтернативный путь — использование @Mod.CustomProperty внутри аннотации @Mod. Например, в классе Catalogue.java можно задать те же поля прямо в коде. Однако важно помнить: если и в аннотации, и в mcmod.info указаны одинаковые свойства, приоритет будет у значений из mcmod.info (после принятия пулл-реквеста). Добавлять Catalogue в сборочный скрипт проекта совершенно не обязательно — мод работает как самостоятельный плагин к главному меню.
Практическое применение в модпаках
Catalogue Vintage особенно полезен авторам сборок, ориентированных на версии 1.12.2 и 1.7.10. Представьте: вы собрали тематический модпак с сотней модификаций, а игроку нужно быстро понять, что делает каждый из них. Вместо того чтобы писать длинные гайды, вы можете прописать в mcmod.info иконки, фон и ссылку на вики — и Catalogue сам покажет всё в красивом интерфейсе. Это повышает юзабилити сборки и снижает порог входа для новичков, которые только знакомятся с миром модов.
Ещё один сценарий — отладка. Разработчики могут временно подключить Catalogue Vintage, чтобы визуально проверить, как их мод отображается в общем списке, правильно ли подгружается иконка, не бьётся ли вёрстка фона. Благодаря поддержке Cleanroom мод легко интегрируется в тестовые окружения, где важна стабильность и чистота кодовой базы.
Заключение
Catalogue Vintage — это маленький, но крайне полезный инструмент для всех, кто продолжает играть или разрабатывать моды на классических версиях Minecraft. Он переносит удобство современного интерфейса в мир 1.12.2 и 1.7.10, делая навигацию по модам интуитивно понятной. Несмотря на технические ограничения легаси Forge, активное сообщество работает над расширением функционала, и уже сейчас можно пользоваться базовым списком, а в перспективе — получить полноценную кастомизацию через mcmod.info. Если вы цените порядок в своих сборках, обязательно попробуйте этот бэкпорт — он заслуживает места в папке mods наравне с другими обязательными утилитами.