Skip to content

Configuration

Jump to bottom
deveriku edited this page Apr 7, 2026 · 3 revisions

Configuration

All settings are in plugins/VexoraVeinMiner/config.yml. After editing, run /vm reload to apply changes.

General Settings

Key Default Description
enabled true Global plugin toggle
require-sneak true Must crouch to vein mine
max-blocks 64 Global max blocks per vein
apply-durability true Tool takes damage per block
break-tool false If false, stops mining before tool breaks
drop-at-player false Send drops to player's location
drop-experience true Drop XP orbs from ores
protection-check true Fire BlockBreakEvent for each block (protection plugin compat)

World Settings

worlds:
  # Only allow veinminer in these worlds (leave empty for all)
  whitelist: []
  # Disable veinminer in these worlds
  blacklist:
    - world_the_end

If both whitelist and blacklist have entries, whitelist takes priority.

Player Blacklist

player-blacklist:
  - "00000000-0000-0000-0000-000000000000"

Use player UUIDs. Blacklisted players see the blacklisted message from messages.yml.

Blocks & Tools

blocks:
  - COAL_ORE
  - DEEPSLATE_COAL_ORE
  - DIAMOND_ORE
  # ... add any Bukkit Material name

tools:


    

  • WOODEN_PICKAXE
    • 

  • STONE_PICKAXE
    • 

  • IRON_PICKAXE
    • 

  • GOLDEN_PICKAXE
    • 

  • DIAMOND_PICKAXE
    • 

  • NETHERITE_PICKAXE

    •

Leave tools empty to allow all tools. Use Bukkit Material names.

WorldGuard

See the dedicated WorldGuard page.

# Configuration

All settings are in plugins/VexoraVeinMiner/config.yml. After editing, run /vm reload to apply changes.

General Settings

Key Default Description
enabled true Global plugin toggle
require-sneak true Must crouch to vein mine
max-blocks 64 Global max blocks per vein
apply-durability true Tool takes damage per block
break-tool false If false, stops mining before tool breaks
drop-at-player false Send drops to player's location
drop-experience true Drop XP orbs from ores
protection-check true Fire BlockBreakEvent for each block (protection plugin compat)

Per-Block Limits

Override the global max-blocks for specific block types. Blocks not listed here use the global limit.

per-block-limits:
  DIAMOND_ORE: 16
  DEEPSLATE_DIAMOND_ORE: 16
  EMERALD_ORE: 16
  DEEPSLATE_EMERALD_ORE: 16
  ANCIENT_DEBRIS: 8
  COAL_ORE: 64
  DEEPSLATE_COAL_ORE: 64
  IRON_ORE: 48
  DEEPSLATE_IRON_ORE: 48
  GOLD_ORE: 32
  DEEPSLATE_GOLD_ORE: 32
  COPPER_ORE: 64
  DEEPSLATE_COPPER_ORE: 64
  LAPIS_ORE: 32
  DEEPSLATE_LAPIS_ORE: 32
  REDSTONE_ORE: 32
  DEEPSLATE_REDSTONE_ORE: 32
  NETHER_GOLD_ORE: 48
  NETHER_QUARTZ_ORE: 48
  AMETHYST_CLUSTER: 32

Tip: Permission-based limits (vexora.veinminer.limit.<number>) interact with per-block limits. The lower of the two is used. See [Permissions] for details.

Cooldown

Key Default Description
cooldown.enabled true Enable cooldown between uses
cooldown.seconds 3 Seconds between vein mines

Players with vexora.veinminer.bypass.cooldown skip the cooldown.

Animation

Key Default Description
animation.enabled true Blocks break one by one
animation.delay-ticks 1 Ticks between each block break (20 ticks = 1 second)
animation.show-break-animation true Show crack animation on blocks before breaking

Set animation.enabled: false for instant vein mining (all blocks break at once).

Sound

Key Default Description
sound.enabled true Play sound per block
sound.type BLOCK_STONE_BREAK [Bukkit Sound name](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html)
sound.volume 0.8 Sound volume (0.0 — 1.0)
sound.pitch 1.2 Sound pitch

Particles

Key Default Description
particles.enabled true Spawn particles when blocks break
particles.type BLOCK_CRACK [Bukkit Particle name](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html)
particles.count 5 Number of particles per block

Hunger

Key Default Description
hunger.enabled true Drain food level while mining
hunger.cost-per-block 0.5 Food points drained per block (1.0 = half a drumstick)

Action Bar

Key Default Description
action-bar.enabled true Show progress on action bar
action-bar.format &a✦ VeinMiner &8│ &f%current%&7/&f%total% &7blocks &8│ %bar% Format string
action-bar.bar-length 20 Number of characters in progress bar
action-bar.bar-filled &a█ Filled bar character
action-bar.bar-empty &8█ Empty bar character

Placeholders: %current% = blocks mined so far, %total% = total blocks in vein, %bar% = visual progress bar.

Boss Bar

Key Default Description
boss-bar.enabled true Show BossBar during mining
boss-bar.title &a✦ Vexora VeinMiner &8— &f%current%&7/&f%total% Title format
boss-bar.color GREEN PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
boss-bar.style SEGMENTED_10 SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
boss-bar.fade-delay 40 Ticks before BossBar disappears after mining (20 = 1 second)

Statistics

Key Default Description
statistics.enabled true Track blocks mined per player
statistics.persistent true Save stats to stats.yml (survives restarts)

Update Checker

Key Default Description
update-checker.enabled true Check SpigotMC for updates on startup
update-checker.resource-id 0 Your SpigotMC resource ID
update-checker.notify-ops true Notify ops on join if update is available

bStats

Key Default Description
bstats.enabled true Send anonymous usage statistics
bstats.plugin-id 0 Your bStats plugin ID

World Settings

worlds:
  # Only allow veinminer in these worlds (leave empty for all)
  whitelist: []
  # Disable veinminer in these worlds
  blacklist:
    - world_the_end

If both whitelist and blacklist have entries, whitelist takes priority.

Player Blacklist

player-blacklist:
  - "00000000-0000-0000-0000-000000000000"

Use player UUIDs. Blacklisted players see the blacklisted message from messages.yml.

Blocks & Tools

blocks:
  - COAL_ORE
  - DEEPSLATE_COAL_ORE
  - DIAMOND_ORE
  # ... add any Bukkit Material name

tools:
  - WOODEN_PICKAXE
  - STONE_PICKAXE
  - IRON_PICKAXE
  - GOLDEN_PICKAXE
  - DIAMOND_PICKAXE
  - NETHERITE_PICKAXE

Leave tools empty to allow all tools. Use [Bukkit Material names](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html).

WorldGuard

See the dedicated WorldGuard page.

Clone this wiki locally