VeinMiner

VeinMiner - 连锁挖矿

Minecraft Forge的VeinMiner插件在Spigot服务器上的重制版。
Bukkit / Spigot 作者 2008Choco 支持版本 1.21 - 26.1
访问 Spigot 访问 Modrinth 下载插件
服务器使用量
3,110
服务玩家数
2,419
下载量
1,254,337
插件详细介绍

VeinMiner 是一款为 Minecraft 服务器设计的插件，它引入了一种贴近原版游戏风格的连锁采集机制。玩家可以瞬间采集一组相连的同类型方块，从而节省大量时间。无论是矿物、大树还是广阔的农田，都能轻松应对。每个工具都可以拥有自己可配置的方块列表，为服务器管理带来无限可能。对于监狱、领地或半原版服务器来说，这是一个绝佳的功能，既不会破坏平衡，又能为支持服务器的玩家提供有价值的回报。

版本与要求

  • 最低 Java 版本：Java 21
  • 历史版本：
  • Minecraft 1.17.x - 1.21.3：VeinMiner 2.3.1 ([下载](download))
  • Minecraft 1.13.x - 1.16.x：VeinMiner 1.17.10 ([下载](download))
  • Minecraft 1.8.x - 1.12.x：VeinMiner 1.11.3 ([下载](download))
  • 数据收集：插件会收集匿名统计数据 (https://bstats.org/plugin/bukkit/VeinMiner)，包括：
  • 典型的 bStats 信息
  • 上一个更新周期内采集的方块类型
  • 主动使用可选客户端模组的玩家数量
  • 已安装的反作弊插件名称及版本

核心功能

  • 高效连锁采集：快速连续地采集相似的相邻方块。
  • 强大的配置：可为自定义工具类别和方块列表进行详细配置。
  • 多种采集模式：支持立方体区域、隧道或楼梯式等多种挖掘模式。
  • 经济系统支持：可选的经济消耗功能。
  • 可选客户端模组：支持通过客户端模组设置自定义快捷键 ([链接](link))。
  • 开发者 API：提供 API 以创建自定义采集模式和行为。
  • 简易安装：默认情况下，服务器所有者只需拖放安装，无需额外步骤。
  • 原生支持：原生支持多种主流反作弊插件和 PlaceholderAPI。

命令列表

所有命令均以 /veinminer 开头。

主要命令

  • /veinminer reload
  • 重新加载 config.yml 和 categories.yml 配置文件。
  • 权限：veinminer.command.reload
  • /veinminer version
  • 查看 VeinMiner 的版本和开发者信息。
  • /veinminer toggle [tool]
  • 启用或禁用连锁采集功能。
  • 若提供 [tool] 参数，则切换特定工具的采集状态。
  • 权限：veinminer.command.toggle
  • /veinminer mode <mode>
  • 更改连锁采集的激活方式。
  • 要使用 "client" 模式，必须在客户端安装 VeinMiner Companion Mod。
  • 权限：veinminer.command.mode
  • /veinminer pattern <pattern>
  • 更改连锁采集时搜索和破坏方块的模式。
  • 插件默认提供 "default"、"tunnel"、"staircase_up" 和 "staircase_down" 模式，其他模式可由附加插件注册。
  • 权限：veinminer.command.pattern
  • /veinminer givetool <category> <tool> [amount]
  • 给予自己一个指定类别的工具（对于带有 NBT 数据的工具很有用）。
  • 权限：veinminer.command.givetool
  • /veinminer import
  • 用于将 2.0.0 之前版本的 VeinMiner 的旧版 JSON 数据导入到新的 SQLite 格式中。
  • 权限：veinminer.command.import

方块列表管理 (`/blocklist` 或 `/veinminer blocklist`)

  • /blocklist <category> add <block>
  • 向指定类别添加一个可连锁采集的方块。
  • 方块可以是简单 ID，如 minecraft:stone，或带有状态，如 minecraft:chest[waterlogged=true]。
  • 权限：veinminer.command.blocklist
  • /blocklist <category> remove <block>
  • 从指定类别中移除一个方块。
  • 权限：veinminer.command.blocklist
  • /blocklist <category> list
  • 列出指定类别中所有可连锁采集的方块（及其状态）。
  • 权限：veinminer.command.blocklist

工具列表管理 (`/toollist` 或 `/veinminer toollist`)

  • /toollist <category> add <item>
  • 向指定类别的工具列表中添加一个物品。
  • 权限：veinminer.command.toollist
  • /toollist <category> remove <item>
  • 从指定类别的工具列表中移除一个物品。
  • 权限：veinminer.command.toollist
  • /toollist <category> list
  • 列出指定类别中所有可用的工具物品。
  • 权限：veinminer.command.toollist

权限节点

基础使用权限

  • veinminer.veinmine.* (默认拥有)：允许玩家使用所有工具的连锁采集。
  • veinminer.veinmine.<tool> (默认拥有)：允许玩家使用特定工具的连锁采集（例如 veinminer.veinmine.pickaxe）。

采集模式权限

  • veinminer.pattern.* (默认拥有)：允许玩家使用所有连锁采集模式。
  • veinminer.pattern.<pattern_id> (默认拥有)：允许玩家使用特定的连锁采集模式（例如 veinminer.pattern.tunnel）。

费用豁免权限

  • veinminer.free.* (默认无人拥有)：豁免玩家使用连锁采集时的所有消耗（如果已设置）。
  • veinminer.free.economy：豁免经济消耗。
  • veinminer.free.hunger：豁免额外饥饿值消耗。

客户端模组功能权限

  • veinminer.client.* (默认拥有)：允许玩家使用所有客户端模组功能。
  • veinminer.client.activation：允许玩家使用自定义快捷键激活连锁采集。
  • veinminer.client.patterns：允许玩家使用自定义快捷键切换采集模式。
  • veinminer.client.wireframe：允许玩家在目标方块周围渲染线框。

命令权限

  • veinminer.command.reload (OP 拥有)：允许使用 /veinminer reload 命令。
  • veinminer.command.blocklist (OP 拥有)：允许使用方块列表管理命令。
  • veinminer.command.toollist (OP 拥有)：允许使用工具列表管理命令。
  • veinminer.command.import (OP 拥有)：允许使用 /veinminer import 命令。
  • veinminer.command.givetool (OP 拥有)：允许使用 /veinminer givetool 命令。
  • veinminer.command.toggle (默认拥有)：允许使用 /veinminer toggle 命令。
  • veinminer.command.mode (默认拥有)：允许使用 /veinminer mode 命令。
  • veinminer.command.pattern (默认拥有)：允许使用 /veinminer pattern 命令。

配置说明

VeinMiner 的配置分为两个文件：config.yml 用于调整插件行为，categories.yml 用于配置或创建连锁采集的工具类别、方块列表。

config.yml 主要选项

MetricsEnabled: true          # 启用 bStats 统计
PerformUpdateChecks: true     # 检查 Spigot 更新
DefaultActivationStrategy: SNEAK  # 默认激活策略：NONE, SNEAK, STAND, ALWAYS
DefaultVeinMiningPattern: 'veinminer:default'  # 默认采集模式
CollectItemsAtSource: true    # 物品是否在源方块处掉落
CollectExperienceAtSource: true  # 经验球是否在源方块处掉落
OnlyDamageOnFirstBlock: false # 是否仅对第一个方块计算工具耐久损耗
MaxVeinSize: 64               # 单次连锁最多破坏的方块数
Cost: 0.0                     # 每次使用连锁采集消耗的货币（需要 Vault 和经济插件）
DisabledWorlds:               # 禁用连锁采集的世界列表
- WorldName
DisabledGameModes:            # 禁用连锁采集的游戏模式列表
- CREATIVE
- SPECTATOR

其他选项：包括饥饿值消耗、客户端模组控制、数据存储方式（JSON, SQLite, MySQL）、方块别名（Aliases）等。

categories.yml 结构

在此文件中，你可以为每个工具类别（如 Axe, Pickaxe）定义：

  • Items：该类别可使用的工具物品列表。
  • BlockList：该类别可连锁采集的方块列表。
  • 可覆盖的全局配置：RepairFriendly, MaxVeinSize, Cost, DisabledWorlds。
  • Priority：当多个类别包含同一物品时，决定优先级的整数。
  • NBT：要求工具必须包含的特定 NBT 值。

**方块列表说明**

  • 使用游戏内 ID，minecraft: 前缀可选。
  • 可指定方块状态，例如 minecraft:chest[waterlogged=true]。
  • 支持原版标签，例如 #minecraft:coal_ores。

兼容性与扩展

支持的反作弊插件

VeinMiner 原生支持许多流行的反作弊插件，防止玩家因“快速破坏”而被误封。已支持的列表包括：

如需添加其他反作弊支持，请在讨论帖、Discord 或 GitHub 提交请求。

PlaceholderAPI 占位符

插件支持以下 PlaceholderAPI 占位符：

  • %veinminer_enabled%：玩家是否启用了连锁采集。
  • %veinminer_enabled_<category>%：特定类别是否启用。
  • %veinminer_active%：连锁采集是否处于激活状态（如按下快捷键时）。
  • %veinminer_vein_mining%：玩家当前是否正在连锁采集（瞬时状态）。
  • %veinminer_vein_mineable%：玩家手持工具的目标方块是否可连锁采集。
  • %veinminer_using_client_mod%：玩家是否在使用客户端模组。
  • %veinminer_pattern%：玩家当前选择的采集模式。
  • %veinminer_activation_strategy%：玩家选择的激活方式。
  • %veinminer_category%：玩家手持工具所属的类别。
  • %veinminer_cost%：连锁采集的消耗成本。
  • %veinminer_max_vein_size%：单次连锁的最大方块数量。

如需更多占位符，请在讨论帖、Discord 或 GitHub 提交功能请求。

开发者 API

VeinMiner 提供了完整的开发者 API。

  • Javadocs：[链接](Javadocs)
  • 源代码：[GitHub](Source Code (GitHub))
  • 协议文档：[链接](Protocol Documentation)

**依赖信息**

<!-- Maven -->
<repository>
    <id>choco-repository</id>
    <url>https://repo.choco.wtf/releases</url>
</repository>
<dependency>
    <groupId>wtf.choco</groupId>
    <artifactId>veinminer-bukkit</artifactId>
    <version>2.4.0</version>
    <scope>provided</scope>
</dependency>
// Gradle Groovy
repositories {
    maven { url "https://repo.choco.wtf/releases" }
}
dependencies {
    compileOnly "wtf.choco:veinminer-bukkit:2.4.0"
}
// Gradle Kotlin DSL
repositories {
    maven("https://repo.choco.wtf/releases")
}
dependencies {
    compileOnly("wtf.choco:veinminer-bukkit:2.4.0")
}

常见问题 (FAQ)

  • 能否自定义快捷键（如 Shift、~、鼠标侧键）？
  • 可以，但这不是服务器端的功能。VeinMiner 是服务器端插件，无法监听按键。玩家需要安装可选的客户端 Fabric 模组（VeinMiner Companion Mod）来实现自定义快捷键。未安装模组的玩家需使用配置中指定的激活方式（如潜行）。
  • 是否会支持模组方块？
  • 永远不会。这在技术上不可行（除非为 Sponge 平台重写）。对于模组服务器，建议使用 portablejim 的 VeinMiner 模组、Ore Excavation 或 FTB Ultimine。
  • 附魔（原版或自定义）能与 VeinMiner 协同工作吗？
  • 是的！连锁采集时会尊重时运、精准采集等附魔效果。自定义附魔插件通常也能正常工作。
  • 我能只让特定玩家组使用 VeinMiner 吗？
  • 可以。默认情况下所有玩家都有权限。你可以通过权限插件（如 LuckPerms）否定默认组的 veinminer.veinmine.* 权限，然后将其授予其他特定组。
  • 为什么我不能连锁采集某个方块？
  • VeinMiner 提供了默认的方块列表。如果某个方块不在列表内，你就无法连锁采集它。你可以使用命令 /veinminer blocklist <工具类别> add <方块ID> 来添加它。
  • VeinMiner 支持 McMMO 吗？
  • 支持。玩家会为每个被破坏的方块获得 McMMO 经验。如果你觉得这过于强大，可以在配置中启用 NerfMcMMO: true，这样玩家只会在破坏第一个方块时获得经验。

如有更多问题，请随时加入 Discord 服务器 ([链接](link))。

免责声明：本插件与 Minecraft Forge 的 VeinMiner 模组及其作者 portablejim 没有任何关联或合作。这是为 CraftBukkit、Spigot 和 Paper 服务器重新实现的流行功能。

贡献与支持

  • 贡献代码：VeinMiner 已在 GitHub 上开源，欢迎贡献代码。访问 [VeinMiner 公共仓库](VeinMiner's public repository) 进行克隆、分支或提交拉取请求。被采纳的贡献将在更新日志中获得署名。
  • 支持开发者：此插件完全免费。如果你喜欢这个项目并希望支持开发工作，可以考虑在 [GitHub 上赞助我](sponsoring me on GitHub)。捐赠并非强制，但你的支持将备受感激！
测试支持版本
1.21 26.1
版本分布
基本信息
插件名称 VeinMiner
作者 2008Choco
平台 Bukkit / Spigot
支持版本 1.21 - 26.1
点赞数 44
Modrinth 下载 40,622,748
最近版本
2.4.0 2041
2.3.0 404
2.3.1 304
2.2.6 152
2.2.4 57
2.0.0 41
2.2.5 23
2.1.1 22
1.17.10 19
2.1.0 12
1.14.0 4
1.17.9 3

友情链接： 网易我的世界 | 泰拉瑞亚 | ocent云计算 | 米饭Minecraft插件文档 | 友链合作

历史访问人数：4,947,542  |  历史访问人次：5,875,140

今日访问人数：27,232  |  今日访问人次：29,900

昨日访问人数：31,598  |  昨日访问人次：36,155

Copyright © 2019-2026 我的世界服务器列表站. All rights reserved.

❤ Powered by GermMC 京ICP备17023959号-6