zVeinMiner

一款功能强大且高度可配置的矿脉挖掘插件,适用于 Paper/Spigot 服务器(1.21+)。
特性
核心特性
- 矿脉挖掘 - 一次破坏即可开采整个矿脉
- 自定义预设 - 定义多个具有不同大小和方块类型的预设
- 视觉预览 - 潜行时可以看到将要被挖掘的方块(发光效果)
- BFS 算法 - 使用广度优先搜索进行高效的方块检测
- 附魔支持 - 完全支持精准采集和 fortune(效率)附魔
保护集成
- WorldGuard - 尊重区域保护,仅挖掘玩家有权破坏的方块
- GriefPrevention - 尊重领地保护
玩家功能
- 切换系统 - 玩家可以使用
/zveinminer toggle启用或禁用矿脉挖掘 - 统计追踪 - 追踪每位玩家挖掘的总方块数和矿脉数
- 持久数据 - 玩家偏好设置和统计数据保存到 YAML 文件
- 按世界控制 - 对特定世界进行黑名单或白名单管理
经济集成
- Vault 支持 - 按挖掘的方块数量或矿脉次数向玩家收费
- 可配置费用 - 设置每个方块的费用和/或每次矿脉操作的费用
工具管理
- 耐久度检查 - 防止挖掘超过工具耐久度允许数量的方块
- 无损修复支持 - 正确计算带有无损修复附魔的有效耐久度
- 创造模式 - 在创造模式下不消耗耐久度
配置
- 潜行要求 - 可选择要求潜行以激活矿脉挖掘
- 最大尺寸限制 - 全局矿脉大小限制
- 冷却系统 - 可配置矿脉挖掘之间的冷却时间
- 可配置消息 - 所有消息均可自定义
开发者 API
- 自定义事件:
VeinMineStartEvent- 在矿脉挖掘开始前触发(可取消)VeinMineBlockEvent- 针对每个方块触发(可取消)VeinMineCompleteEvent- 在矿脉挖掘完成后触发
- 服务注册 - 通过 Bukkit 的 ServicesManager 访问
VeinManager和PlayerManager - 物品数据 API - 以编程方式将预设和标签应用到物品
命令
| 命令 | 描述 | 权限 |
|---|---|---|
/zveinminer |
显示帮助 | zveinminer.use |
/zveinminer reload |
重新加载配置 | zveinminer.reload |
/zveinminer toggle |
开关矿脉挖掘 | zveinminer.toggle |
/zveinminer list |
列出可用预设 | zveinminer.list |
/zveinminer info |
显示手持物品信息 | zveinminer.info |
/zveinminer stats |
显示你的统计数据 | zveinminer.stats |
/zveinminer apply <preset> |
将预设应用到手持物品 | zveinminer.apply |
/zveinminer set <preset> |
将预设属性设置到物品 | zveinminer.set |
/zveinminer size <size> |
更改物品的矿脉大小 | zveinminer.size |
/zveinminer add <tag> |
向物品添加标签 | zveinminer.add |
/zveinminer remove <tag> |
从物品移除标签 | zveinminer.remove |
/zveinminer give <player> <preset> [material] |
给予带有预设的物品 | zveinminer.give |
权限
| 权限 | 描述 | 默认值 |
|---|---|---|
zveinminer.use |
使用矿脉挖掘 | true |
zveinminer.reload |
重新加载配置 | op |
zveinminer.toggle |
开关矿脉挖掘 | true |
zveinminer.list |
列出预设 | true |
zveinminer.info |
查看物品信息 | true |
zveinminer.stats |
查看统计数据 | true |
zveinminer.apply |
应用预设 | op |
zveinminer.set |
设置预设 | op |
zveinminer.size |
更改矿脉大小 | op |
zveinminer.add |
添加标签 | op |
zveinminer.remove |
移除标签 | op |
zveinminer.give |
给予带有预设的物品 | op |
配置
config.yml
# 调试设置
enable-debug: false
enable-debug-time: false
# 矿脉挖掘设置
vein-mining:
cooldown: 0 # 冷却时间(刻)(0 = 禁用)
max-size-limit: 64 # 最大矿脉大小
require-sneak: false # 是否需要潜行来激活
# 世界设置
worlds:
blacklist:
- world_the_end
whitelist-mode: false # 如果为 true,列表将成为白名单
# 掉落设置
drops:
teleport-to-player: false # 将掉落物传送至玩家
auto-pickup: false # 自动拾取到背包
# 工具设置
tools:
check-durability: true # 挖掘前检查耐久度
apply-damage: true # 施加耐久度损耗
# 经济设置(需要 Vault)
economy:
enabled: false
cost-per-block: 0.0
cost-per-vein: 0.0
# 预设定义
presets:
- name: "pickaxe-1"
size: 8
tags:
- COAL_ORES
- COPPER_ORES
- DIAMOND_ORES
- EMERALD_ORES
- GOLD_ORES
- IRON_ORES
- LAPIS_ORES
- REDSTONE_ORES
- NETHERITE_SCRAP
支持的标签
你可以使用 Bukkit 材料标签(如 COAL_ORES、DIAMOND_ORES)或单独的材料(如 DIAMOND_ORE、DEEPSLATE_DIAMOND_ORE)。
常见矿石标签:
COAL_ORES- 所有煤炭矿石变体COPPER_ORES- 所有铜矿石变体DIAMOND_ORES- 所有钻石矿石变体EMERALD_ORES- 所有绿宝石矿石变体GOLD_ORES- 所有金矿石变体IRON_ORES- 所有铁矿石变体LAPIS_ORES- 所有青金石矿石变体REDSTONE_ORES- 所有红石矿石变体
安装
- 从 Modrinth 下载最新版本
- 将 JAR 文件放入服务器的
plugins文件夹 - 重启服务器
- 在
plugins/zVeinMiner/config.yml中配置插件
依赖
- 服务器: Paper 1.21+(或兼容分支)
- Java: 21 或更高版本
可选依赖
- WorldGuard - 用于区域保护支持
- GriefPrevention - 用于领地保护支持
- Vault - 用于经济集成
- PlaceholderAPI - 用于消息中的占位符支持
API 使用
Maven/Gradle
API 模块可供希望与 zVeinMiner 集成的开发者使用。
访问 API
// 获取 VeinManager
VeinManager veinManager = Bukkit.getServicesManager()
.getRegistration(VeinManager.class)
.getProvider();
// 获取 PlayerManager
PlayerManager playerManager = Bukkit.getServicesManager()
.getRegistration(PlayerManager.class)
.getProvider();
监听事件
@EventHandler
public void onVeinMineStart(VeinMineStartEvent event) {
Player player = event.getPlayer();
Set<Block> blocks = event.getBlocks();
// 取消链式挖掘
if (someCondition) {
event.setCancelled(true);
}
// 修改要挖掘的方块
blocks.removeIf(block -> block.getY() < 0);
}
@EventHandler
public void onVeinMineComplete(VeinMineCompleteEvent event) {
int totalBlocks = event.getTotalBlocksBroken();
// 记录日志或给予玩家奖励
}
支持
- 问题反馈: GitHub Issues
- Discord: GroupeZ Discord
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
28
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