PlaceholderAPI - 变量占位符插件

PlaceholderAPI 是一款 Spigot 服务器插件，它允许服主以统一的格式展示来自各种插件的信息。对特定插件的支持由插件自身或通过扩展提供，扩展可以在游戏内通过 PAPI 扩展云下载。目前已有超过 230 个扩展，支持诸如 Essentials、Factions、LuckPerms 和 Vault 等众多插件，使其成为各类服务器的必备工具。

💡核心特性

• 统一格式：为来自不同插件的信息提供一致的显示格式。
• 扩展生态：通过“扩展”系统支持海量插件，扩展数量超过 230 个。
• 便捷管理：支持在游戏内通过命令直接下载和管理扩展。
• 开发者友好：提供完善的 API，方便开发者为其插件添加 PlaceholderAPI 支持。
• 广泛使用：累计下载超过 1,500,000 次，同时有超过 45,000 台服务器在线使用。

🎮配置文件 (config.yml)

配置文件 config.yml 包含核心插件设置，以及为扩展提供的可配置选项区。任何扩展允许修改的设置都会在其加载时添加到配置文件中。

主要配置项示例

check_updates: true
cloud_enabled: true
cloud_allow_unverified_expansions: false
date_format: MM/dd/yy HH:mm:ss
debug: false

🔧权限节点

PlaceholderAPI 使用详细的权限系统来管理命令访问。

主要权限组

• placeholderapi.*：允许使用所有 PAPI 命令。
• placeholderapi.admin：允许使用所有核心管理命令。
• placeholderapi.ecloud.*：允许使用所有扩展云相关命令。

具体命令权限

所有命令权限默认对 OP 玩家开放 (default: op)，例如：

• placeholderapi.help：查看命令列表。
• placeholderapi.reload：重载插件及配置。
• placeholderapi.ecloud.download：从扩展云下载扩展。
• placeholderapi.ecloud.update：更新已安装的扩展。

🔧命令列表

解析命令

用于解析和测试占位符。

• /papi parse
• /papi bcparse
• /papi cmdparse
• /papi parserel

扩展云命令 (eCloud)

用于管理在线扩展库。

• /papi ecloud download [version]
• /papi ecloud update
• /papi ecloud list |installed> [page]
• /papi ecloud info [version]
• /papi ecloud placeholders
• /papi ecloud refresh / /papi ecloud clear / /papi ecloud status

扩展管理命令

用于管理本地已安装的扩展。

• /papi info ：查看扩展信息。
• /papi list：列出所有已激活的扩展。
• /papi register ：注册一个扩展。
• /papi unregister ：取消注册一个扩展。

工具命令

• /papi reload：重载插件。
• /papi version：查看插件版本。
• /papi dump：导出调试信息。

✨链接与统计

• 使用 PAPI 的插件列表：可在 Wiki 查看。
• 开发者 API 使用指南：请访问 API Usage 页面。
• 占位符列表：可在 Wiki 查询。
• 官方 Wiki：https://wiki.placeholderapi.com/
• 问题反馈：https://github.com/PlaceholderAPI/PlaceholderAPI/issues
• Discord 社区：https://helpch.at/discord

本插件使用 bStats 收集匿名统计信息以帮助改进：https://bstats.org/plugin/bukkit/PlaceholderAPI

如果您喜欢这个完全免费且功能强大的资源，请不吝点赞和评论！