跳到正文

Veinminer

作者:SGTSambam

Veinminer 是一个可配置的挖矿模组,让你只需破坏一个方块就能挖掉整条矿脉。它减少了枯燥的重复劳动,同时为服主提供了清晰的控制、限制和权限设置。

收藏

介绍

介绍由机器翻译自 Modrinth 原页面,仅供参考。

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


🧰 其他项目

常见问题

Veinminer 支持哪些 Minecraft 版本?

Veinminer 支持 Minecraft Java 版 1.20–26.2,共 23 个版本,可用的加载器:Fabric / NeoForge。下载时注意选择和你游戏版本一致的文件。

Veinminer 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:客户端 / 服务端。

评论

登录后评论和评分

SGTSambam 的其他作品

查看全部 →