✦ Vexora VeinMiner

Mine smarter, not harder — animated vein mining with progress bars & full protection support.

What is Vexora VeinMiner?

Vexora VeinMiner lets players mine entire ore veins by breaking a single block. Unlike other vein mining plugins, Vexora focuses on visual feedback and plug-and-play simplicity — animated block breaking, real-time BossBar and ActionBar progress, and zero setup hassle.

Drop the jar into your plugins folder, and it just works.

Features

• Animated vein mining — blocks break one by one with particle effects and sound
• BossBar progress — real-time progress bar above the screen during mining
• ActionBar progress — text-based progress bar with customizable format
• Protection plugin support — automatically compatible with GriefPrevention, Towny, Lands, Residence, WorldGuard, and any plugin that listens to BlockBreakEvent
• Permission-based limits — assign different block limits per rank (vexora.veinminer.limit.32, .64, .128)
• Per-block limits — configure max vein size individually for each ore type
• Cooldown system — prevent veinminer spam with configurable cooldown
• Tool durability — respects Unbreaking enchantment, optionally stops before tool breaks
• Hunger cost — balanced gameplay with configurable food drain per block
• XP drops — correct experience orbs from vein-mined ores
• Drop at player — optionally send all drops directly to the player's location
• Statistics tracking — persistent per-player stats saved to file
• WorldGuard integration — respects region flags and build permissions
• Update checker — notifies ops when a new version is available
• bStats metrics — anonymous usage statistics
• Fully translatable — all messages in a separate messages.yml for easy translation
• Hex color support — use &#FF5555 in any message

Installation

1. Download the latest release from Releases
2. Drop the .jar file into your server's plugins/ folder
3. Restart the server
4. Done — no additional setup required

Commands

Permissions

Permission-based limits

Assign different block limits to different ranks using your permissions plugin:

# Example with LuckPerms
/lp group default permission set vexora.veinminer.limit.32 true
/lp group vip permission set vexora.veinminer.limit.64 true
/lp group mvp permission set vexora.veinminer.limit.128 true

The highest granted limit is used. Config per-block limits can further cap the value.

Configuration

config.yml

# Global toggle
enabled: true

# Require sneaking to vein mine
require-sneak: true

# Global max blocks (fallback if no per-block limit is set)
max-blocks: 64

# Protection check — fires BlockBreakEvent for each block
# Ensures compatibility with GriefPrevention, Towny, Lands, etc.
protection-check: true

# Per-block limits (override global max)
per-block-limits:
  DIAMOND_ORE: 16
  DEEPSLATE_DIAMOND_ORE: 16
  ANCIENT_DEBRIS: 8
  COAL_ORE: 64

# Cooldown between vein mines
cooldown:
  enabled: true
  seconds: 3

# Animated block breaking
animation:
  enabled: true
  delay-ticks: 1
  show-break-animation: true

# Tool settings
apply-durability: true
break-tool: false

# Sound & particles
sound:
  enabled: true
  type: BLOCK_STONE_BREAK
  volume: 0.8
  pitch: 1.2

particles:
  enabled: true
  type: BLOCK_CRACK
  count: 5

# Drop items at player's location
drop-at-player: false
drop-experience: true

# Hunger drain per block
hunger:
  enabled: true
  cost-per-block: 0.5

# ActionBar progress
action-bar:
  enabled: true
  format: "&a✦ VeinMiner &8│ &f%current%&7/&f%total% &7blocks &8│ %bar%"
  bar-length: 20
  bar-filled: "&a█"
  bar-empty: "&8█"

# BossBar progress
boss-bar:
  enabled: true
  title: "&a✦ Vexora VeinMiner &8— &f%current%&7/&f%total%"
  color: GREEN
  style: SEGMENTED_10
  fade-delay: 40

# WorldGuard integration
worldguard:
  enabled: true
  check-build-flag: true

messages.yml

All messages are in a separate messages.yml file for easy translation. Supports hex colors (&#FF5555) and legacy color codes (&a, &c, etc.).

Supported Blocks

All ores are supported out of the box:

Coal, Iron, Gold, Diamond, Emerald, Lapis, Redstone, Copper (+ Deepslate variants), Nether Gold, Nether Quartz, Ancient Debris, Amethyst Cluster

Add any block by adding its Bukkit Material name to the blocks list in config.yml.

Supported Tools

By default: Wooden, Stone, Iron, Golden, Diamond, and Netherite Pickaxes.

Leave the tools list empty in config.yml to allow all tools.

Compatibility

Any plugin that cancels BlockBreakEvent to protect blocks will automatically work with Vexora VeinMiner.

API Version

• Minecraft: 1.20 — 1.21.11
• Java: 17+
• Server: Spigot / Paper

Building from Source

git clone https://github.com/VexoraStudios/Vexora-VeinMiner.git
cd Vexora-VeinMiner
mvn clean package

The compiled jar will be in target/.

Support

• Issues: GitHub Issues
• Discord: Coming soon

License

This project is licensed under the MIT License — see the LICENSE file for details.

Made with ✦ by Vexora Studios