Veinminer - 高度可配置

⛏ Veinminer

Veinminer 是一个可配置的采矿模组，允许玩家通过一次普通方块破坏来连锁采集相连的矿石和原木矿脉。它在减轻玩家劳作强度的同时，为服务器管理员提供了清晰的控制选项、限制和权限。

无需执行 /veinminer setup 命令。安装模组后，在挖掘受支持的方块时按住 Shift 键，Veinminer 即可立即生效。

---

⚙️ 主要特性

• 🧱 矿脉采掘 — 以安全的方块上限开采相连的受支持方块。
• 🛠️ 激活方式选择 — 默认为 Shift/潜行，可选的客户端快捷键，每位玩家可设置按住或切换模式。
• 🙌 空手支持 — 服务器管理员可允许将 hand 作为工具条目。
• 🧰 灵活的方块列表 — 全局方块和工具列表，便于服务器管理。
• 🪓 工具专属规则 — 可选的进阶工具专属方块列表。
• ⚡ 耐久度保护 — 可选的保护机制，避免工具损坏。
• 🔁 冷却与限制 — 可选的冷却时间、饥饿值消耗和最大方块数量控制。
• ✴️ 粒子/轮廓 — 每位玩家可独立设置的轮廓粒子，包含颜色和持续时间控制。
• 🔐 LuckPerms 开关 — 可选的集成功能，适用于权限管理的服务器。
• 🧪 进阶测试命令 — 启用进阶模式后的 /vmadvanced test 命令。
• 🔄 热重载 — 使用 /veinminer reload 或 /vmadmin reload 从磁盘重新加载配置。

开箱即用，服务端生效。可选的客户端模组可添加快捷键，默认为 V 键。

---

🔧 配置与命令

 玩家命令快速参考

命令	描述
/veinminer	显示快速帮助。
/veinminer help [topic]	关于 toggle、reload、activation、togglemessages 或 particles 的帮助。
/veinminer toggle	为自己切换 Veinminer 的启用状态。
/veinminer activation keybind	在 Shift 和可选的客户端按键绑定之间切换。
/veinminer activation mode hold|toggle	设置你的激活模式。
/veinminer togglemessages permission|disabled|cooldown|durability	切换你自己的反馈消息。
/veinminer particles toggle	切换你自己的轮廓粒子。
/veinminer particles setcolor <red> <green> <blue>	设置你自己的轮廓粒子颜色。
/veinminer particles setduration <ticks>	设置你自己的轮廓粒子持续时间。
/veinminer reload	从磁盘重新加载配置。需要管理员/管理权限。

 管理员命令快速参考

命令	描述
/vmadmin blocks add|remove|list|clear <id|#tag>	管理全局方块列表。
/vmadmin tools add|remove|list|clear <id|#tag|hand>	管理允许的工具。
/vmadmin settings blocklistmode whitelist|blacklist	设置全局方块列表模式。
/vmadmin settings maxblocks <value>	设置每次激活的最大方块数。
/vmadmin settings cooldown enable|disable|set <seconds>	配置冷却时间。
/vmadmin settings exhaustion enable|disable|scale <value>	配置饥饿值消耗。
/vmadmin settings luckperms enable|disable	切换 LuckPerms 集成。
/vmadmin reload	从磁盘重新加载配置。
/vmadmin confirm / /vmadmin cancel	确认或取消挂起的破坏性管理员操作。

 进阶命令快速参考

命令	描述
/vmadvanced blockpertool ...	管理工具专属方块列表。
/vmadvanced settings blockpertool	切换工具专属方块列表模式。
/vmadvanced test	运行进阶功能测试套件。
/vmadvanced confirm / /vmadvanced cancel	确认或取消挂起的破坏性进阶操作。

---

📁 配置文件

首次运行时会写入 config/Veinminer/ 目录（TOML 格式）。

GeneralConfig.toml

• basic.enabled true
• basic.activation_key SHIFT
• basic.require_correct_tool true
• basic.check_tool_durability true, basic.durability_cap 1, basic.durability_mode ABSOLUTE
• visual.show_particles true, visual.show_chat_feedback true
• advanced.enabled false, advanced.debug_logging false
• advanced.block_limits.max_blocks 64
• advanced.cooldown.enabled false
• advanced.exhaustion.enabled false

ToolsList.toml

• 允许的工具，包括可选的 hand 支持。

BlocksList.toml

• 受支持的矿石、原木、标签或自定义条目的全局方块列表。

BlockPerToolList.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

---

🧱 兼容性

• ✅ Fabric: Minecraft 1.20 至 26.2。
• ✅ NeoForge: Minecraft 1.21 至 26.2。
• ✅ 适用于专用服务器和单人游戏内置服务器。
• ❌ 目前没有计划构建 Forge 版本。

---

🖥️ 客户端可选

安装客户端构建版本可启用快捷键，并将按键状态发送至服务器。默认按键：V。如果没有安装客户端，Shift/潜行激活方式仍然可用，可提供纯原版服务端体验。

---

📥 安装

1. 为你的加载器及 Minecraft 版本下载最新的构建版本。
2. 将 jar 文件放入 /mods 文件夹。
3. 重启服务器或客户端。
4. 正常游戏。仅在你需要管理员控制时，才编辑配置或启用进阶模式。

---

💬 支持

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

---

🧰 其他项目

• 🔨 Hammer Mining — 通过附魔实现 3x3 范围采掘。