Litematica-Printer-Hana

Litematica Printer — Hana

Litematica Printer — Hana — это клиентский мод для Fabric, который добавляет в Litematica автоматическую постройку по схематике. Он восстанавливает схематику, расставляя нужные блоки вокруг игрока, а также даёт возможности заливки, удаления жидкостей, копания, ломания бедрока, помощи с инвентарём и другие утилиты.

Этот репозиторий — независимо поддерживаемое продолжение ранних форков Litematica Printer, с переписанным процессом ломания бедрока, улучшениями сканера и итератора, а также дополнительными функциями для строительства.

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

• 1.18.2
• 1.19.4
• 1.20.1, 1.20.2, 1.20.4 и 1.20.6
• с 1.21 по 1.21.11
• 26.1.x и 26.3

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

Требования

Обязательные:

• Fabric Loader
• Fabric API
• MaLiLib
• Litematica

Необязательные интеграции:

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

Версии зависимостей должны совпадать с запускаемой версией Minecraft.

Возможности

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

• Расстановка от игрока с сортировкой по расстоянию.
• Кэширование сканера и итерация с ограничением по времени для больших областей схематики.
• Расстановка через пакеты для более быстрой работы без клиентских фантомных блоков.
• HUD прогресса расстановки и нехватки материалов.
• Защита от серверных лагов и задержки отклика при печати из разных материалов.
• Более безопасная обработка блоков с направлением и зависящих от состояния.

Инструменты строительства

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

Интеграции с инвентарём

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

Также в принтере есть особая логика расстановки для многих ванильных блоков, включая ступени, двери, люки, воронки, сундуки, рычаги, редстоун-провод, лианы, висячие растения, точильные камни, крафтеры, цветочные кластеры и другие блоки с направлением.

Основное использование

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

У большинства параметров есть подсказки в интерфейсе конфигурации. Официального полного руководства пока нет.

Известный неподдерживаемый контент

Некоторый контент в настоящее время не может быть надёжно установлен и может быть пропущен или размещён с неправильным состоянием:

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

Если ванильный блок размещается неправильно даже при консервативном рабочем интервале, отправьте отчёт о поддержке блока.

Решение проблем

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

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

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

• Серверный античит или высокий пинг могут помешать принятию симулированного вращения.
• Рабочий интервал может быть слишком коротким, чтобы сервер успел подтвердить смену материала и размещение.
• Блоку может требоваться логика размещения, которая ещё не реализована. Пожалуйста, укажите его ID блока, целевое состояние, версию Minecraft, версию принтера и воспроизводимый пример в issue.

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

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

Поддержка и участие

• Используйте GitHub Discussions для помощи с установкой, вопросов по настройке, обсуждения совместимости и общего фидбека.
• Используйте GitHub Issues только для воспроизводимых багов, проблем с поддержкой блоков и конкретных предложений функций.
• Перед созданием нового отчёта поищите существующие Issues и Discussions.
• Держите одну независимо воспроизводимую проблему на один Issue и прикладывайте latest.log, отчёты о крашах, скриншоты или короткие записи, где это уместно.

Благодарности

• bunny_i за широкую поддержку и вклад в проект.
• aleksilassila/litematica-printer за оригинальный проект.
• zhaixianyu/litematica-printer за ранние исправления и функции.
• MoRanpcy/quickshulker за интеграцию Quick Shulker.
• bunnyi116/fabric-bedrock-miner за основу для ломания бедрока.
• Всем, кто тестирует, сообщает об issue, вносит код или поддерживает проект.

Лицензия

Этот проект лицензирован под GNU Affero General Public License v3.0.