Earlier Versions
| Name | Size | Uploaded | Game Version | Downloads | |
| VeinMiner release | 164.20 KB | Jan 4, 2022 | 1.18.1 | 84 | Download |
Description
Minimum Java Version: Java 8 (planned to upgrade to Java 16)
Collects anonymous statistics: https://bstats.org/plugin/bukkit/VeinMiner
– Types of blocks mined in the previous update cycle
– The amount of players actively using the optional client mod
– Names and versions of installed anti cheats

If you have ever used the Minecraft Forge mod, VeinMiner, this plugin aims to recreate exactly that in an efficient, flexible and feature-filled way. Anything you've ever seen from the VeinMiner mod should be in the VeinMiner plugin, of course with a few minor feature changes due to the limitations of server modifications. If you have not yet used the VeinMiner mod… play more mod packs.
VeinMiner allows players to mine an entire vein of ores whilst sneaking and breaking an ore. It will break the entire vein when only needing to break one ore. Much like the original mod, there is an extremely powerful block list which can be modified in-game, as well as in the configuration file, to determine which blocks (and which data values) are capable of being vein mined. The lists are separated by tools and can be grouped by aliases to allow for a more flexible and simplistic mining experience. This is a fantastic perk for Prison, Factions and Semi-Vanilla servers that isn't overpowered, but still gives players a rewarding benefit for donating to your server.
Supports the following anti cheats:
- NoCheatPlus
- AAC (Advanced AntiCheat) 5.x
- Spartan
- AntiAura
- Matrix 6.x
Supports the following placeholders (PlaceholderAPI):
- %veinminer_enabled%: Whether or not VeinMiner is toggled on
- %veinminer_enabled_category_<category>%: Whether or not VeinMiner is toggled on for a given category
- %veinminer_active%: Whether or not VeinMiner is active (e.g. the player has the keybind pressed)
DISCLAIMER: I am in no way related to or in collaboration with the Minecraft Forge VeinMiner project, or the creator portablejim. This is simply a recreation of a popular mod to be enjoyed on CraftBukkit / Spigot servers.
Want to use custom keybinds!?
VeinMiner does not natively support custom keybinds because it is a server-sided mod. However, by getting your players to install VeinMiner4Bukkit, a Fabric mod made by the same developer, Choco, your players can assign and use custom keybinds!

Commands for VeinMiner are lacking in features, but they can be useful for configuring most of the resource without having to open the configuration file, and they accomplish their purpose.
/veinminer [alias: "/vm"]:
Sub-commands:
<version> - Retrieve version information of the VeinMiner currently installed on your server
<blocklist> <*category> - Categories are the same as those listed in the categories.yml, or "hand"
<remove> minecraft:block[state=value] [blocks…] - Remove one or more block(s) from the category's block list (block states – the data in the [] – are optional)
<list> - List all blocks currently on this category's block list
<toollist> <*category> - Categories are the same as those listed in the categories.yml, or "hand"
<remove> <tool> [tools…] - Removes one or more tool(s) to the category's tool list
<list> Lists all tools in the category's tool list
<toggle> [category] - Toggle vein miner on or off for all (or specific) categories
<mode> <mode> - Set the mode that VeinMiner should use to activate for you (the player). Can be either "sneak", "stand" or "always"
<pattern> <namespace:key> - Set the pattern to be used while vein mining
Example:
– /veinminer blocklist pickaxe add minecraft:chest[waterlogged=true] stone minecraft:diamond_ore
– /veinminer blocklist shovel remove dirt
– /veinminer toollist shears add stick
– /veinminer toollist my_custom_category remove minecraft:stone diamond_pickaxe
– /veinminer toggle axe
– /veinminer mode sneak
– /veinminer pattern veinminer:default

