[API] TabListAPI - 标签页列表修改接口

💡简介

此 API 可让你轻松修改游戏中的玩家列表（Tablist），包括自定义列表头部、底部文本以及列表条目，并支持为条目设置独立的皮肤图标。

🎮功能特性

• 修改 Tablist 的头部（Header）和底部（Footer）文本。
• 修改 Tablist 中的条目（Entries）。
• 支持独立的皮肤图标（皮肤名称可以与显示的名称不同）。

🔧使用方法

修改头部/底部文本

你可以使用 TabAPI.setHeader 和 TabAPI.setFooter 方法来为指定玩家设置 Tablist 的头部和底部文本。

public void setHeaderAndFooter(Player player) {
    TabAPI.setHeader(player, "§9Welcome to the server, ", "§a" + player.getName() + "!");
    TabAPI.setFooter(player, "§2Online players", "§7" + Bukkit.getOnlinePlayers().size() + "§8/§6100");
}

修改列表条目

你可以使用 TabAPI.clearAllItems 清除所有条目，然后使用 TabAPI.setItems 来设置新的自定义条目。

public void setItems(Player player) {
    TabAPI.clearAllItems(player); // 移除所有现有条目
    // 添加我们的自定义条目
    TabAPI.setItems(player, Arrays.asList(
        new TabItem("§0§c§lAdmins"),
        new TabItem("§1§fYou!")
    ));
}

玩家加入时修改

如果你想在玩家加入服务器时修改其 Tablist，建议延迟几刻（ticks）再执行，以确保客户端已准备就绪。

Bukkit.getScheduler().runTaskLater(plugin, new Runnable() {
    @Override
    public void run() {
        setHeaderAndFooter(player);
        setItems(player);
    }
}, 10);

✨依赖集成（Maven）

在你的 pom.xml 文件中添加以下仓库和依赖配置。

<repositories>
    <repository>
        <id>inventive-repo</id>
        <url>https://repo.inventivetalent.org/content/groups/public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>org.inventivetalent</groupId>
        <artifactId>tabapi</artifactId>
        <version>1.1.1</version>
    </dependency>
</dependencies>

⭐相关链接

• 源代码: 查看项目源码
• API 文档: 查阅 Javadocs
• 插件主页: 访问插件网站