Universal Vein Miner
2008Choco's VeinMiner 的分支版本
2008Choco's VeinMiner 现已原生支持 Folia,请前往其插件页面 这里 获取更快的更新
本 Minecraft (Bukkit) 插件旨在为 CraftBukkit 和 Spigot 服务器重现 portablejim 广受欢迎的 Minecraft Forge 模组 VeinMiner。本项目遵循 GPLv3 许可协议,发布版本均在 GitHub 上提供以符合该许可要求。您目前位于 VeinMiner (for Bukkit) 的 GitHub 页面。portablejim 的 VeinMiner (for Forge) 仓库可在 这里 找到。欢迎您 Fork 本项目并提交 Pull Request,或通过 Issue 跟踪器请求功能或报告 Bug。
概述
Universal Vein Miner 引入了一种对原版友好的机制,允许玩家瞬间挖掘一组相邻的方块,仅节省宝贵的时间。无论是矿石群、大型树木、广阔的农田还是其他更多类型,均可一键开采。每种工具都可以拥有自己可配置的方块列表,从而带来无限的可能性。这是监狱服、阵营服和半原版服务器的绝佳加成,它既不会破坏游戏平衡,又能让捐赠服务器的玩家获得丰厚的回报。

功能简介:
- 高效地连续挖掘同类方块
- 强大的配置系统,支持自定义工具类别和方块列表
- 多种挖掘模式,可挖掘立方体区域、隧道或楼梯
- 可选的经济系统支持
- 可选的客户端侧模组,支持自定义按键绑定
- 开发者 API,用于自定义挖掘模式和行为
- 默认情况下,服务器所有者可通过拖放方式安装,无需额外步骤
- 原生支持反作弊系统和 PlaceholderAPI
客户端配套模组(当前与 Folia 版本的插件不兼容)
配套模组是一个可选的客户端侧模组,旨在为玩家提供更丰富的用户体验,包括支持自定义按键绑定、切换模式的快捷键以及矿脉挖掘时的线框渲染效果。此模组可下载并安装在 Fabric 客户端上。

