介绍
⛏ 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 | 确认或取消待处理的破坏性管理员操作。 |
高级命令
仅当 advanced.enabled = true 在 GeneralConfig.toml 中启用时,才会注册高级命令。
| 命令 | 描述 |
| — | — |
| /vmadvanced blockpertool ... | 管理每种工具的方块列表。 |
| /vmadvanced settings blockpertool | 切换每种工具的方块列表模式。 |
| /vmadvanced test | 运行高级功能测试工具。 |
| /vmadvanced confirm / /vmadvanced cancel | 确认或取消待处理的高级破坏性操作。 |
📁 配置文件
首次运行时写入 config/Veinminer/(TOML)。
配置文件概览
GeneralConfig.toml
basic.enabledtruebasic.activation_keySHIFTbasic.require_correct_tooltruebasic.check_tool_durabilitytrue、basic.durability_cap1、basic.durability_modeABSOLUTEvisual.show_particlestrue、visual.show_chat_feedbacktrueadvanced.enabledfalse、advanced.debug_loggingfalseadvanced.block_limits.max_blocks64advanced.cooldown.enabledfalseadvanced.exhaustion.enabledfalse
ToolsList.toml
- 允许使用的工具,包括可选的
hand支持。
BlocksList.toml
- 适用于受支持矿石、原木、标签或自定义条目的全局方块列表。
BlockPerToolList.toml
- 启用高级的每种工具模式后使用的工具专属方块列表。
🛡️ 权限
权限节点
常规
veinminer.useveinminer.reloadveinminer.settings.manageveinminer.*
方块
veinminer.blocks.manageveinminer.blocks.addveinminer.blocks.removeveinminer.blocks.listveinminer.blocks.*
工具
veinminer.tools.manageveinminer.tools.addveinminer.tools.removeveinminer.tools.listveinminer.tools.*
每种工具
veinminer.blockpertool.manageveinminer.blockpertool.blocks.add|remove|listveinminer.blockpertool.tools.add|remove|listveinminer.blockpertool.blocks.*veinminer.blockpertool.tools.*
粒子
veinminer.particles.manageveinminer.particles.enableveinminer.particles.disableveinminer.particles.setcolorveinminer.particles.setduration
🧱 兼容性
- ✅ Fabric:Minecraft 1.20 至 26.2。
- ✅ NeoForge:Minecraft 1.21 至 26.2。
- ✅ 支持专用服务器和单人游戏内置服务器。
- ❌ 目前暂无 Forge 版本计划。
🖥️ 客户端可选
安装客户端版本后即可启用快捷键,并向服务器发送按键状态。默认按键:V。不安装客户端时,仍可通过 Shift/潜行触发,体验仅需原版的服务端功能。
📥 安装
- 下载适用于你的加载器和 Minecraft 版本的最新构建。
- 将 jar 文件放入
/mods。 - 重启服务器或客户端。
- 照常游玩。仅在需要管理员控制时编辑配置或启用高级模式。
💬 支持
Discord:https://discord.gg/43nu6wSWRC
🧰 其他项目
- 🔨 Hammer Mining — 通过附魔实现 3×3 范围挖掘。
常见问题
Veinminer 支持哪些 Minecraft 版本?
Veinminer 支持 Minecraft Java 版 1.20–26.2,共 23 个版本,可用的加载器:Fabric / NeoForge。下载时注意选择和你游戏版本一致的文件。
Veinminer 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:客户端 / 服务端。
评论
登录后评论和评分