VeinMiner - 连锁挖矿

Minecraft Forge的VeinMiner插件在Spigot服务器上的重制版。

Bukkit / Spigot 作者 2008Choco 支持版本 1.21 - 26.1

访问 Spigot 下载插件

服务器使用量

3,566

服务玩家数

1,142

下载量

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

AAC (Advanced AntiCheat) 5.x
AntiAura
FoxAddition (通过其插件)
Grim Anti Cheat 2.3.72+
Intave
LightAntiCheat
Matrix 6.x+
Negativity
NoCheatPlus
Polar
Spartan
Themis
Vulcan (需在其配置中启用 enable-api: true)

如需添加其他反作弊支持，请在讨论帖、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