veinminer.veinmine.*:
Default: All players have this permission by default
Children:
veinminer.blocklist.*:
Default: Operators have this permission by default
Children:
veinminer.blocklist.remove: Allow access to the "/veinminer blocklist remove" sub-command
veinminer.blocklist.list.*: Allow access to the "/veinminer blocklist list" sub-command for all blocks
veinminer.toollist.*:
Default: Operators have this permission by default
Children:
veinminer.toollist.remove: Allow access to the "/veinminer toollist remove" sub-command
veinminer.toollist.list.*: Allow access to the "/veinminer toollist list" sub-command for all blocks
veinminer.blocklist.list.*:
Default: Operators have this permission by default
Children: (this is a dynamic permission node)
veinminer.toollist.list.*:
Default: Operators have this permission by default
Children: (this is a dynamic permission node)
veinminer.reload:
Default: Operators have this permission by default
veinminer.toggle:
Default: All players have this permission by default
veinminer.mode:
Default: All players have this permission by default
veinminer.pattern:
Default: Operators have this permission by default
veinminer.free.*:
Default: No players have this permission by default. It must be explicitly set
Children:
veinminer.free.hunger: Grants a bypass to the VeinMiner hunger debuff. Only used if hunger modifier is greater than 0
veinminer.client.reminded:
Default: Nobody has this permission by default

config.yml:
MetricsEnabled: true
PerformUpdateChecks: true
DefaultActivationStrategy: SNEAK # The default activation strategy to set for players that have not explicitly set it
VeinMiningPattern: 'veinminer:expansive' # The vein mining pattern to use. For most users, this should remain default
SortBlocklistAlphabetically: true # Whether or not to sort the block list alphabetically when disabled with a command
CollectItemsAtSource: true # Whether items from vein mines will be dropped at the source block
NerfMcMMO: false # If true, only grants McMMO experience for the FIRST block mined in a vein, as opposed to all blocks if false
RepairFriendlyVeinminer: false # Whether or not VeinMiner will stop vein mining if the tool reaches 1 durability while mining
IncludeEdges: true # Whether to search for blocks diagonally when vein mining
MaxVeinSize: 64 # The maximum size of a vein for all categories (unless otherwise specified in the categories.yml)
Cost: 0.0 # The cost per use of vein miner. This requires Vault and an economy plugin to be installed
Hunger: # Various hunger-related options
HungerModifier: 4.0 # How much exhaustion is applied for every block broken while vein mining. Every point is 0.025 hunger/exhaustion per block
MinimumFoodLevel: 1 # The minimum food level required to vein mine. If vein mining while this value is hit, it will stop
HungryMessage: "&7You are too hungry to vein mine!" # The message to send the player when they are too hungry
DisabledGameModes: # A list of game modes in which VienMiner is disabled
– CREATIVE
– SPECTATOR
DisabledWorlds: # A list of all worlds in which VeinMiner is disabled
– WorldName
Client: # Options that allow better control over the optional client-sided mod
AllowClientActivation: true # Whether or not to allow the use of VeinMiner4Bukkit
DisallowedMessage: # The message to send to clients with the mod installed if AllowClientActivation is disabled. Set to [] to not send a message
- "&7&oThe VeinMiner client mod is disabled on this server."
SuggestClientModPeriod: "1d" # The time period to remind players without VeinMiner4Bukkit installed to install it. -1 to not remind, or format: 1w2d3h4m5s
SuggestionMessage: # The suggestion message to send
- "&7This server runs &fVeinMiner&7. An &ooptional &7Fabric mod may be installed to allow you to use custom keybinds."
– "&7Download at: &fhttps://www.curseforge.com/minecraft/mc-mods/veinminer4bukkit"
# This BlockList option is dynamic. For every entry in the BlockList (i.e. "Pickaxe", "Axe", "Shovel", etc.),
# an entry with the exact same ID is listed in the categories.yml
categories.yml:
Axe: # The category ID. In-game, this will be lower-cased. MUST BE UNIQUE!!!
MaxVeinSize: 64 # The maximum vein size for this category specifically. Overrides the "MaxVeinSize" in the config.yml
Items: # A list of all items in this category
– 'minecraft:wooden_axe'
– 'minecraft:stone_axe'
– 'minecraft:golden_axe'
– 'minecraft:iron_axe'
– 'minecraft:diamond_axe'
– 'minecraft:netherite_axe'
Hoe:
MaxVeinSize: 64
Items:
- 'minecraft:wooden_hoe'
– 'minecraft:stone_hoe'
– 'minecraft:golden_hoe'
– 'minecraft:iron_hoe'
– 'minecraft:diamond_hoe'
– 'minecraft:netherite_hoe'
Pickaxe:
MaxVeinSize: 64
Items:
- 'minecraft:wooden_pickaxe'
– 'minecraft:stone_pickaxe'
– 'minecraft:golden_pickaxe'
– 'minecraft:iron_pickaxe'
– 'minecraft:diamond_pickaxe'
– 'minecraft:netherite_pickaxe'
Shears:
MaxVeinSize: 64
Items:
- 'minecraft:shears'
Shovel:
MaxVeinSize: 64
Items:
- 'minecraft:wooden_shovel'
– 'minecraft:stone_shovel'
– 'minecraft:golden_shovel'
– 'minecraft:iron_shovel'
– 'minecraft:diamond_shovel'
– 'minecraft:netherite_shovel'
# ExampleCategory:
# MaxVeinSize: 10
# Items:
# – 'minecraft:torch'
# – 'minecraft:redstone_torch': # NOTE: You can include more specific options such as "Name", "Lore", and override different options by making the listed item a YAML category!
# Name: "&6My Cool Torch!"
# Lore:
# – "First line!"
# – "&5Second line!"
# – 'minecraft:potato':
# Name: "&8Special item!"
# MaxVeinSize: 128
# IncludeEdges: false

