Tablist - 自定义标签页库

Tablist 是一个基于发送 80 个虚拟玩家的库，每个虚拟玩家对应列表中的一个条目。这个库是一个工具，可以帮助你发送自定义的玩家列表（Tablist）。

💡插件信息

本插件使用以下库

https://www.spigotmc.org/resources/...ated-tablist-header-footer-and-entries.78122/

🎮安装

• 将插件文件放入服务器的 plugins 文件夹中。

🔧开发者指南：如何使用此库

要使用此库，你需要创建 TablistManager 对象，并实现 TablistGenerator 和 TablistUpdater 类。

创建 TablistManager

通过以下构造函数创建 TablistManager 对象：

public TablistManager(TablistGenerator generator, TablistUpdater updater) throws Exception

创建后，你需要实现两个抽象类。

实现 TablistGenerator

TablistGenerator 是一个抽象类，用于生成列表的头部、底部和条目内容。

public abstract class TablistGenerator {
    public abstract String[] generateHeaderFooter(Player player);
    public abstract TabEntry[] generateBars(Player player);
}

• generateHeaderFooter 方法为指定玩家创建列表的头部和底部文本。
• generateBars 方法为指定玩家创建列表条目，必须返回一个大小为 80 的 TabEntry 数组。

理解 TabEntry

TabEntry 代表列表中的一个“条目”（即一个虚拟玩家），包含文本、延迟（Ping）和皮肤信息。

public class TabEntry {
    public String text = "";
    public int ping = 10000;
    public Property head;
    // ... 构造函数和方法
}

你可以使用其方法设置文本、延迟和皮肤。

实现 TablistUpdater

TablistUpdater 是一个抽象类，用于监听事件并创建任务来更新列表条目。

public abstract class TablistUpdater {
    public abstract void start(TablistManager manager);
    public abstract void stop();
}

在此类中，你可以监听可能改变列表内容的事件，并更新指定的条目。

更新列表条目

要更新某个条目，可以从 TablistManager 获取 PlayerTablist 对象，并调用其 updateBar 方法：

public void updateBar(int index, @Nonnull TabEntry entry)

• index 参数是条目的索引（0 到 79）。
• entry 参数是新的 TabEntry 对象。

处理 TablistLoadEvent

在所有插件启用后，Tablist 会触发 TablistLoadEvent 事件。

public class TablistLoadEvent extends Event {
    public void setTablistManager(TablistManager manager);
    public TablistManager getTablistManager();
}

你应该在这个事件中设置你自己的 TablistManager 实例，Tablist 插件会处理其余的工作。

❓示例与警告

效果示例

你可以参考插件 RefreshTablist 查看使用此库的效果：

https://www.spigotmc.org/resources/78122/

重要警告

• 此插件将不支持 Minecraft 1.17 及以上版本，因为其内部使用的 NMS（Net Minecraft Server）代码在该版本发生了重大变化。