命令:
-
/veinminer ...
/veinminer reload
- 重新加载
config.yml 和 categories.yml 并应用您在文件中进行的任何更改
- 权限:
veinminer.command.reload
/veinminer version
/veinminer toggle [tool]
- 启用或禁用矿脉挖掘
- 如果提供了参数,则切换特定工具的开关状态
- 权限:
veinminer.command.toggle
/veinminer mode <mode>
- 更改激活矿脉挖掘的方式
- 要使用
"client" 模式,您的客户端必须安装 VeinMiner Companion Mod
- 权限:
veinminer.command.mode
/veinminer pattern <pattern>
- 更改矿脉挖掘搜索和破坏方块的方式
- 模式可由附加组件注册,但 VeinMiner 自带以下模式:
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
/veinminer blocklist ...
/veinminer toollist ...
-
/blocklist ...
/blocklist <category> add <block>
- 将可矿脉挖掘的方块添加到指定类别
- 方块可以使用通用 ID 如
minecraft:stone,也可以包含状态如 minecraft:chest[waterlogged=true]
- 权限:
veinminer.command.blocklist
/blocklist <category> remove <block>
- 从指定类别中移除一个方块
- 方块可以使用通用 ID 如
minecraft:stone,也可以包含状态如 minecraft:chest[waterlogged=true]
- 权限:
veinminer.command.blocklist
/blocklist <category> list
- 列出所有可使用指定类别进行矿脉挖掘的方块(及方块状态)
- 权限:
veinminer.command.blocklist
-
/toollist ...
/toollist <category> add <item>
- 将物品添加到指定类别的工具列表中
- 权限:
veinminer.command.toollist
/toollist <category> remove <item>
- 从指定类别的工具列表中移除一个物品
- 权限:
veinminer.command.toollist
/toollist <category> list
- 列出所有可用于指定类别的物品
- 权限:
veinminer.command.toollist
支持的反作弊系统
Universal Vein Miner 原生支持许多流行的反作弊系统,以确保您的玩家不会因“快速破坏”(或您所选择反作弊系统的等效标记)而被误判。如果您使用的反作弊系统未在此列出,那么使用矿脉挖掘的玩家极有可能因破坏方块过快而被错误标记。如果您希望添加对其他反作弊系统的支持,请在讨论区、Discord 或 GitHub 上的 Issue 中提出请求。
- AAC (Advanced AntiCheat) 5.x
- AntiAura
- FoxAddition (通过其插件)
- Grim Anti Cheat 2.3.59+
- LightAntiCheat
- Matrix 6.x+
- Negativity
- NoCheatPlus
- Spartan
- Themis
- Vulcan
- Vulcan 有一个配置选项用于启用 API,默认情况下是禁用的。需将
enable-api 设置为 true
占位符 (PlaceholderAPI)
Universal Vein Miner 很高兴支持 PlaceholderAPI,并提供以下占位符:
-
"%veinminer_enabled%"
VeinMiner 是否已开启。
-
"%veinminer_enabled_<category>%"
VeinMiner 针对指定类别是否已开启。
-
"%veinminer_active%"
VeinMiner 是否处于激活状态(例如玩家按下了快捷键)。
-
"%veinminer_vein_mining%"
根据玩家当前是否正在执行群矿开采,返回 "true" 或 "false"。
仅在短暂的一瞬间为 "true"。
-
"%veinminer_vein_mineable%"
如果玩家的目标方块可以使用手持工具进行群矿开采,则提供 "true",否则提供 "false"。
需要指定玩家。
-
"%veinminer_vein_mineable_<category>%"
如果玩家的目标方块可以使用指定类别的工具进行群矿开采,则提供 "true",否则提供 "false"。
需要指定玩家。
-
"%veinminer_using_client_mod%"
根据玩家是否在使用客户端模组,返回 "true" 或 "false"。
-
"%veinminer_pattern%"
玩家所选的群矿开采模式键值。
-
"%veinminer_activation_strategy%"
玩家所选的激活方式名称(如 "Sneak"、"Client"、"Always" 等)。
-
"%veinminer_category%"
提供玩家手中工具的类别名称。
需要指定玩家。
-
"%veinminer_cost%"
提供群矿开采的成本。
- 如果指定了玩家,将计算玩家主手工具的成本(如果手中没有类别,则使用全局配置的成本),并考虑
"free economy" 权限的影响。
- 如果没有指定玩家,则提供全局配置的成本。
-
"%veinminer_cost_<category>%"
提供指定类别的群矿开采成本。
- 如果指定了玩家,将考虑
"free economy" 权限的影响。
-
"%veinminer_max_vein_size%"
提供单次群矿开采可挖掘的最大方块数量。
- 如果指定了玩家,将提供玩家主手工具的最大群矿尺寸(如果手中没有类别,则使用全局配置的最大群矿尺寸)。
- 如果没有指定玩家,则提供全局配置的最大群矿尺寸。
-
"%veinminer_max_vein_size_<category>%"
提供指定类别的最大群矿尺寸。
消息协议
Universal Vein Miner 通过其 自定义负载数据包 与 Minecraft 客户端通信。虽然 VeinMiner 拥有自己的客户端配套模组,但其他客户端模组也能够监听这些频道并拦截消息。此外,尽管 VeinMiner 提供了与客户端通信的 API,服务器也可以选择监听原始消息内容。
Universal Vein Miner
A fork of 2008Choco's VeinMiner
2008Choco's VeinMiner now support Folia natively, check out his plugin here for faster updates
This Minecraft (Bukkit) plugin aims to recreate portablejim's popular Minecraft Forge mod, VeinMiner, for CraftBukkit and Spigot servers. Licensed under GPLv3, releases are made on GitHub to comply with this license. You are currently on the GitHub page for VeinMiner (for Bukkit). portablejim's VeinMiner (for Forge) repository may be found here. You are welcome to fork this project and create a pull request or request features/report bugs through the issue tracker.
Overview
Universal Vein Miner introduces a vanilla-friendly mechanic that allows players to instantly mine groups of adjacent blocks, saving nothing more than precious time. Groups of ores, large trees, vast crop fields, and more. Each tool can have its own configurable block list allowing for limitless possibilities. This is a fantastic perk for Prison, Factions and Semi-Vanilla servers that isn't overpowered but still gives players a rewarding benefit for donating to your server.

Features In Brief:
- Efficient mining of similar blocks in quick succession
- Powerful configuration for custom tool categories and block lists
- A variety of mining patterns to mine cubic regions, tunnels, or staircases
- Optional economy support
- Optional client-sided mod for custom keybinds
- A developer API for custom mining patterns and behaviors
- Drag-and-drop installation with no additional steps for server owners by default
- Native Anti Cheat and PlaceholderAPI support
Client Companion Mod (Currently incompatible with Folia version of plugin)
The companion mod is an optional client-sided mod to provide a more rich user-experience for players including support for custom keybinds, keybinds for pattern switching, and vein mining wire frame rendering. This can be downloaded and installed for Fabric clients.

