Mining Spread
PluginMIT

Mining Spread

A lightweight plugin adding a custom "Mining Spread" enchantment to break connected blocks! Fully customizable with MiniMessage support.

46
Downloads
2
Followers
3 months ago
Updated
📦
1
Versions

📖About Mining Spread

MiningSpread

MiningSpread is a lightweight Minecraft plugin that introduces a new custom enchantment: Mining Spread. This enchantment allows players to break multiple connected blocks of the same type at once, making mining and resource gathering more efficient.

🚀 Features

  • Mining Spread Enchantment: Automatically breaks adjacent blocks of the same type (ores, logs, stones, etc.).
  • Armor Stacking: The enchantment level scales based on all items equipped. Having the enchantment on your pickaxe and armor pieces increases the number of blocks broken!
  • Balanced Gameplay:
    • Consumes tool durability for each block broken (configurable).
    • Works with Fortune and Silk Touch.
    • Configurable maximum block limit.
    • Ability to disable the effect while sneaking.
  • Full Customization:
    • All messages support MiniMessage (tags, colors, gradients).
    • Adjust enchantment appearance chance in the Enchantment Table.
    • Define which materials are considered "minable resources".
  • Admin Tools: Commands to give enchanted books or set enchantment levels on items.

🛠️ Commands & Permissions

Command Description Permission
/ms help Displays the help menu miningspread.admin
/ms give <player> <level> Gives a Mining Spread enchanted book miningspread.admin
/ms set <level> Sets the enchantment level for the item in hand miningspread.admin
/ms reload Reloads the plugin configuration miningspread.admin

⚙️ Configuration

The config.yml file allows you to fine-tune every aspect of the plugin:

# Enchantment appearance chance in the Enchantment Table (0.0 - 1.0)
enchant-chance: 0.5

# Minimum level in the Enchantment Table required
min-enchant-level: 20

# Maximum number of blocks that can be broken at once
max-blocks-limit: 15

# Whether to consume tool durability for each additional block broken
consume-durability: true

# Whether to require the player to NOT be sneaking to use the ability
require-no-sneak: true

# List of materials or keywords that are considered minable resources
minable-resources:
  - ORE
  - LOG
  - WOOD
  - STONE
  - DEEPSLATE
  - NETHERRACK
  - END_STONE
  - CLAY
  - GRAVEL
  - OBSIDIAN

# Messages support MiniMessage (https://docs.advntr.dev/minimessage/format.html)
messages:
  prefix: "<gold>[MiningSpread] </gold>"
  # ... (other messages)