EssentialUtils

插件

· 作者 PPekKunGz

砍树、矿脉挖掘和自动农场。

0 本站下载 0 关注 更新于 1 年前

最新 1.21.8-1.0.0 · 1.21.10 · Bukkit / Folia

一键开服(送7天)

Essential Utils

一款针对 Paper/Folia 1.21.8 优化的 Folia 生存便利插件。
添加了平滑、无卡顿的机制,如树木辅助砍伐、矿脉挖掘和自动 farming。


✨ 功能特性

  • ? 树木辅助 (斧头)

    • 以逐方块延迟的方式渐进式砍伐相连的原木(平滑,无性能尖峰)。
    • 树叶检测以避免误砍相邻树木。
    • 可选自动重新种植(树苗/繁殖物),在冷却时间内重试直至成功。
    • 耐久度每 N 个方块减少一次,而非每个方块都减少。
  • ⛏ 矿脉挖掘 (镐子)

    • 渐进式挖掘相连的矿石矿脉。
    • 强制执行 Minecraft 工具等级规则:
      • 如果等级不足 → 无法破坏,并显示提示(限流处理)。
    • 每个方块的延迟随矿脉大小缩放。
    • 耐久度每 N 个方块减少一次。
  • ? 自动农场 (锄头)

    • 仅收割半径内成熟的作物。
    • 不自动重新种植(有意为之)。
    • 针对本地区块扫描进行了优化。
  • ⚙ 激活方式

    • 按住 Shift 键 5 秒 → 激活工具(显示进度条)。
    • 激活后,即使松开 Shift 键也会保持激活状态。
    • 仅当物品栏切换或玩家退出时才会停用。
  • ? 安全性

    • 尊重服务器保护机制(未来支持 WorldGuard/GriefDefender 钩子)。
    • 需要区块已加载。
    • 仅限 Folia 区域安全调度(无异步 hack)。
  • ? 性能

    • 集中化的逐玩家刻预算。
    • 严格的单功能上限。
    • 平滑错开破坏节奏。

? 项目结构

src/main/java/net/ppekkungz/essentialUtils/
├── EssentialUtils.java
├── config/PluginConfig.java
├── state/StateManager.java
├── listener/ActivationListener.java
├── work/
│   ├── WorkService.java
│   ├── WorkItem.java
│   └── WorkQueue.java
├── features/
│   ├── Feature.java
│   ├── tree/TreeAssistFeature.java
│   ├── vein/VeinMineFeature.java
│   └── farm/AutoFarmFeature.java
├── util/
│   ├── HarvestUtil.java
│   ├── Materials.java
│   └── Ores.java
└── indicator/
    ├── BossBarIndicator.java
    └── ActionBarIndicator.java

⚡ 使用方法

  1. 将 EssentialUtils-x.x.x.jar 放入你的 plugins/ 文件夹中。
  2. 使用 Paper 1.21.8+ 和 Folia 运行。
  3. 配置文件 (config.yml) 将在首次运行时自动生成。

命令

/eutils reload   # 重载 config.yml

权限

essentialutils.admin   # 用于 /eutils reload (默认: op)

⚙ 配置亮点

activation:
  holdSneakSeconds: 5
  requireToolWhileHold: true

features:
  treeAssist:
    breakDelayTicks: 2
    durabilityPerNBlocks: 8
    replant:
      enabled: true
      retryCooldownTicks: 5
      maxRetries: 10

  veinMine:
    breakDelayBaseTicks: 1
    breakDelayExtraPer16: 1
    durabilityPerNBlocks: 10
    alertOnInsufficientTier: true

  autoFarm:
    replant: false

? 构建

所需环境:

  • JDK 21
  • Gradle (包含 wrapper)

构建命令:

./gradlew build

Jar 包输出路径:

build/libs/essential-utils-<version>.jar

✅ 待办事项 / 路线图

  • 树木辅助 (渐进式,自动重植,每 N 方块减耐久)
  • 矿脉挖掘 (渐进式,等级提示,延迟缩放,每 N 方块减耐久)
  • 自动农场 (仅成熟作物,不自动重植)
  • 激活机制 (Shift 长按进度条,保持激活状态,切换物品时停用)
  • 配置重载 (/eutils reload)
  • Folia 安全调度
  • 严格的功能上限控制
  • 保护机制钩子 (WorldGuard/GriefDefender)
  • 激活期间显示 BossBar 指示器
  • 针对不同工具类型的可配置耐久规则
  • 其他自动农场作物支持 (竹子、甘蔗、海带)
  • 多语言消息支持
  • 指标开关 (bStats)
  • 逐玩家功能开关命令 (单独启用/禁用功能)

? 许可证

MIT © 2025 ppekkungz

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源