Veinminer

Veinminer - это мод для Майнкрафт, который меняет подход к добыче ресурсов. В ванильной игре, чтобы выкопать целую жилу руды, приходится долбить каждый блок по отдельности - нудно и долго. Veinminer решает эту проблему: ломаешь один блок, и вся связанная цепочка руды или другого материала разрушается за одно действие. При этом у админа сервера куча рычагов управления - лимиты, кулдауны, списки блоков и инструментов. Короче, гринда становится меньше, а контроля - больше.

Работает из коробки на серверной стороне, а если поставить клиентскую часть - появится хоткей (по умолчанию V).

Ключевые фишки

• Добыча жил - ломает соседние блоки одного типа. Система считает TPS и ограничивает нагрузку.
• Способы активации - можно зажать шифт или назначить клавишу; режимы зажатия или переключения.
• Пустая рука - опционально можно активировать даже без инструмента.
• Гибкие списки блоков - глобальные и для каждого инструмента; работает как белый или чёрный список.
• Правила под инструмент - для кирки одни блоки, для топора - другие. Уже есть готовые настройки по умолчанию.
• Учёт удачи и шёлка - зачарования работают как обычно; можно защитить прочность инструмента.
• Кулдаун и лимиты - опциональный кулдаун; статический или динамический максимум блоков за один раз.
• Частицы и контур - серверная подсветка выбранной жилы с настройкой цвета и времени.
• Интеграция с LuckPerms - можно выдать права только определённым игрокам.
• Команда /veinminer test - быстрая проверка, что всё работает.
• Горячая перезагрузка - /veinminer reload без перезапуска; в случае ошибки покажет файл и строку.

Настройка и команды

Быстрый справочник команд

Команда	Описание
/veinminer help	Список команд.
/veinminer reload	Перезагрузить настройки без перезапуска.
/veinminer test	Запустить проверку поведения.
/veinminer toggle	Включить/выключить Veinminer для себя.
/veinminer blocks add/remove/list <блок>	Управление глобальным списком блоков.
/veinminer tools add/remove/list <предмет>	Управление разрешёнными инструментами.
/veinminer settings blockpertool	Включить режим "блоки под инструмент".
/veinminer settings cooldown enable/disable	Включить или отключить кулдаун.
/veinminer settings cooldown set <секунды>	Установить время кулдауна.
/veinminer settings maxblocks <число>	Максимальное количество блоков за активацию.
/veinminer settings luckperms enable/disable	Включить интеграцию с LuckPerms.
/veinminer blockpertool blocks <инструмент> add/remove/list <блок>	Список блоков для конкретного инструмента.
/veinminer blockpertool tool add/remove/list <инструмент>	Управление инструментами в режиме блоков под инструмент.
/veinminer particles enable/disable	Включить подсветку жилы.
/veinminer particles setcolor <r> <g> <b>	Цвет подсветки в RGB.
/veinminer particles setduration <тики>	Время жизни подсветки.
/veinminer togglemessages permission/disabled/cooldown	Включить/отключить конкретные сообщения в чате.

Файлы конфигурации

Создаются в config/Veinminer/ (формат TOML) при первом запуске.

• GeneralConfig.toml - основные настройки: включение, режим активации, проверка прочности, кулдаун, лимиты блоков, частицы, интеграция с LuckPerms, белый/чёрный список, поддержка пустой руки.
• AllowedTools.toml - список разрешённых инструментов. По умолчанию все кирки от деревянной до незеритовой.
• AllowedBlocks.toml - блоки, которые можно добывать жилой. По умолчанию руды из обычного мира, глубинный сланец, незерское золото, кварц, светокамень, древние обломки.
• AllowedBlocksPerTool.toml - заполняется при включении режима "блоки под инструмент".

Права (Permissions)

• veinminer.use - использование мода.
• veinminer.reload - перезагрузка конфига.
• veinminer.settings.manage - управление настройками через команды.
• veinminer.* - все права.
• Для блоков, инструментов, под-инструментного режима и частиц есть отдельные права на управление, добавление, удаление и просмотр.

Совместимость

• Майнкрафт 1.20.x, 1.21.x
• Fabric и NeoForge
• Работает на выделенных серверах и в одиночной игре
• Forge не планируется

Клиентская часть (опционально)

Если поставить клиентскую версию, появится хоткей (по умолчанию V) и состояние клавиши будет передаваться на сервер. Без клиента можно использовать режим приседания (requireCrouch) - и так будет работать на ванильном клиенте.

Планы

• Переводы на разные языки
• Чары Veinminer
• Визуальные подсказки на клиенте
• Статистика добычи

Установка

1. Скачай последнюю сборку для твоей платформы.
2. Закинь .jar в папку /mods.
3. Перезапусти сервер или клиент.
4. Настрой через команды или TOML-файлы.

Другие проекты

• Hammer Mining - зачарование на 3x3 добычу через кирку-молот.