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
⚡ 使用方法
- 将
EssentialUtils-x.x.x.jar放入你的plugins/文件夹中。 - 使用 Paper 1.21.8+ 和 Folia 运行。
- 配置文件 (
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
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