Protection plugins

Protection Plugins

Vexora VeinMiner is designed to work with any protection plugin out of the box.

---

How It Works

Before mining each block in a vein, Vexora fires a simulated BlockBreakEvent. If any plugin cancels that event (because the block is in a protected region, claim, or town), Vexora skips that block.

This means you don't need to configure anything — if a protection plugin protects a block from normal breaking, it's also protected from vein mining.

---

Tested Plugins

Plugin	Status	Notes
WorldGuard	✅ Works	Built-in hook + BlockBreakEvent check
GriefPrevention	✅ Works	Via BlockBreakEvent
Towny	✅ Works	Via BlockBreakEvent
Lands	✅ Works	Via BlockBreakEvent
Residence	✅ Works	Via BlockBreakEvent
PlotSquared	✅ Works	Via BlockBreakEvent
BentoBox / BSkyBlock	✅ Works	Via BlockBreakEvent
SuperiorSkyblock2	✅ Works	Via BlockBreakEvent
RedProtect	✅ Works	Via BlockBreakEvent

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

---

Config Option

The protection check can be toggled in config.yml:

protection-check: true

• true (default): Fires BlockBreakEvent for every block — full protection compatibility
• false: Skips the check — slightly better performance but no protection plugin support

Warning: Only set to false if you have no protection plugins or if you use WorldGuard exclusively (which has its own built-in hook).

---

Performance Note

The protection check adds a small overhead because it fires an event per block. On most servers this is negligible. If you experience lag with very large veins (128+ blocks), consider:

1. Lowering max-blocks in config
2. Setting per-block limits for common ores
3. Using protection-check: false if you only use WorldGuard

---

Troubleshooting

Vein mining works through claims/regions:

• Make sure protection-check: true in config.yml
• Run /vm reload after changing the setting
• Test with a non-OP player (OP might bypass protection)

Blocks at claim borders:

• Vexora checks each block individually, so blocks inside the claim are mined and blocks outside are skipped. The vein will be partially mined.