HologramLib | 排行榜与自定义全息

插件

原名 HologramLib | Leaderboards & Custom Holograms · 作者 maximjsx

基于数据包的文本显示库,支持动画、排行榜、表情符号、迷你消息等功能!

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

需要前置:PacketEvents

最新 1.8.3 · 1.21.10 · Folia / Paper

一键开服(送7天)

FOLIA ✅ PAPER ✅ PURPUR ✅ 1.19.4 - 1.21.5 ✅

jitpack
HologramLib

一款易于使用的、基于数据包的文本/物品/方块显示全息 API,支持 MiniMessage 和表情符号。

功能特性

  • 文本、方块与物品全息图
  • 文本动画
  • 支持 MiniMessage
  • 基于数据包
  • 玩家专属全息图
  • 排行榜生成器
  • 高级全息图自定义
  • 支持附加(Attachment)和父级关联(Parenting)
  • 灵活的渲染模式
免责声明 此 API 仅适用于 1.19.4+ 版本
Bedrock(基岩版)玩家无法看到这些全息图
在旧版本上使用 Spigot 时可能会出现一些问题(建议使用 Paper 或其分支)
这只是一个 Java API。此插件不能独立运行。

设置

  • 下载插件 .jar 文件
  • 下载 Packet Events
  • 将 .jar 文件上传到服务器(yourserver/plugins 文件夹)
  • 在你的插件中将此插件添加为依赖项并使用它

项目设置

Gradle 安装

repositories {
  maven { url 'https://jitpack.io' }
}

dependencies {
  compileOnly 'com.github.HologramLib:HologramLib:1.7.6'
}

Maven 安装

<repository>
  <id>jitpack.io</id>
  <url>https://jitpack.io</url>
</repository>

<dependency>
  <groupId>com.github.HologramLib</groupId>
  <artifactId>HologramLib</artifactId>
  <version>1.7.6</version>
  <scope>provided</scope>
</dependency>

将此添加到你的 plugin.yml 中:

depend:
  - HologramLib

代码示例

获取实例

private HologramManager hologramManager;

@Override
public void onLoad() {
    HologramLib.onLoad(this); /* 仅当你阴影化(shade)了 HologramLib 时才需要 */
}

@Override
public void onEnable() {
    hologramManager = HologramLib.getManager().orElse(null);
    if (hologramManager == null) {
        getLogger().severe("Failed to initialize HologramLib manager.");
        return;
    }
}

创建全息图

TextHologram hologram = new TextHologram("unique_id")
    .setMiniMessageText("<aqua>Hello world!")
    .setSeeThroughBlocks(false)
    .setBillboard(Display.Billboard.VERTICAL)
    .setShadow(true)
    .setScale(1.5F, 1.5F, 1.5F)
    .setTextOpacity((byte) 200)
    .setBackgroundColor(Color.fromARGB(60, 255, 236, 222).asARGB())
    .setAlignment(TextDisplay.TextAlignment.CENTER)
    .setViewRange(1.0)
    .setMaxLineWidth(200);

生成与移除

hologramManager.spawn(hologram, <location>);
hologramManager.remove(hologram);

动画

TextAnimation animation = new TextAnimation()
        .addFrame( "<red>First frame")
        .addFrame("<green>Second frame")
        .addFrame("Third frame\n" +
                "Second line in third frame")
        .addFrame("Last frame");
animation.setDelay(20L); // 1 秒
animation.setDelay(20L * 2);
hologramManager.applyAnimation(this.hologram, animation);

排行榜

Map<Integer, String> leaderboardData = new LinkedHashMap<>() {{
    put(1, "MaximDe:1000");
    put(2, "dream:950");
    put(3, "BastiGHG:500");
    put(4, "Wichtiger:400");
    // ... 更多条目
}};

LeaderboardHologram leaderboard = hologramManager.generateLeaderboard(
        location,
        leaderboardData,
        LeaderboardHologram.LeaderboardOptions.builder()
                .title("Top Players - Kills")
                .showEmptyPlaces(true)
                .scale(1.2f)
                .maxDisplayEntries(10)
                .suffix("kills")
                .topPlayerHead(true)
                .build()
);

Wiki

代码示例及更多内容

示例/展示插件

更多信息

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源