AdvancementLib
AdvancementLib 是一个现代、流畅的 Java 库,用于在 PaperMC Minecraft 插件中创建自定义进度。
它让你能够轻松地注册和管理响应任何 Bukkit 事件的进度,使用强大的基于构建器的 API。
✨ 功能特性
- 注册自定义触发器: 监听任意 Bukkit 事件(例如:方块破坏、实体死亡、玩家操作)作为进度触发条件。
- 自定义条件: 定义你自己的逻辑来决定何时推进或授予进度——非常适合独特的游戏挑战。
- 支持原版与自定义进度: 既可以提供内置的 Minecraft 进度,也可以提供你自己的自定义进度。
- 进度追踪: 轻松设置多步骤进度(例如:“破坏 100 个方块”),并为每个玩家自动追踪进度。
- 构建器 API: 使用流畅的构建器配置触发器、条件和进度逻辑。
- 自定义进度增量: 确定每个事件授予多少进度(默认为 1,但可自定义)。
? 快速开始
1. 添加依赖
在你的项目中使用首选的构建工具或项目设置方法将 AdvancementLib 作为依赖项添加。
注意:如果尚未存在,请添加 PaperMC 仓库。
2. 基本用法
注册进度
import io.github.lambdaphoenix.advancementLib.AdvancementAPI;
AdvancementAPI api = new AdvancementAPI(plugin);
api.register(BlockBreakEvent.class)
.advancementKey("myplugin:break_10_stone")
.condition(
(player, event) -> event.getBlock().getType() == Material.STONE
)
.targetValue(10)
.grantMode(GrantMode.ALL_AT_ONCE)
.build();
授予模式
ALL_AT_ONCE:当达到目标值时一次性授予该进度。STEP_BY_STEP:一次授予一个标准(在游戏中显示进度条)。
自定义玩家提取器
api.register(CustomEvent.class)
.advancementKey("myplugin:custom_event")
.playerExtractor(event -> event.getWhoDidIt())
.build();
? API 亮点与文档
- AdvancementAPI – 注册进度的主要入口点。
- AdvancementRegisterBuilder – 用于所有进度选项的流畅构建器。
- GrantMode – 枚举类型,定义授予行为:一次性授予或分步授予。
- PlayerExtractor – 接口,用于将任意事件映射到 Player。
最新的 Javadoc 会自动发布到 GitHub Pages:
➡️ 在此查看 Javadoc
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