UltimateAdvancementAPI

插件

· 作者 frengor

一个强大的 API,用于为你的 Minecraft 服务器创建自定义进度。

10 本站下载 0 关注 更新于 1 个月前

最新 3.0.0-beta-4 · 26.3 · Bukkit / Paper

一键开服(送7天)

Wiki • Issues • Javadoc • GitHub • Discord • Generator • FAQ

Advancement Tab Image

请在 Discord 上报告错误,或在 GitHub 上提交 Issue。

如果 Minecraft 刚发布了新版本且你正在等待更新,请查看常见问题解答。

3.0.0 Beta

3.0.0 Beta 可在 main-3.0.0 分支获取。如果你想试用,请下载它。
Beta 版本的 Javadoc 发布在这里。


简单 - 轻松为你的服务器创建进度
异步 - 所有操作均基于数据包。这意味着服务器不会卡顿!
进度可见性 - 易于使用的可见性系统,可自定义进度的显示状态
团队进度 - 同一团队成员之间的玩家进度同步
离线玩家支持 - 提供广泛且完整的 API 来修改离线玩家的进度
提示框 (Toasts) - 发送自定义提示框通知
数据库系统 - 快速可靠的存储方案,支持任意位置(SQLite、MySQL、内存)
禁用原版进度 - 无需触碰服务端 jar 包即可完全禁用原版进度

这是一个面向开发者的插件。如果你使用的某个插件依赖于此,只需下载适合你服务器的版本并将其放入 plugins 文件夹即可。

通过 Maven 将依赖添加到你的项目中并开始编码。
查看 Wiki 以了解如何使用该 API。

Maven
<repositories>
    <repository>
        <id>fren_gor</id>
        <url>https://nexus.frengor.com/repository/public/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.frengor</groupId>
    <artifactId>ultimateadvancementapi</artifactId>
    <version>2.8.2</version>
    <scope>provided</scope>
</dependency>

还有可阴影化(shadeable)的版本,请参阅相关 Wiki 页面了解更多详情。

完全可定制 - 创建你自己的进度
易于使用 - 完整且文档完善的 API
支持玩家团队 - 通过原生团队支持让更多玩家协作
Maven 和可阴影化版本 - API 通过 Maven 分发,并可被阴影化集成到你的插件中
良好的支持 - 在我们的 Discord 服务器 上提问
在线生成器 - API 附带 UltimateAdvancementGenerator,这是帮助你图形化设计进度图的官方工具

UltimateAdvancementGenerator

用于图形化设计进度的官方在线工具。随后,该工具会自动为你的插件生成 Java 类。

立即尝试
UltimateAdvancementGenerator (NEW)

UltimateAdvancementGenerator (OLD)

视频教程(旧版生成器)



视频教程(新版生成器)

制作中 (WIP)

❗警告❗:该工具仍处于 BETA 阶段,请在 GitHub 上报告错误。


命令与权限

/ultimateadvancementapi <progression|grant|revoke> ...
权限: ultimateadvancementapi.command

/ultimateadvancementapi grant <all|tab|one> ...
权限: ultimateadvancementapi.grant

/ultimateadvancementapi grant all <player> [giveRewards]
权限: ultimateadvancementapi.grant.all

/ultimateadvancementapi grant tab <advancementTab> [player] [giveRewards]
权限: ultimateadvancementapi.grant.tab

/ultimateadvancementapi grant one <advancement> [player] [giveRewards]
权限: ultimateadvancementapi.grant.one

/ultimateadvancementapi revoke <all|tab|one> ...
权限: ultimateadvancementapi.revoke

/ultimateadvancementapi revoke all <player> [hideTab]
权限: ultimateadvancementapi.revoke.all

/ultimateadvancementapi revoke tab <advancementTab> [player] [hideTab]
权限: ultimateadvancementapi.revoke.tab

/ultimateadvancementapi revoke one <advancement> [player]
权限: ultimateadvancementapi.revoke.one

/ultimateadvancementapi progression <get|set> ...
权限: ultimateadvancementapi.progression

/ultimateadvancementapi progression get <advancement> [player]
权限: ultimateadvancementapi.progression.get

/ultimateadvancementapi progression set <advancement> <progression> [player] [giveRewards]
权限: ultimateadvancementapi.progression.set


// 创建一个名为 "Example" 的进度,描述为:
// - "A random"
// - "description."
public class MainClass extends JavaPlugin implements Listener {

```java
private AdvancementTab advancementTab;
    private UltimateAdvancementAPI api;

    @Override
    public void onEnable() {
        api = UltimateAdvancementAPI.getInstance(this);

        advancementTab = api.createAdvancementTab("your_tab_name");

        AdvancementDisplay rootDisplay = new AdvancementDisplay(Material.GRASS_BLOCK, "Example", AdvancementFrameType.TASK, true, true, 0, 0, "A random", "description.");

        RootAdvancement root = new RootAdvancement(advancementTab, "root", rootDisplay, "textures/block/stone.png");

        advancementTab.registerAdvancements(root);

        Bukkit.getPluginManager().registerEvents(this, this);
    }

    @EventHandler
    public void onJoin(PlayerLoadingCompletedEvent e) {
        // Called after a player has successfully been loaded by the API
        Player p = e.getPlayer();
        // Here you can show tabs to players
        advancementTab.showTab(p);
    }
}

结果:
示例的结果


bStats


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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源