Skip to content

Faq

Jump to bottom
deveriku edited this page Apr 7, 2026 · 1 revision

FAQ

Vein mining doesn't activate. Nothing happens when I break an ore.

Check these in order:

  1. Are you sneaking? Default requires crouch (Shift). Set require-sneak: false in config to disable this.
  2. Is the block in the blocks list? Check config.yml → blocks section.
  3. Is your tool in the tools list? Check config.yml → tools section. Leave empty to allow all tools.
  4. Do you have permission? You need vexora.veinminer.use (default: all players).
  5. Are you in Creative mode? VeinMiner only works in Survival.
  6. Is the plugin enabled? Run /vm info to check status.
  7. Is the ore alone? VeinMiner only activates when there are 2+ connected blocks of the same type.

I get a StackOverflowError in console.

Make sure you're using the latest version. This was a bug in early releases where the protection check caused infinite recursion. It's fixed in v1.0.0 with a recursion guard.

BossBar shows twice / progress is wrong.

Update to the latest version. Earlier versions had a bug where the origin block was counted in the vein list, causing incorrect progress tracking.

XP doesn't drop from vein-mined ores.

Make sure drop-experience: true in config. If using an older version, update — there was a bug where XP was calculated after the block was already broken (AIR), resulting in 0 XP.

Tool doesn't lose durability.

Check that apply-durability: true in config. Note that Unbreaking enchantment reduces durability loss — this is intentional and matches vanilla behavior.

Tool breaks mid-vein and I lose the tool.

Set break-tool: false in config (this is the default). VeinMiner will stop mining when the tool has 1 durability left.

How do I add custom blocks (logs, crops, etc.)?

Add any Bukkit Material name to the blocks list:

blocks:
  - OAK_LOG
  - BIRCH_LOG
  - WHEAT
  - GLOWSTONE

Does it work with Silk Touch / Fortune?

Yes. Vexora uses block.getDrops(tool, player) which respects all enchantments on the tool, including Silk Touch and Fortune.

Does it work with McMMO?

Yes. McMMO listens to BlockBreakEvent, and Vexora fires this event for each block (if protection-check: true). McMMO XP should be granted normally.

Can players vein mine other players' claims?

No, as long as protection-check: true (default). Vexora fires a BlockBreakEvent for each block, and protection plugins (GriefPrevention, Towny, etc.) will cancel the event for protected blocks. See Protection Plugins.

How do I set different limits for VIP ranks?

Use permission-based limits:

/lp group default permission set vexora.veinminer.limit.32 true
/lp group vip permission set vexora.veinminer.limit.64 true

See Permissions for full details.

How do I disable vein mining in specific worlds?

Use the world blacklist in config:

worlds:
  blacklist:
    - world_the_end
    - world_nether

The plugin doesn't work on my 1.19 / 1.18 server.

Vexora VeinMiner supports 1.20 — 1.21.11 only. Older versions are not supported.

How do I change the language?

Download a language file from the languages/ folder on GitHub, rename it to messages.yml, and place it in plugins/VexoraVeinMiner/. See Messages & Languages.

Where are player stats stored?

In plugins/VexoraVeinMiner/stats.yml. Each line is a player UUID and their total blocks mined. The file is created automatically on first use.

Still need help?

Clone this wiki locally