TitleAPI - 标题显示开发库

TitleAPI 是一个简单易用的开发者工具，它允许插件利用 Minecraft 1.8 及更高版本中新增的标题功能。对于服务器所有者，只需安装即可；对于开发者，它提供了简洁的 API 来发送标题、副标题以及设置标签页页眉页脚。

💡版本与下载

最新构建版本应兼容所有 1.8 及更高版本。如果遇到问题，可以尝试以下历史版本：

• 1.7/1.8 协议兼容版：

http://www.spigotmc.org/resources/titleapi.1325/download?version=4390

• Spigot 1.8：

http://www.spigotmc.org/resources/titleapi.1325/download?version=6904

• Spigot 1.8.3：

http://www.spigotmc.org/resources/titleapi.1325/download?version=17987

• Spigot 1.8.4/1.8.5/1.8.6/1.8.7/1.9：

http://www.spigotmc.org/resources/titleapi.1325/download?version=25750

🔧服务器所有者指南

如果你被其他插件指引到此页面，说明你的服务器需要 TitleAPI。

• 下载插件，将其放入服务器的 plugins 目录。
• 重启服务器即可完成安装。
• 自版本 1.1 起，插件添加了 /title 命令，可供日常在服务器中使用。

配置文件 (版本 1.3+)

配置文件支持变量替换，%player% 将被替换为玩家名称。

Title On Join: false
Title Message: "Welcome"
Subtitle Message: "%player% to my server"
Tab Header Enabled: false
Tab Header Message: "My Server"
Tab Footer Message: "My IP"

🎮开发者指南

TitleAPI 设计简单，易于集成和使用。

集成步骤

• 下载插件，并将其作为库导入到你的项目中。
• 建议在你的 plugin.yml 中将 TitleAPI 声明为依赖，以避免潜在错误。

核心 API 用法

发送标题和副标题

TitleAPI.sendTitle(player, fadeIn, stay, fadeOut, "Title", "Subtitle");

• fadeIn, stay, fadeOut 参数为整数，单位是游戏刻（ticks），20 ticks = 1 秒。
• Title 或 Subtitle 可以设置为 null，如果你只想发送其中一个。

TitleAPI.sendTabTitle(player, "Header", "Footer");

已弃用的旧方法

以下为旧版 API，现已弃用

TitleAPI.sendTitle(player, fadeIn, stay, fadeOut, "Message");
TitleAPI.sendSubtitle(player, fadeIn, stay, fadeOut, "Message");
TitleAPI.sendFullTitle(player, fadeIn, stay, fadeOut, "Title Message", "Subtitle Message");

❓重要提示与支持

• 注意：如果你正在为较新版本的 Bukkit/Spigot 编写代码，应优先使用 Player 类中原生的 sendTitle 方法，而不是本插件。
• 注意：旧版本插件已不再提供任何支持。
• 请将 Bug、问题、建议提交至 GitHub Issues 页面：https://github.com/ConnorLinfoot/TitleAPI/issues
• 请勿通过私信联系作者。提交前，请先在 GitHub Issues 中搜索是否已有解决方案，并仔细阅读本页所有信息。