The API for VeinMiner has been constantly changing during its development, but it's now reached a state where it should remain relatively stable. There are various aspects of the API that can be manipulated by an external plugin.
[TODO] Listening for when players vein mining
[TODO] Manipulating blocklists / player capabilities
[TODO] Registering custom material aliases
FAQ:
- Can you add a customizable keybind aside from shift? Like tilda!?
- YES! You can! Sort of. VeinMiner is a server-sided mod and cannot listen for key presses, therefore in order to support custom keybinds, your players must install a client-sided Fabric mod. This mod is entirely optional but allows your players to use custom keybinds. This is the only way.
You can find the VeinMiner4Bukkit mod here: https://www.curseforge.com/minecraft/mc-mods/veinminer4bukkit
- YES! You can! Sort of. VeinMiner is a server-sided mod and cannot listen for key presses, therefore in order to support custom keybinds, your players must install a client-sided Fabric mod. This mod is entirely optional but allows your players to use custom keybinds. This is the only way.
- When will you support modded blocks?
- Never… probably… (maybe in the future?) For the time being, this is not technically possible unless VeinMiner is built for Sponge, though I have no plans on doing so. If you want to have this plugin vein mine modded blocks, it's likely you're running a modded server. Use portablejim's VeinMiner mod or OreExcavator for MinecraftForge instead. This plugin will serve no purpose compared to the mod.
- Do enchantments work with VeinMiner?
- Yes! Enchantments like Fortune and Silk Touch are respected when vein mining. Depending on how they're made, custom enchantment plugins too should work!
- Why can't I vein mine <insert block here>?
- VeinMiner provides you with a default block list for blocks that makes the most sense. If a block is not vein mineable, it's probably not on the block list. You can add it with the command /veinminer blocklist <tool> add <block>
- Does VeinMiner support McMMO?
- Yes, McMMO is supported and players will gain experience for each broken block. If you find that to be too overpowered, there's a configuration option to nerf McMMO's level gain and only grant XP to players for the first block they broke.
- Can you get rid of the message when a player joins the server?
- Yes. In the config.yml you will see a Client.SuggestionMessage option which allows you to change the message that is sent. If you don't want one to be sent, you can set it to [] instead. For example, SuggestionMessage: []. The message will no longer be sent to players.
Get 0.05 TON 💎
Download



Add a comment