Veinminer - Veinminer 连锁挖矿

⛏ Veinminer

Veinminer 是一个可配置的采矿模组，让你只需破坏一个方块就能挖掉整条矿脉。它在减少重复劳动的同时，也为服务器管理员提供了清晰的控制、限制和权限设置。

⚙️ 主要特性

• 🧱 连锁采矿 — 挖掘相邻的同类方块，并带有考虑 TPS 的方块数量上限。
• 🛠️ 多种激活方式 — 可选择下蹲或热键；每位玩家都可使用按住或切换模式。
• 🙌 空手支持 — 可在不手持工具时触发（可选）。
• 🧰 灵活的方块列表 — 全局和按工具分类的列表都可以设为白名单或黑名单。
• 🪓 按工具规则 — 不同工具可对应不同的方块集合；提供默认预设。
• ⚡ 精准采集/时运与耐久安全 — 会遵循附魔效果；可选耐久保护。
• 🔁 冷却与限制 — 可选冷却；支持固定或动态最大方块数。
• ✴️ 粒子/描边 — 服务器驱动的描边显示，支持颜色和持续时间控制。
• 🔐 LuckPerms 切换 — 可选集成权限系统。
• 🧪 /veinminer test — 用于快速验证行为和响应的命令。
• 🔄 实时重载 — 使用 /veinminer reload，出错时会报告文件/行号。

> 开箱即用支持服务端。可选客户端模组可添加热键（默认 V）。

🔧 配置与命令

命令速查

配置文件

首次运行时会写入 config/Veinminer/（TOML）。

展开

• GeneralConfig.toml
• veinminerEnabled true
• requireCrouch true
• checkToolDurability true, durabilityCap 1, durabilityThreshold ABSOLUTE
• cooldownEnabled false, cooldownSeconds 5
• dynamicMaxBlocks false, maxBlocks 64, minBlocks 16, maxDynamicBlocks 64（考虑 TPS）
• enableParticleOutline true, particleDurationTicks 60, particleRed 255, particleGreen 0, particleBlue 0
• autoLuckPerms false
• blocksPerTool false
• 全局列表和按工具列表都可使用 whitelistMode true/false
• activationMode crouch/keybind，并带有 hold/toggle 选项
• emptyHandEnabled false

• AllowedTools.toml
• 默认值：所有镐子（木质 → 下界合金）。

• AllowedBlocks.toml
• 默认值：主世界矿石、深板岩变种、下界金矿/石英矿/镶金黑石/远古残骸。

• AllowedBlocksPerTool.toml
• 启用按工具模式后生成，并从默认值初始化。

🛡️ 权限

展开

通用

• veinminer.use
• veinminer.reload
• veinminer.settings.manage
• veinminer.*

方块

• veinminer.blocks.manage
• veinminer.blocks.add
• veinminer.blocks.remove
• veinminer.blocks.list
• veinminer.blocks.*

工具

• veinminer.tools.manage
• veinminer.tools.add
• veinminer.tools.remove
• veinminer.tools.list
• veinminer.tools.*

按工具

• veinminer.blockpertool.manage
• veinminer.blockpertool.blocks.add|remove|list
• veinminer.blockpertool.tools.add|remove|list
• veinminer.blockpertool.blocks., veinminer.blockpertool.tools.

粒子

• veinminer.particles.manage
• veinminer.particles.enable, veinminer.particles.disable
• veinminer.particles.setcolor, veinminer.particles.setduration

🧱 兼容性

• ✅ Minecraft 1.20.x, 1.21.x
• ✅ 提供 Fabric 版本
• ✅ 提供 NeoForge 版本
• ✅ 可用于独立服务器和单人游戏（集成服务器）
• ❌ 暂无 Forge 版本计划。

🖥️ 客户端可选

安装客户端版本后可启用热键，并将按键状态发送到服务器。默认按键：V。如果不安装客户端，也可以通过 requireCrouch 使用下蹲激活，实现纯原版体验。

📌 计划中

• 🌐 翻译
• ✨ Veinminer 附魔

🤔 考虑中

• 🕹️ 客户端视觉提示
• 📊 挖矿统计

📥 安装

• 下载适用于你平台的最新构建版本。
• 将 jar 放入 /mods。
• 重启服务器或客户端。
• 使用命令配置，或直接编辑 TOML 文件。

💬 支持

Discord: https://discord.gg/43nu6wSWRC

🧰 其他项目

• 🔨 Hammer Mining — 通过附魔实现 3×3 连锁破坏。