zVeinMiner

插件

· 作者 Maxlego08

只需挖掘矿脉!再也不用花费数小时挖矿了!节省时间,获取更多矿物

0 本站下载 0 关注 更新于 2 周前

最新 1.1.0 · 26.3 · Paper / Purpur

一键开服(送7天)

zVeinMiner

Vein mining

一款功能强大且高度可配置的矿脉挖掘插件,适用于 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 - 所有红石矿石变体

安装

  1. 从 Modrinth 下载最新版本
  2. 将 JAR 文件放入服务器的 plugins 文件夹
  3. 重启服务器
  4. 在 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();
    // 记录日志或给予玩家奖励
}

支持

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源