Commands:
-
/veinminer ...
/veinminer reload
- Reload the
config.yml and categories.yml and apply any changes you've made in the file
- Permission:
veinminer.command.reload
/veinminer version
- View version and developer information about VeinMiner
/veinminer toggle [tool]
- Enable or disable vein mining
- If provided, toggle a specific tool
- Permission:
veinminer.command.toggle
/veinminer mode <mode>
- Change the way vein mining should be activated
- To use
"client", the VeinMiner Companion Mod must be installed on your client
- Permission:
veinminer.command.mode
/veinminer pattern <pattern>
- Change the way vein mining will search for and break blocks
- Patterns may be registered by add-ons, but VeinMiner provides:
default
tunnel
staircase_up
staircase_down
- Permission:
veinminer.command.pattern
/veinminer givetool <category> <tool> [amount]
- Give yourself a tool from the given category (useful for tools with NBT)
- Permission:
veinminer.command.givetool
/veinminer import
- A tool for VeinMiner versions prior to 2.0.0 to import legacy JSON data into the new SQLite format
- Permission:
veinminer.command.import
/veinminer blocklist ...
/veinminer toollist ...
-
/blocklist ...
/blocklist <category> add <block>
- Add a vein mineable block to the given category
- Blocks can be Universal ids like
minecraft:stone, or with states like minecraft:chest[waterlogged=true]
- Permission:
veinminer.command.blocklist
/blocklist <category> remove <block>
- Remove a block from the given category
- Blocks can be Universal ids like
minecraft:stone, or with states like minecraft:chest[waterlogged=true]
- Permission:
veinminer.command.blocklist
/blocklist <category> list
- List all blocks (and block states) that are vein mineable with the given category
- Permission:
veinminer.command.blocklist
-
/toollist ...
/toollist <category> add <item>
- Add an item to the given category's tool list
- Permission:
veinminer.command.toollist
/toollist <category> remove <item>
- Remove an item from the given category's tool list
- Permission:
veinminer.command.toollist
/toollist <category> list
- List all items useable for the given category
- Permission:
veinminer.command.toollist
Supported Anti Cheats
Universal Vein Miner natively supports many popular anti cheats so that your players will not be flagged with "fast break" (or whatever the equivalent flag is for your anti cheat of choice). If the anti cheat you are using is not listed here, there is a high chance that players using vein miner will be false flagged for breaking blocks too quickly. If you want another anti cheat added to this list, please request it be supported either in the Discussion Thread, on Discord, or on GitHub as an issue.
- AAC (Advanced AntiCheat) 5.x
- AntiAura
- FoxAddition (via their plugin)
- Grim Anti Cheat 2.3.59+
- LightAntiCheat
- Matrix 6.x+
- Negativity
- NoCheatPlus
- Spartan
- Themis
- Vulcan
- Vulcan has a config option to enable the API, which is disabled by default. enable-api must be true
Placeholders (PlaceholderAPI)
Universal Vein Miner happily supports PlaceholderAPI with the following placeholders:
-
"%veinminer_enabled%"
Whether or not VeinMiner is toggled on.
-
"%veinminer_enabled_<category>%"
Whether or not VeinMiner is toggled on for a given category.
-
"%veinminer_active%"
Whether or not VeinMiner is active (e.g. the player has the keybind pressed).
-
"%veinminer_vein_mining%"
"true" or "false" depending on whether or not the player is currently vein mining.
Only "true" for a brief moment in time.
-
"%veinminer_vein_mineable%"
Provides "true" if the player's target block is vein mineable with the tool in hand, or "false" otherwise.
Requires player.
-
"%veinminer_vein_mineable_<category>%"
Provides "true" if the player's target block is vein mineable with the specified category, or "false" otherwise.
Requires player.
-
"%veinminer_using_client_mod%"
"true" or "false" depending on whether or not the player is using the client mod.
-
"%veinminer_pattern%"
The key of the player's selected vein mining pattern.
-
"%veinminer_activation_strategy%"
The name of the player's selected method of activation ("Sneak", "Client", "Always", etc.).
-
"%veinminer_category%"
Provides the name of the category of the tool in the player's hand.
Requires player.
-
"%veinminer_cost%"
Provides the cost of vein mining.
- If a player is specified, provides the cost of the tool in the player's main hand (or the globally configured cost if no category is in hand), accounting for the
"free economy" permission.
- If a player is not specified, provides the globally configured cost.
-
"%veinminer_cost_<category>%"
Provides the cost of vein mining for the specified category.
- If a player is specified, accounts for the
"free economy" permission.
-
"%veinminer_max_vein_size%"
Provides the maximum amount of blocks mineable in a single vein mine.
- If a player is specified, provides the max vein size of the tool in the player's main hand (or the globally configured max vein size if no category is in hand).
- If a player is not specified, provides the globally configured max vein size.
-
"%veinminer_max_vein_size_<category>%"
Provides the max vein size of the specified category.
Messaging Protocol
Universal Vein Miner communicates with the Minecraft client via its custom payload packet. While VeinMiner does have its own client-sided companion mod, other client mods are capable of listening to these channels and intercepting messages. Additionally, while VeinMiner supplies API to communicate with the client, servers also have the option of listening to the raw message contents.
评论 0
登录后参与评分
还没有评论,来抢沙发吧