Ultimate VeinMiner

VeinMiner is a function that enables you to break a bunch of same blocks attached to each other by mining just one of them. This data pack implements the function with vanilla commands, making your gameplay more comfortable even in vanilla versions of Minecraft.

Features

• Fully customizable from blocks which can be vein-mined to tools that can trigger vein-mining for a certain type of block.
• User-friendly configuration menu.
• Compatible with nearly all vanilla and modded blocks.
• Various settings to achieve best experience, including safety measures to prevent you from accidentally vein-mining your masterpiece.
• Simulation of tool enchantment's effect as well as hunger and tool durability's behavior, like real mining.
• Vein-mining animation that gradually breaks the blocks in the vein layer by layer.
• Multiplayer compatibility.

This data pack uses the experimental feature: Dialog, you may need to rejoin the world or restart the server after (un)installing the data pack!
You need to download the required language resource pack and install it. The data pack is then ready-to-use. You may also read the "Notes & Tips" part at the bottom if you ran into a problem or report an issue. If you want to customize the data pack, please read the following information.

Planned Update: Treecapitator integration

Settings

You can find the settings menu in the data pack's info menu, which you can access from Minecraft's Game Menu or Quick Actions menu. You can also directly access the data pack's settings menu by running command:

/function ultimate_veinminer:setting

All available settings are described below:

Configuration & Other Functions

You can also find the following configurations in the data pack's settings menu.

VeinMiner Block List

The list of all blocks that you can vein-mine.

This list by default contains most of the ores and logs in vanilla Minecraft. You can add blocks to this list (by entering block ID) or remove blocks from this list at any time.
From here you can access the block menu of each block, which contains detailed information. Here you can modify the block's mine loot (if the data pack failed to generate it correctly) or reset its watch lists, which is crucial for triggering vein-mining.
There are also other useful functions such as adding your targeted block (the block you are looking at) to the list or automatically regenerate cached information of all block's mine loot.

You may explore the data pack and discover all the practical functions on your own.

Commands

Here are some commands you can use for your own convenience.

/function ultimate_veinminer:help

/function ultimate_veinminer:setting

/function ultimate_veinminer:disable

/function ultimate_veinminer:enable

/function ultimate_veinminer:uninstall

Notes & Tips

1. There are a few requirements for triggering vein-mining. If vein-mining is not triggered as expected, check the following conditions:
   • Loot items entity appears after you mined the block (your mining tool is "correct for drop" and game rules are properly set)\
   • You are holding an item in your main hand\
   • (When [Tool Only] setting is true) The item has a "minecraft:tool" item stack component, typically for mining tools like axes and pickaxes\
   • The item doesn't have "Silk Touch" enchantment or [Enable Silk Touch] setting is true\
   • The item is on the list of Accepted Tool for the type of the block you've mined\
   • You press or release your sneak key bind according to [Safety Mode] setting\
2. During vein-mining animation, you can interrupt the process by stop holding the tool you used for mining. For example, simply switch to another hotbar slot. This is meant to minimize the damage caused by accidentally triggering vein-mining.
3. Avoid vein-mining container blocks (e.g. chests, barrels) in case the stored items get deleted, although this shouldn't technically happen.
4. Your hunger bar will decrease and the tool you use will get damaged as if you mined all these blocks one by one. All enchantments and data components of the mining tool will also be taken into account, affecting the amount of durability consumed and loot you get from mining blocks.
   · Mechanics like the enchantment "Mending" will only be applied after the vein-mining has been executed.
5. Avoid mining blocks with items that has durability but not tool (e.g. helmets) to trigger vein-mining in case of unexpected durability drop.
6. Don't add blocks that have inconsistent mine loot or no mine loot (e.g. leaves) to VeinMiner Block List, vein-mining cannot (always) be triggered for these blocks.
7. NEVER mine too many blocks in a single vein! Limit the maximal block count using [Max Blocks] setting. Mining too many blocks in a single vein may lead to unexpected behaviors and huge latency.
   · If errors occur even when mining a small vein, try setting the game rule "maxCommandChainLength" or "minecraft:max_command_sequence_length" to a bigger value.