AdvancementLib

插件

· 作者 lambdaphoenix

一个用于自定义进度触发的小型插件库。

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

最新 0.3.2 · 1.21.8 · Paper

一键开服(送7天)

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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源