PlaceholderAPI

[HEADING=2]✪ 快速上手（Getting Started）[/HEADING]
[B]PlaceholderAPI[/B] 是一款为 Spigot 服务器设计的插件，用于统一格式显示来自不同插件的信息。它支持超过 230 个插件的占位符（如 Essentials、Factions、LuckPerms、Vault 等），是构建高级服务器不可或缺的核心工具。
[B]安装步骤：[/B]
[LIST=1]
[*]下载最新版 PlaceholderAPI 插件（支持 Minecraft 版本 1.8 至 1.21）。
[*]将插件放入服务器的 plugins 文件夹中并重启服务器。
[*]使用 /papi ecloud 命令下载你需要的插件扩展（如 Essentials、Vault 等）。
[*]在插件或服务器配置中使用占位符（如 %player_name%）即可显示动态信息。
[/LIST]
[B]快速命令：[/B]
[LIST]
[*]/papi parse me %player_name% —— 测试占位符是否生效。
[*]/papi ecloud list all —— 查看所有可用扩展。
[*]/papi reload —— 重载插件配置。
[/LIST]
[HR][/HR]
[HEADING=2]✪ 指令与权限（Commands & Permissions）[/HEADING]
PlaceholderAPI 提供丰富的命令和权限节点，便于管理员控制插件的使用和扩展管理。
[HEADING=3]🔧 常用指令：

[TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]
[TH][LEFT]说明[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/papi parse <player> <text>[/LEFT][/TD]
[TD][LEFT]解析文本中的占位符[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/papi list[/LEFT][/TD]
[TD][LEFT]列出已注册的扩展[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/papi ecloud download <expansion>[/LEFT][/TD]
[TD][LEFT]从云端下载扩展[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/papi reload[/LEFT][/TD]
[TD][LEFT]重载配置和扩展[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/papi unregister <jar>[/LEFT][/TD]
[TD][LEFT]卸载扩展[/LEFT][/TD]
[/TR]
[/TABLE][/HEADING]
[HEADING=3]🔐 权限节点（默认仅 OP 拥有）：

[TABLE]
[TR]
[TH][LEFT]权限[/LEFT][/TH]
[TH][LEFT]说明[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]placeholderapi.parse[/LEFT][/TD]
[TD][LEFT]使用 /papi parse 命令[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]placeholderapi.reload[/LEFT][/TD]
[TD][LEFT]使用 /papi reload 命令[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]placeholderapi.ecloud.download[/LEFT][/TD]
[TD][LEFT]下载扩展[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]placeholderapi.list[/LEFT][/TD]
[TD][LEFT]查看已注册扩展[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]placeholderapi.admin[/LEFT][/TD]
[TD][LEFT]包含大部分管理权限[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]placeholderapi.*[/LEFT][/TD]
[TD][LEFT]所有权限（包括管理 + 云端）[/LEFT][/TD]
[/TR]
[/TABLE][/HEADING]
[QUOTE]
提示：你可以通过权限插件（如 LuckPerms）将这些权限分配给特定玩家或组。
[/QUOTE]
[HR][/HR]
[HEADING=2]✪ 开发教程（Developer Guide）[/HEADING]
如果你是插件开发者，并希望让你的插件支持 PlaceholderAPI，可以通过以下方式集成：
[HEADING=3]1. 添加依赖（Maven 示例）：
[/HEADING]
[CODE]<repository>
<id>placeholderapi</id>
<url>https://repo.extendedclip.com/content/repositories/placeholderapi/</url>
</repository>

<dependency>
<groupId>me.clip</groupId>
<artifactId>placeholderapi</artifactId>
<version>2.11.4</version>
<scope>provided</scope>
</dependency>[/CODE]

[HEADING=3]2. 创建扩展类（Expansion）：
[/HEADING]
[CODE]public class MyExpansion extends PlaceholderExpansion {

@Override
public String getIdentifier() {
return "myplugin";
}

@Override
public String getAuthor() {
return "YourName";
}

@Override
public String getVersion() {
return "1.0.0";
}

@Override
public String onPlaceholderRequest(Player player, String identifier) {
if (identifier.equals("kills")) {
return String.valueOf(player.getStatistic(Statistic.PLAYER_KILLS));
}
return null;
}
}[/CODE]

[HEADING=3]3. 注册扩展：[/HEADING]
在你的主类中注册扩展：
[CODE]new MyExpansion().register();[/CODE]



[HEADING=3]4. 测试占位符：[/HEADING]
使用命令 /papi parse me %myplugin_kills% 查看效果。