Minecraft plugin Veinminer

🔌 About VeinMiner

VeinMiner — is a Minecraft plugin that allows players to mine entire ore veins by sneaking and breaking a single block. VeinMiner recreates the behaviour of the original Forge VeinMiner mod for Bukkit/Spigot/Paper servers and focuses on a performant, configurable server‑side implementation. VeinMiner is open‑source and has an optional client companion mod for richer keybind and rendering behaviour.

🎯 Purpose

VeinMiner solves the repetitive task of mining connected ore veins. By breaking one ore while sneaking, VeinMiner removes adjacent matching blocks according to configured blocklists and tool rules. This reduces manual clicking and speeds up resource collection on survival, prison, and factions servers.

VeinMiner is designed for server owners who want a controlled vein‑mining mechanic without requiring client mods (companion mod adds optional conveniences).

⚙ Main features

• Mine entire veins by sneaking and breaking a block (server‑side).
• Configurable blocklists and tool groups (editable in config and via plugin commands).
• In‑game commands for reloading and blocklist manipulation.
• Optional Fabric client companion mod for custom keybinds and wireframe preview (separate download).
• Lightweight implementation intended for Spigot/Paper servers.

🧩 Who it's for

VeinMiner suits server administrators who run Survival, Prison, Factions, or semi‑vanilla servers and want a predictable vein‑mining mechanic. VeinMiner is useful where faster ore gathering is desirable but must be controlled via configuration to avoid exploits.

🏗 Example usages

• Allow donors to use vein mining while keeping control over which blocks are affected by editing blocklists.
• Enable vein mining for iron/copper/coal only and exclude player‑placed or custom mod blocks.
• Use the plugin on Paper/Spigot servers to reduce repetitive mining while preserving server performance.

⌨️ Commands

Notes: Confirmed subcommands include reload, version and blocklist <tool> (used to view/manipulate block lists). The exact permission nodes are provided in the plugin documentation and source repository.

🔐 Permissions

If a full permission list is required, consult the plugin's official documentation or GitHub repository (source includes explicit nodes and examples). The plugin uses permission nodes to restrict blocklist edits and administrative commands.

⚙ Installation

📥 Installation

• Download the VeinMiner .jar from an official source (Spigot/CurseForge/GitHub release).
• Place the .jar into your server's plugins/ folder (Spigot/Paper preferred).
• Fully restart the server (do not use /reload).
• After startup, VeinMiner will create its configuration folder and files.

📦 Dependencies

• No mandatory external dependencies are listed in the official plugin resources for basic vein‑mining behaviour.
• Optional: a client companion mod (Fabric) exists to provide client‑side keybinds and wireframe rendering (separate install).

🧾 Configuration

• VeinMiner generates configuration files and a blocklist on first run.
• Blocklists and tool groups can be edited in the config or manipulated in‑game via the plugin's blocklist subcommands.
• The plugin supports marking blocks or data values and grouping them by tool type.

🧠 Additional information

• bStats: VeinMiner is reported to collect anonymous usage statistics via bStats (as indicated on the Spigot resource page).
• Client companion: An optional Fabric client companion mod exists to add custom keybinds and wireframe previews; the plugin works server‑side without it.
• Known limitations: VeinMiner activates when a player sneaks and breaks a matching block; behaviour for modded/custom blocks depends on block IDs and config entries.
• Conflicts: Because VeinMiner intercepts block break logic, server owners should test interactions with other plugins that heavily modify block breaks or implement custom block protections.

❓ FAQ

Q: How do players use VeinMiner? A: Players typically sneak (hold shift) and break one ore block; VeinMiner will attempt to break adjacent matching blocks per the configured blocklists.

Q: Does VeinMiner require a client mod? A: No — VeinMiner works server‑side. A client companion mod is optional and adds conveniences like custom keybinds and wireframe previews.

Q: Can I restrict which ores are vein‑mined? A: Yes — configure blocklists and tool groups in the config.yml or use the plugin's blocklist subcommands to manage allowed blocks.

Q: Does VeinMiner collect telemetry? A: The plugin is reported to use bStats for anonymous statistics.

When to choose VeinMiner

If you want a faithful, server‑side recreation of the VeinMiner mechanic for Spigot/Paper servers with configurable blocklists and an optional client companion mod, VeinMiner is an appropriate choice. Use it when you want faster ore gathering without relying on client‑only mods, but always test settings on a staging server before rolling out to production.

(Information compiled from the plugin's official resource pages and source repository.)