QDResLoader

QDResLoader - это мод-утилита для Майнкрафт на загрузчике Quilt, который решает одну конкретную задачу: глобальную загрузку датапаков и ресурспаков для всех миров и всех запусков игры. Никакой магии и никакого лишнего кода - мод просто берёт уже существующую, проверенную временем систему загрузки ресурсов из QSL (Quilt Standard Libraries) и подключает к ней обычную папку resources в директории игры. Если вы собираете сборку модов на Quilt или просто хотите, чтобы нужные паки применялись всегда и везде - скачать QDResLoader будет самым простым решением.

Какую проблему решает мод

В ванильном Minecraft у ресурспаков и датапаков есть известная боль. Ресурспак надо вручную кидать в папку resourcepacks и включать в меню, а датапак - вообще закидывать в папку конкретного мира при его создании. Хотите один и тот же твик рецептов на всех мирах? Копируйте его в каждый мир отдельно. Собрали сборку и отдали другу? Объясняйте ему, куда что нажимать.

Существующие альтернативы для глобальной загрузки ресурсов - это обычно здоровенные библиотеки, тянущие за собой Architectury и кучу зависимостей, которые имеют свойство ломаться при обновлении версии игры. QDResLoader пошёл другим путём: зачем писать свой загрузчик, если в QSL уже есть быстрая и обкатанная система, которой пользуется каждый Quilt-мод? Первая версия мода, 1.0, уместилась примерно в 10 строк Java-кода, включая форматирование. Это не шутка - автор, exaptations, сам приводил этот код прямо в описании. Позже функционал расширился (об этом ниже), но мод остался крошечным. Кстати, проект входит в серию небольших QD-утилит этого же автора, а сам мод в комьюнити иногда сокращают до QDRL. Лицензия - CC0-1.0, то есть мод можно свободно включать в свои сборки и модпаки без всяких ограничений.

Как пользоваться

После первого запуска игры с QDResLoader в корне директории Minecraft появится папка resources, а внутри неё - файл QDResLoader-README.txt с краткой инструкцией. Сам формат вам уже знаком, это стандартная структура любого пака:

• Сама папка resources загружается одновременно как датапак и ресурспак. Кидаете туда data для датапак-контента (рецепты, лут-таблицы, worldgen JSON) и assets для ресурсов клиента (текстуры, модели, звуки). Если добавите свой pack.mcmeta - он учтётся, а если его нет, QSL подставит дефолтный.
• Папка packs - сюда можно складывать целые паки: директории, ZIP-архивы и даже JAR-файлы. Всё это будет загружено как паки обоих типов сразу.
• Папки datapacks и resourcepacks внутри resources - для более строгой организации. Паки из них загружаются только как один конкретный тип, а не как оба.

Отдельно радует поддержка JAR-файлов: если у вас есть моды-однодневки формата "датапак в виде мода", их можно не засорять папку mods, а просто бросить сюда.

Удобный кейс с архивами: если вы управляете сборкой через Packwiz и подтягиваете паки, которые поддерживает кто-то другой, их ZIP-ы можно не распаковывать вообще - просто положите в packs, и мод сам всё подхватит. Меньше возни с распаковкой, проще обновления.

Что изменилось в версии 2.0

Первая версия была минималистичной до предела, но в 2.0 (актуальная подтверждённая сборка - 2.0.1 для Minecraft 1.20.1) добавили вещи, которые делают мод по-настоящему удобным:

• Отображение в стандартных меню. Паки видны в обычных меню "Наборы ресурсов" и "Наборы данных", как родные.
• Отключение отдельных паков. Содержимое основной папки resources выключить нельзя (это сделано специально, чтобы сборки работали гарантированно), а вот паки из packs, datapacks и resourcepacks пользователь может отключать по своему усмотрению. По умолчанию все они включены.
• Изменение порядка загрузки. Паки можно двигать относительно пользовательских, что критично, когда ресурсы перекрывают друг друга.
• Корректная работа worldgen JSON. Свои биомы и структуры через такой пак грузятся нормально, без танцев с бубном.

Совместимость и версии

Тут всё строго: QDResLoader работает только на Quilt. Никаких Forge, NeoForge или Fabric - мод завязан на QSL, и это осознанное решение автора. Зато работает и на клиенте, и на сервере, так что глобальные датапаки можно подгружать и для выделенного сервера. Поддерживаемые версии игры: Minecraft Java 1.18.x, 1.19 - 1.19.2, 1.19.4 и 1.20 - 1.20.1. Учтите, что проект обновлялся довольно давно, самая свежая ветка - 1.20.1. Если вы на новых версиях игры, проверяйте актуальность перед установкой.

Важный нюанс: раз контент основной папки нельзя отключить из меню, кладите туда только то, что должно работать всегда. Всё опциональное - в packs, чтобы игрок мог выключить лишнее сам. Это особенно важно для авторов сборок: твик рецепта, от которого зависит баланс, - в корень, а декоративный ресурспак - в packs.

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

В первую очередь QDResLoader пригодится авторам сборок модов на Quilt - это must-have для доставки обязательных датапаков и ресурсов игрокам без инструкций "зайди в меню и включи". Не зря его используют в таких проектах, как Tinkerer's Quilt/Silk, Common-Sense, Funky Vanilla, Spectralarity, The Personalized Pack и Ennui's Bigger Intro. Но и обычному игроку он полезен: если у вас есть любимый датапак с твиками рецептов или маленький текстурпак, который хочется видеть в каждом мире, просто бросьте файлы в resources и забудьте про ручную настройку.

Скачайте QDResLoader для Майнкрафт 1.20.1 и соберите свою сборку так, как она должна работать из коробки - без объяснений игрокам, куда нажимать.