Vein-Breaker

Vein-Breaker: плагин для добычи рудных жил и деревьев

Vein-Breaker — это легковесный и настраиваемый плагин для серверов выживания, призванный упростить процесс добычи ресурсов. Он позволяет добывать целые рудные жилы, геоды, пещерные структуры, падать деревья и собирать урожай за один удар инструментом. Плагин также предоставляет функции для размещения блоков с анимацией, защиты инструментов от поломки, автоматического сбора опыта и настройки активации через клавиатуру. Полностью совместим с платформами Spigot, Paper и Bukkit на версиях игры от 1.21 до 26.2.

Основные возможности добычи

Плагин группирует связанные блоки по минеральным семействам, позволяя ломать их единым движением. Это работает для всех типов руд в мире, Незере и глубоком сланце, включая уголь, железо, медь, золото, редстоун, лазурит, алмаз, изумруд, нефертитское золото, нефертитный кварц, древнюю обломку и их глубокие сланцевые варианты. Также поддерживаются блоки с сырой рудой, такие как RAW_IRON_BLOCK, RAW_COPPER_BLOCK и RAW_GOLD_BLOCK.

Для геод плагин автоматически собирает кристаллы аметиста, ростки аметиста, блоки аметиста, кальцит и гладкий базальт. В пещерах можно добывать остроконечные сталактиты, блоки сталактитов, структуры скалка, варианты туффа и образования скелета глубокого темного (SCULK, SCULK_CATALYST, SCULK_SENSOR, SCULK_SHRIEKER, SCULK_VEIN).

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

Защита инструментов и инвентаря

Одной из ключевых особенностей является защита инструментов от поломки. Плагин автоматически останавливает добычу жил, когда выносливость инструмента падает до 1, гарантируя, что ваши инструменты высшего ранга не будут потеряны. Урон по выносливости рассчитывается с учетом энкаунтера Unbreaking по формуле unbreaking / (unbreaking + 1) для каждого блока.

Полученные ресурсы направляются напрямую в инвентарь игрока (behaviour.direct-to-inventory: true), что предотвращает потерю предметов в лавовые озера, каньоны или бездну. Избыточные предметы падают естественным образом в месте блока. Опыт от руд автоматически заполняет шкалу опыта игрока (behaviour.xp-auto-collect: true), предотвращая задержку из-за орбит опыта. При использовании энкаунтера Silk Touch опыт не падает, что соответствует правилам ванилы.

Анимация и частицы

Вместо мгновенного и резкого разрушения множества блоков, плагин может распространять разрушение во внешние волны. Настройте задержку между шагами волны (delay-ticks, по умолчанию 1 тик = 0.05 сек) и количество блоков на шаг (blocks-per-step, по умолчанию 2 блока). Волна может распространяться от позиции игрока (PLAYER) или от кликнутого блока (ORIGIN).

Звуковые эффекты постепенно меняют высоту тона в течение волны, создавая удовлетворяющий звук ряби. Частицы включают в себя нативное разрушение блока (событие Effect.STEP_SOUND), динамический взрыв разлома из 25 направленных частиц Particle.BLOCK и минеральные искры: звезды из End Rod для аметиста, призраки души для скелка, искры критических ударов для алмазов и изумрудов, а также магические блики для золота, меди и редстоуна.

Размещение блоков и активация

Плагин позволяет размещать блоки, соответствующие тем, что были добыты, с последовательной анимацией во внешние волны. При пригнутии (Sneak) можно строить полы, потолки или стены. Расширение ограничено строго двумерной плоскостью, перпендикулярной кликнутой грани. Поддержка проверяет, что соседние блоки имеют одинаковый материал поддержки, предотвращая появление парящих блоков. По умолчанию эта функция отключена (features.block-placement: false).

Существуют несколько режимов активации. Режим «Всегда включен» (sneak-to-activate: false) позволяет ломать жилы автоматически после выполнения команды /vb. Режим «Удерживание для активации» (Shift/Sneak или Ctrl/Sprint) требует удержания соответствующей клавиши для активации добычи. Для режима творчества (behaviour.allow-creative: true) операторы могут ломать жилы без засорения инвентаря для быстрого терраформирования.

Команды и управление правами

Все команды поддерживают как полный /veinbreaker, так и сокращенный /vb. Основные команды включают /vb для включения/выключения, /vb toggle как алиас, /vb place для размещения блоков, /vb anim для анимации, /vb status для отображения настроек, /vb help для списка команд и /vb reload для перезагрузки конфигурации без рестарта сервера.

Права доступа включают veinbreaker.use для использования функций (по умолчанию OP), veinbreaker.admin для административных команд, veinbreaker.reload для перезагрузки и veinbreaker.help для просмотра помощи (доступно всем). Можно добавлять кастомные узлы прав из сторонних плагинов через config.yml или команду /vb permission add.

Дополнительные настройки и защита

Плагин поддерживает защиту растущего аметиста (features.protect-budding-amethyst: true), чтобы предотвратить случайное разрушение блоков, спавнящих кристаллы. Детекция жил использует сканирование соседей 3x3x3 с 26 соседями, чтобы мостить диагональные зазоры и не обрезать естественные жилы.

Можно отключить функционал в конкретных мирах (например, спавн, хабы, мини-игры) через черный список миров. Предпочтения игрока сохраняются между перезапусками сервера через playerdata.yml. Все сообщения чата поддерживают стандартное форматирование цветов Minecraft с использованием & и плейсхолдеров. Также предусмотрены независимые таймеры охлаждения для каждой функции, чтобы предотвратить спам и сохранить производительность сервера.

Совместимость и установка

Плагин полностью протестирован и совместим с версиями Minecraft от 1.21 до 26.2. Он работает на платформах Spigot, Paper и Bukkit. Рекомендуется использовать Paper для оптимальной производительности планировщика. Для установки необходимо скачать файл VeinBreaker-2.0.0.jar и поместить его в директорию plugins/ сервера. После этого можно перезагрузить сервер или выполнить команду /vb reload для применения изменений конфигурации.

Плагин не требует зависимостей от других модов. Лицензия MIT позволяет свободное распространение. Плагин не поддерживает клиентскую сторону и предназначен исключительно для сервера.

Связанные материалы

• BetterStructures — похожий плагин
• EliteMobs — похожий плагин

Автор: Usama-Balhasal · Лицензия: MIT