Litematica Printer - Hana

Litematica Printer - Hana - клиентский мод для Fabric, который превращает Litematica из обычного просмотрщика схем в рабочий автопостроитель. Если вы когда-нибудь вручную выставляли по чертежу стену на десятки тысяч блоков, вы понимаете, о чём речь. Принтер сам расставляет нужные блоки вокруг игрока, а вам остаётся лишь ходить рядом с областью схемы. Зайдёт тем, кто строит мегабазы и копирует чужие постройки по схемам, а не тем, кто любит класть каждый блок руками.

Это не один мод, а целая связка. Принтер работает поверх Litematica и тянет за собой библиотеки, так что без Litematica, MaLiLib и Fabric API он просто не запустится. По сути Hana-ветка - это самостоятельно поддерживаемое продолжение нескольких старых форков Litematica Printer, включая разработки aleksilassila и zhaixianyu. Здесь переписали логику ломания бедрока, ускорили сканер и добавили кучу строительных инструментов.

Что именно умеет принтер

Печать и производительность

• Размещение блоков от игрока с сортировкой по расстоянию.
• Кэширование сканера и пошаговая итерация по бюджету времени - это критично на огромных схемах, где всё сразу просто не переваривается.
• Пакетная установка блоков для скорости и без клиентских фантомных блоков (ghost blocks).
• HUD с прогрессом постройки и списком недостающих материалов.
• Защита от серверного лага и учёт round-trip time, чтобы не сыпались ошибки при печати из разных материалов.
• Аккуратная работа с блоками, у которых есть направление или сложное состояние.

Строительные инструменты

• Заполнение активной схемы или выделенной области.
• Осушение источников воды и лавы.
• Массовая добыча блоков в выделении.
• Отдельная обработка лишних блоков и блоков с неправильным состоянием.
• Режим разрушения бедрока с белым списком (allowlist).
• Установка блоков в затопленном виде и добыча воды из шалкеров при ломании льда.
• Замена мёртвого коралла в схеме на живой.

Работа с инвентарём

• Быстрая выдача материалов из шалкеров через Quick Shulker и обратный возврат по порядку.
• Удалённая выдача материалов через Take It Out на поддерживаемых версиях.
• Защита при смене материала, чтобы случайно не поставить блок старым предметом из хотбара.

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

Поддерживаемые версии Minecraft

Ветка	Версии
Старые	1.18.2, 1.19.4
1.20	1.20.1, 1.20.2, 1.20.4, 1.20.6
1.21	1.21 - 1.21.11
Новые	26.1.x, 26.3

Всё, что старше 1.18.2, не поддерживается. Промежуточные версии Майнкрафт иногда работают, если попадают в тот же диапазон совместимости, но отдельные JAR под них собирают не всегда. Так что не удивляйтесь, если нужной цифры в списке нет.

Требования

Обязательные зависимости:

• Fabric Loader
• Fabric API
• MaLiLib
• Litematica

Опциональные интеграции:

• Tweakeroo
• Quick Shulker
• Take It Out на поддерживаемых 1.21.x и 26.x

Версии зависимостей обязаны совпадать с версией Minecraft, которую вы запускаете. Это, пожалуй, самая частая причина, почему принтер "не видит" схему или вообще не грузится.

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

1. Загрузите схему в мир через Litematica.
2. Подойдите в зону взаимодействия с блоками схемы.
3. Нажмите Caps Lock, чтобы включить принтер.
4. Если сервер капризничает - подкрутите настройки принтера в меню конфигурации.

Почти у каждой опции есть всплывающая подсказка прямо в интерфейсе. Полного официального туториала пока нет, так что настройки придётся щупать руками.

Совет. Caps Lock - раскладка не должна вас смущать, клавишу при желании меняют в конфиге. И начинайте с маленького участка: проверьте, как сервер реагирует на скорость печати, прежде чем запускать весь чертёж.

Что печатается плохо

Часть контента сейчас ставится ненадёжно, а иногда просто пропускается или получает неверное состояние:

• Черепа, таблички, баннеры и другие блоки со сложным состоянием или данными.
• Котлы с жидкостями.
• Сущности вроде рамок, стоек для брони и картин.
• Не-ванильный контент, если он не поддержан явно.

Если ванильный блок встал криво даже на консервативном интервале работы - это повод оставить отчёт о поддержке блока.

Если что-то не работает

Принтер не реагирует после включения

• Некоторые анти-чит системы отклоняют тихий поворот или взаимодействие принтера.
• Слишком короткий интервал работы упирается в лимит скорости установки на сервере. Увеличьте интервал или попробуйте пакетную печать, если сервер её тянет.
• Состояние аккаунта или сессии иногда мешает пакетам взаимодействия. Переподключение к серверу помогает.

Блоки ставятся с неправильным состоянием

• Анти-чит или высокий пинг мешают серверу принять симулированный поворот.
• Интервал работы слишком короткий, и сервер не успевает подтвердить смену материала и установку.
• Для блока ещё не реализована нужная логика. В таком случае указывайте ID блока, целевое состояние, версию Minecraft, версию принтера и воспроизводимый пример.

Quick Shulker не работает

• Сервер должен поддерживать открытие шалкеров из инвентаря для выбранного режима интеграции.
• Настроенный режим должен совпадать с тем, что реально доступно на сервере.
• В pickBlockableSlots Litematica должны быть рабочие слоты хотбара, и их не стоит полностью забивать шалкерами.

Важный нюанс про серверы

Это ключевой момент, который многие пропускают. Принтер - клиентский, но автоматическое размещение блоков легко палится и часто прямо запрещено правилами. Отдельные серверные своды правил специально сравнивают Hana-форк с обычным Litematica Printer и банят оба как "принтеры". Так что перед использованием на чужом сервере читайте правила: схема-просмотрщик и схема-принтер - это две разные вещи с точки зрения администрации. Для одиночной игры или своего сервера вопросов нет.

История проекта

Hana-ветка выросла из оригинального litematica-printer и более ранних форков, а часть механик пришла из сторонних наработок - например, за разрушение бедрока отвечает фундамент из fabric-bedrock-miner, а интеграция с Quick Shulker основана на отдельном моде. Сейчас в публикациях есть beta-ветка Hana-Beta25 и alpha-сборки Hana-Dev428, где заявлены переработка рабочего процесса печати и сканирования, исправления перезапуска печати и звуков добычи. Ранее добавляли HUD недостающих материалов и проверку неправильных состояний блоков.

Проект распространяется под лицензией GNU Affero General Public License v3.0.

Скачайте мод Litematica Printer - Hana и закройте вопрос с ручной сборкой больших схем - но сначала убедитесь, что ваши версии Fabric Loader, Litematica и MaLiLib совпадают с версией Minecraft.