ModAppDailyEighteen – Totally Questions

VeinMiner Mod · Technical Details & Installation

⛏️ VeinMiner Mod

Mine entire veins at once • highly configurable • server‑side • Fabric & NeoForge & Paper & DataPack • V2 & V1 versions

📖 Mod Overview & Core Features

⛏️ Vein mining

Mine whole veins – break one ore/block and mine the entire connected vein.
Tool‐aware – your tool must be able to mine the block (configurable).
Works everywhere – fully functional on vanilla servers (DataPack version).
Lightweight – minimal performance impact, even on large veins.

⚙️ Two versions

V2 (Mod/Plugin) – full customisation with commands, groups, and overrides.
V1 (DataPack) – simple, vanilla‑friendly version with chat‑based config.
Cross‑loader support – Fabric, NeoForge, Paper, PurPur, Folia, and more.
Addons available – Hotkey, Enchantment, and Highlighting addons.

🎮 Commands & permissions

/veinminer blocks – edit veinmineable blocks per tool.
/veinminer groups – advanced block & tool rule management.
/veinminer toggle – enable/disable veinminer server‑wide.
/veinminer settings – adjust cooldown, max chain, and more.
/veinminer presets – quick setup for common groups.

🔧 Customisation

Block groups – define which blocks work with which tools.
Setting overrides – fine‑tune behaviour per group.
Hotkey support – toggle veinmining on‑the‑fly (addon).
Enchantment integration – limit veinmining to enchanted tools (addon).

🛠️ Technical Summary

🧠 Architecture & logic

BFS vein detection – uses breadth‑first search to find connected blocks.
Server‑side only – all logic runs on server; clients need no mod.
Permission‑based – granular control via LuckPerms (NeoForge coming).
Configurable chain length – limit max blocks broken per activation.

📦 Loader & dependencies

Fabric/Quilt – requires Fabric API; lightweight.
NeoForge/Forge – works with NeoForge; no extra dependencies.
Paper/PurPur/Folia – plugin version for Spigot-based servers.
DataPack (V1) – no dependencies; works on any MCPE server.

⚙️ Core mechanics

Block detection – recursively finds same‑type blocks in 6‑direction adjacency.
Tool validation – checks if tool can harvest the block (configurable).
Cooldown system – prevents accidental over‑mining.
Item drops – all broken blocks drop their items as if mined individually.

🔧 Advanced features

Group system – define multiple rule sets for different tools.
Override system – per‑group overrides for max chain, cooldown, etc.
Presets – one‑command setup for common veins (ores, logs).
Hotkey addon – enable/disable veinmining with a keybind.

      /* Technical highlights */

      • V2 uses a group‑based rule engine: (tool, block) → veinmining enabled.

      • BFS algorithm with configurable max chain to prevent server lag.

      • DataPack V1 uses function-based logic with chat configuration.

      • Permissions: veinminer.blocks, veinminer.groups, veinminer.toggle, etc.

      • Addons (Hotkey, Enchantment) extend functionality via separate JARs.

📥 Installation Guide

🧵 V2 Fabric/Quilt

RECOMMENDED Full customisation & features

1. Install Fabric Loader (or Quilt) for your MCPE version.

2. Download Fabric API (required).

3. Download VeinMiner-V2-[version]-fabric.jar.

4. Place JARs in .minecraft/mods/.

5. Launch using Fabric profile.

          Example mods folder:

          └── mods/

              ├── fabric-api-0.92.0+1.20.1.jar

              └── VeinMiner-V2-2.5.0+1.20.1.jar

✅ Note: Fabric API is mandatory for V2 Fabric version.

⚙️ V2 NeoForge & Paper

ALTERNATIVE For Forge‑ecosystem or server plugins

NeoForge:

1. Install recommended NeoForge for your MCPE.

2. Download VeinMiner-V2-[version]-neoforge.jar.

3. Place JAR in mods/ folder.

Paper/PurPur:

1. Download VeinMiner-V2-[version]-paper.jar.

2. Place JAR in plugins/ folder.

3. Restart server.

          Example Paper plugins folder:

          └── plugins/

              └── VeinMiner-V2-2.5.0-paper.jar

⚠️ Note: V2 works on both modded and plugin servers.

📦 V1 DataPack

LIGHTWEIGHT Vanilla‑friendly, no mods needed

1. Download VeinMiner-V1-[version].zip.

2. Place the ZIP in your world's datapacks/ folder.

3. Reload the world or use /reload.

4. Use /function veinminer:_config to configure.

          Example datapacks folder:

          └── world/

              └── datapacks/

                  └── VeinMiner-V1-1.5.0.zip

✅ Note: No dependencies – works on any MCPE server.

📌 Universal steps & recommendations

Addons: Hotkey and Enchantment addons are available as separate JARs.
Permissions: OP players have all permissions; use LuckPerms for fine control.
Performance: V2 is optimised; set max chain to avoid lag on large veins.
Cross‑loader: V2 works across Fabric, NeoForge, and Paper servers.
Configuration: Use /veinminer presets for quick setup.

        ⚡ Quick setup (V2):

        1. Install VeinMiner V2 (any loader/plugin).

        2. Run /veinminer presets ores to enable ore veinmining.

        3. Run /veinminer presets logs to enable log veinmining.

        4. Mine any ore/log – the whole vein breaks!

        5. Customise with /veinminer settings and /veinminer groups.

✅ V2 Fabric: Fabric Loader + Fabric API + VeinMiner-V2 ✅ V2 NeoForge: NeoForge + VeinMiner-V2 ✅ V2 Paper: Paper + VeinMiner-V2-paper.jar 📦 V1 DataPack: world/datapacks/ + VeinMiner-V1.zip

📋 V2 Commands & Settings (reference)

Command	Permission	Description
/veinminer blocks	veinminer.blocks	Edit blocks that are veinmineable with every tool
/veinminer groups	veinminer.groups	Edit blocks & tools with precise rules
/veinminer toggle	veinminer.toggle	Toggle Veinminer server‑wide
/veinminer settings	veinminer.settings	Change cooldown, max chain, and more
/veinminer presets	veinminer.groups	Quick setup groups & settings

OP players have all permissions. Use LuckPerms for granular control (NeoForge coming soon).

VeinMiner Mod · by Miraculixx · V2 (Mod/Plugin) & V1 (DataPack) · MCPE 1.17–1.21+

⛏️ Mine whole veins · highly configurable · Fabric · NeoForge · Paper · DataPack