Litematica Printer 4th

Litematica Printer 4th — это клиентское расширение для Fabric для Litematica. Оно непрерывно находит незавершённые позиции схематики и обрабатывает их через ограниченный многопоточный планировщик «производитель-потребитель». Печать, заполнение, удаление жидкости и разрушение бедрока — независимые режимы.

Требования

Установите эти клиентские зависимости для той же версии Minecraft:

• Fabric Loader
• Fabric API
• MaLiLib
• Litematica

Проверенные базовые версии — MaLiLib 0.28.8 с Litematica 0.27.9 на Minecraft 26.1.2 и MaLiLib 0.29.2 с Litematica 0.28.3 на Minecraft 26.2. Совместимые более новые релизы Litematica также могут работать в пределах заявленного диапазона Minecraft.

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

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

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

Что изменилось в четвёртой ревизии

Непрерывное планирование «производитель-потребитель»

• Производитель непрерывно сканирует неизменяемые снимки мира и схематики вместо чередования полного поиска и прохода печати.
• Работа поиска делится на мелкие задачи и обрабатывается настраиваемым пулом воркеров без чтения живого мира из рабочих потоков.
• Ограниченный пул задач группирует задачи размещения, настройки состояния, использования и ломания по типу транзакции.
• Потребитель обходит корзины задач равномерно и объединяет совместимые задачи, снижая переключение предметов и не позволяя одной пропущенной позиции блокировать несвязанную работу.
• Обработанные, неудавшиеся, пропущенные, устаревшие задачи и задачи с недоступными материалами — все потребляются. Если позиция всё ещё требует работы, более позднее сканирование производителя найдёт её снова.
• Действия потребителя проверяют живой мир перед выполнением, поэтому старый снимок не может навязать устаревшее действие.

Меньше накладных расходов на сканирование

• Формы рабочей зоны и рабочие пространства схематики/выделения компилируются в переиспользуемые пространственные маски.
• Статистика GUI и обнаружение принтера переиспользуют совместимые планы поиска и общие страницы снимков.
• Курсоры поиска читают упакованные данные страниц напрямую и создают объекты BlockPos только для позиций, которые становятся задачами.
• HUD публикует завершённую статистику, а не отображает частичный текущий проход производителя.

В свежем A/B-бенчмарке Minecraft 26.2 с тем же набором из 531 441 позиции, четырьмя потоками поиска, двумя разогревочными раундами и семью измеряемыми раундами медианное время полного сканирования GUI + принтера упало с 457.45 ms в 1.0.0 до 45.59 ms в 1.1.0 — примерно в 10.0x быстрее на системе разработки. Смотрите примечания к релизу 1.1.0 — там методология, проверки корректности и оговорки.

Предсказуемая обработка предметов и действий

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

Возможности

Режимы работы

• Print: ставит недостающие блоки, корректирует поддерживаемые состояния блоков и по желанию ломает неправильные или лишние блоки.
• Fill: заполняет активное выделение Litematica с настраиваемыми фильтрами блоков и направлений.
• Удаление жидкостей: убирает настроенные стоячие или текущие жидкости внутри выбранной рабочей области.
• Разрушение бедрока: находит задачи по бедроку и передаёт их поддерживаемому моду добычи бедрока.

Устаревший универсальный режим добычи и встроенный удалённый склад удалены.

Особые действия печати

Существующее поведение операций с блоками остаётся доступным, включая:

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

Обратная связь и управление

• Стабильный прогресс завершения и HUD нехватки материалов.
• Текущая активность потребителя, причина ожидания, позиция задачи и длина пула задач.
• Прогресс сканирования производителя для текущего раунда.
• Настраиваемые подсветки установки для действий place, adjust, break и failed.
• Форма рабочей зоны, порядок обхода, направление оси, число потоков поиска и лимиты действий за тик.
• Фильтрация видимых слоёв Litematica учитывается как при поиске, так и при выполнении.

Начало работы

1. Установите правильный jar принтера и необходимые зависимости.
2. Загрузите и разместите схему с помощью Litematica.
3. Нажмите Z, затем Y по умолчанию, чтобы открыть настройки принтера.
4. Включите модуль Print или другой режим работы, который хотите использовать.
5. Подойдите в пределах дистанции взаимодействия до целевых блоков.
6. Нажмите Caps Lock, чтобы включить глобальный Work Switch.

Должны быть включены и глобальный Work Switch, и переключатель конкретного режима работы. Рабочая зона по умолчанию 0 автоматически использует доступную дистанцию взаимодействия.

Важные настройки

• Блоков за тик / интервал работы: управляет пропускной способностью. Серверы с ограничениями скорости или анти-читом могут потребовать меньших значений или более длинного интервала.
• Ставить в воздухе: позволяет ставить блок без существующего соседнего блока-опоры там, где сервер это принимает.
• Установка пакетами: использует альтернативный путь установки через отправку пакетов. Он не обходит серверную валидацию или потери сети.
• Подтверждение удерживаемого предмета через Servux: ждёт серверно-авторитетный предмет в основной руке после переключения. Если включено без совместимого сервера Servux, принтер намеренно приостанавливается и сообщает это состояние ожидания.
• Ломать неправильные/лишние блоки: требует ChainVeinFabric. Без него разрушительные задачи печати не включаются.
• Источник Quick Shulker: выберите Quick Shulker, AxShulkers или TakeItOut в соответствии с реально установленным окружением.

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

Принтер ничего не делает

Проверь, что:

• jar соответствует точной версии Minecraft;
• загружены Fabric API, MaLiLib и Litematica;
• схематика размещена и её нужный слой виден;
• включены и выбранный режим, и глобальный Work Switch;
• игрок находится в пределах настроенной рабочей дистанции;
• нужный предмет доступен и HUD не сообщает об ожидании руки или шалкера;
• серверный античит или лимиты на установку блоков не отклоняют настроенную скорость.

Задания на разрушение никогда не выполняются

Задания на неправильный блок, лишний блок и разрушение льда требуют ChainVeinFabric. Задания на бедрок дополнительно требуют один из поддерживаемых модов для добычи бедрока.

HUD сообщает, что ждёт Servux

Подтверждение удерживаемого предмета с приоритетом сервера было включено, но текущий сервер не предоставил совместимый канал Servux. Установи/настрой Servux на сервере или отключи эту опцию подтверждения.

Быстрое извлечение из шалкера ждёт или недоступно

Убедись, что выбранный источник шалкера соответствует установленной интеграции. Для прямого протокола Quick Shulker держи клиент и сервер на одной совместимой версии. Состояние ожидания в HUD показывает, ждёт ли принтер операции с контейнером или переключения предмета.

Для воспроизводимых багов открывай issue в этом репозитории и прикладывай логи клиента и сервера, версии Minecraft/модов, соответствующие настройки и, по возможности, минимальную схематику.

Лицензия

Этот проект распространяется под GNU Affero General Public License v3.0.