Загрузчики

Laminara собирает клиент с любым из шести загрузчиков. Список версий каждый загрузчик тянет из своего источника, поэтому новые версии появляются сами — править Laminara под них не нужно.

laminara-server exec loaders 1.21.1

Команда показывает загрузчики, доступные для версии, и их актуальные версии. Загрузчик, которого для этой версии Minecraft нет в каталоге, в списке не появится — так, для 1.20.1 NeoForge не покажется, потому что Laminara опрашивает каталог, где она начинается с 1.20.2.

Два типа загрузчиков

По способу сборки загрузчики делятся на две группы, и разница существенная.

Аддитивные — Fabric, Quilt

Эти загрузчики только добавляют библиотеки к ванильному клиенту и меняют главный класс. Ванильный client.jar остаётся нетронутым. Сборка сводится к тому, чтобы дописать нужные библиотеки к тем, что уже пришли от Mojang, — быстро и без сюрпризов.

Трансформирующие — Forge, NeoForge, Cleanroom

Их клиент нельзя получить простым добавлением библиотек. Официальный установщик прогоняет цепочку процессоров — это Java-программы, которые патчат ванильный client.jar: накладывают бинарные патчи, применяют маппинги, переименовывают классы. На выходе — отдельный client.jar загрузчика и запуск через свой bootstrap с путём модулей.

Laminara повторяет то, что делает установщик, без графического интерфейса: скачивает установщик, читает install_profile.json, тянет библиотеки процессоров, извлекает встроенные артефакты и патчи и по очереди запускает каждый процессор. Forge, NeoForge и Cleanroom используют один формат установщика, поэтому обрабатываются одним и тем же кодом.

Java для сборки

У трансформирующих загрузчиков есть тонкость. Процессоры запускаются на сервере во время подготовки, а Java, которая попадёт в сборку, — под платформу игрока (часто Windows). Запустить виндовую Java на Linux-сервере нельзя.

Поэтому для прогона процессоров сервер отдельно скачивает серверную Java под Linux нужной мажорной версии. Она нужна только на время сборки и в клиент не попадает. От вас никаких действий не требуется — всё скачивается автоматически.

Заметка

Именно из-за запуска Java базовый образ Docker — debian:12-slim с glibc, а не минимальный distroless. Скачанный JDK динамически слинкован и на образе без glibc не запустится.

Версии обновляются сами

Источники версий:

• Fabric, Quilt — их meta-серверы.
• NeoForge — maven-каталог NeoForged (JSON).
• Forge — maven-metadata.xml MinecraftForge.
• Cleanroom — релизы на GitHub. Он бывает только под 1.12.2, поднимает Java до 25 сам и выходит только с пометкой alpha — команда скажет об этом при сборке. Подробнее — в разделе Старые версии на новой Java.

Список фильтруется по версии Minecraft, новые сборки загрузчиков подхватываются без изменений в Laminara.

Forge до 1.13 устроен иначе, и Laminara собирает его тоже. Установщик тех лет носит с собой готовый jar загрузчика и список библиотек вместо процессоров: клиентский jar остаётся ванильным, а Forge подключается через launchwrapper и --tweakClass. Это разбирается автоматически — выбор версии ничем не отличается.

Заметка

Часть библиотек тех сборок ссылается на репозитории, которых давно нет (files.minecraftforge.net, central.maven.org). Laminara подменяет их на живые зеркала и, если библиотеку не отдал один репозиторий, спрашивает следующий.

Версии, которые сами по себе не запустятся

Minecraft 1.7.10 и 1.12.2 не работают на современной Java. Для них есть отдельный ход — рецепты совместимости и загрузчик Cleanroom, про них написано в Старые версии на новой Java.