Vein Miner

Hold Sneak (Shift) and mine an ore block with a suitable pickaxe to harvest the connected vein. Keep sneaking until the chain finishes.

• 19 vanilla ore blocks, including deepslate ores, Nether gold, quartz and ancient debris.
• Fortune and Silk Touch use the held pickaxe and vanilla loot behavior.
• Durability and Unbreaking apply to every extra block. Mining stops with one durability remaining.
• XP orbs and Mending are supported. Silk Touch suppresses ore XP.
• Multiplayer compatible, in the Overworld, Nether and End.
• No mods or resource pack required. Install in the world or on the server.

Connected veins

Blocks touching by faces, edges or corners are connected. Ordinary and deepslate variants of the same resource count as one family; Nether gold is separate.

Each activation mines at most 64 blocks including the first manually mined block, within an 8-block radius of that block. Processing is limited to eight extra blocks per player per tick and 32 per dimension per tick, with no forced chunk loading or continuous world scans.

Release Sneak or change the selected slot or significant pickaxe properties to cancel. Normal wear and Mending repairs do not count as changing tools. Survival activation requires an appropriate vanilla pickaxe and the first block's ordinary drops.

Installation

Put vein-miner-1.0.0-mc26.3.zip directly in the world's datapacks folder without extracting it. Open the world or run /reload, then check /datapack list enabled.

Compatibility

This datapack overrides 19 vanilla ore loot tables, preserving their original loot and appending a temporary activation marker to ordinary drops. The marker is cleared after processing. Other datapacks replacing those same tables require a manual merge.

Extra blocks are mined through commands, so ordinary player mining statistics and some break-event callbacks are not triggered for those blocks. Protection plugins and third-party server implementations are not tested. Creative activation and custom tool-tier definitions are not claimed.

Removal

Run /function vein_miner:uninstall, remove the ZIP and reload. Cleanup covers loaded chunks; jobs or marked items saved in unloaded chunks require those chunks loaded for cleanup. Existing ore, tools and other items stay vanilla.

Vein Miner 1.0.0

Зажмите Shift и сломайте руду подходящей киркой: датапак добудет связанную руду того же типа. Держите Shift до окончания цепочки.

Установка

Положите vein-miner-1.0.0-mc26.3.zip целиком в папку datapacks нужного мира, не распаковывая. Откройте мир или выполните /reload, затем проверьте /datapack list enabled.

Fabric, Forge, ресурспак и клиентские моды не нужны. На сервере датапак устанавливается только в мир сервера. Игрокам не нужны права оператора.

Поддерживаемая руда

• Уголь, медь, железо, золото, лазурит, редстоун, алмазы и изумруды: обычные и глубинные варианты.
• Золотая руда Незера, кварцевая руда и древние обломки.
• Всего 19 блоков и 11 семейств. Обычная и глубинная руда одного ресурса входят в одну жилу; золото Незера обрабатывается отдельно.

Поведение

• Связность учитывает грани, рёбра и углы: все 26 соседей блока.
• Максимум 64 блока за активацию, включая первый сломанный вручную.
• Сферический радиус 8 блоков от первого блока. Несвязанная руда и другие типы блоков остаются нетронутыми.
• До 8 дополнительных блоков на игрока за тик и до 32 на измерение за тик. Работа распределяется на несколько тиков, без постоянного сканирования мира и принудительной загрузки чанков.
• Работает в выживании, для нескольких игроков, в обычном мире, Незере и Энде.

Дроп, опыт и кирка

Дроп дополнительных блоков рассчитывает игра с киркой в руке: Fortune и Silk Touch сохраняют ванильное поведение. Учитывается правильный уровень кирки, включая медную кирку из 26.3.

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

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

Дополнительная руда создаёт обычные орбы опыта в ванильных диапазонах, поэтому Mending работает. С Silk Touch опыт за руду не создаётся.

Отпустите Shift, смените слот или тип/свойства кирки — цепочка остановится. Повреждение кирки и ремонт через Mending сами по себе не считаются сменой инструмента. Выход игрока и отсутствие владельца также останавливают задание.

Совместимость и ограничения

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

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

Перед первым серверным тиком используется текущая кирка в руке; после старта фиксируются выбранный слот и значимые компоненты. Смена повреждения допускается ради износа и Mending. Полностью одинаковая замена предмета в том же слоте неотличима для ванильных команд.

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

Удаление

Сначала выполните /function vein_miner:uninstall, затем удалите ZIP из datapacks и выполните /reload либо перезапустите мир.

Удаление очищает служебные данные на загруженных предметах, собственные objectives и marker-сущности в загруженных чанках. Данные в выгруженных чанках нужно очищать после загрузки этих чанков. Если сразу удалить ZIP, функции остановятся, но могут остаться инертные служебные сущности и objectives; для их очистки можно временно вернуть датапак и вызвать uninstall.