PlaceholderAPI丨占位符

YanSeng

介绍：

PlaceholderAPI 是一款专为 Spigot 系列服务端设计的核心插件。它的强大之处在于能够统一调用并格式化显示来自不同插件的数据。

插件支持与扩展

PlaceholderAPI 的功能支持主要通过两种方式实现：

• 原生支持：部分插件在自身设计中就已内置了对 PlaceholderAPI 的完整支持。
• 扩展包：对于绝大多数插件，其功能支持是通过下载专用的 “扩展包” 来实现。
  
  

获取扩展

获取扩展非常简单，您可以直接在游戏内使用指令 /papi ecloud download <扩展名> 从 PAPI 扩展云 快速下载和安装。目前，扩展云中提供了 超过 230 款 扩展包，支持海量主流插件，例如：

• Essentials
• Factions
• LuckPerms
• Vault
  
  

这意味着，无论您的服务器安装了哪种类型的插件，几乎都能找到对应的扩展，从而将其数据完美地集成到您的服务器界面中。

版本一：正式宣传版

此版本用词专业、结构严谨，通过数据有力地论证了其“必备”地位，适合用于官方文档或资源介绍。

PlaceholderAPI 的全球下载量已 突破150万次，并同时在 超过45,000台服务器 上稳定运行。如此广泛的应用与验证，使其成为无论何种类型或规模的服务器都不可或缺的核心插件。

以下是配置文件

config.yml 配置文件说明

config.yml 是插件的主要配置文件，包含两项核心内容：

• 插件核心自定义设置：所有关系到插件基础功能与行为的可调整选项均在于此。
• 扩展专属配置区：为那些需要提供可配置项的 扩展 预留的专用章节。
  
  

当您安装并加载了某个特定的扩展后，该扩展所允许您修改的任何设置，都会自动添加到 config.yml 文件的相应位置中

config.ymlp配置如下

# PlaceholderAPI 主配置文件
# 版本: 2.11.4
# 作者: extended_clip
# 贡献者: https://github.com/PlaceholderAPI/PlaceholderAPI/graphs/contributors (连接至项目贡献者名单)
# 问题反馈: https://github.com/PlaceholderAPI/PlaceholderAPI/issues (连接至问题追踪页面)
# 扩展列表: https://api.extendedclip.com/all/ (查看所有可用扩展)
# 官方Wiki: https://wiki.placeholderapi.com/ (连接至详细使用文档)
# Discord社区: https://helpch.at/discord (连接至官方交流群组)
# 重要提示：此插件默认不提供任何占位符。
# 下载占位符扩展请使用游戏内指令: /papi ecloud

# 是否在启动时检查插件更新
check_updates: true

# 是否启用扩展云服务。禁用后将无法从云端下载或更新扩展
cloud_enabled: true

# 扩展云列表的排序方式。可选值："name"（按名称）, "last_update"（按最后更新）, "author"（按作者）
cloud_sorting: "name"

# 是否允许安装未经验证的扩展。建议保持 false 以确保扩展来源的安全性与稳定性
cloud_allow_unverified_expansions: false

# 布尔值显示格式。此处定义当占位符返回 true 或 false 时，向玩家显示的内容
boolean:
  'true': 'yes'   # 当值为 true 时显示为 'yes'
  'false': 'no'   # 当值为 false 时显示为 'no'

# 日期与时间的显示格式。当占位符返回时间戳时，将按此格式显示
date_format: MM/dd/yy HH:mm:ss

# 是否启用调试模式。启用后将在控制台输出详细日志，用于排查问题，正常运行时建议关闭
debug: false

# ======================
# PlaceholderAPI 权限节点配置
# ======================

permissions:
  # 超级权限节点 - 拥有此权限等同于拥有所有 PAPI 相关权限
  placeholderapi.*:
    description: "通用于所有 PAPI 指令的权限"
    children:
      placeholderapi.admin: true        # 继承所有管理员指令权限
      placeholderapi.ecloud.*: true     # 继承所有扩展云指令权限

  # 管理员指令组 - 包含所有核心管理指令
  placeholderapi.admin:
    description: "通用于所有 PAPI 指令的权限"
    children:
      placeholderapi.help: true         # 允许查看指令帮助列表
      placeholderapi.info: true         # 允许查看扩展信息
      placeholderapi.list: true         # 允许列出已激活的扩展
      placeholderapi.parse: true        # 允许解析占位符
      placeholderapi.reload: true       # 允许重载 PAPI 及其配置
      placeholderapi.version: true      # 允许查看已安装的 PAPI 版本
      placeholderapi.register: true     # 允许注册扩展
      placeholderapi.unregister: true   # 允许注销扩展
      placeholderapi.updatenotify: true # 当有 PAPI 更新时接收通知

  # 扩展云指令组 - 包含所有扩展云相关指令
  placeholderapi.ecloud.*:
    description: "通用于所有 PAPI 扩展云指令的权限"
    children:
      placeholderapi.ecloud: true                 # 允许访问扩展云主指令
      placeholderapi.ecloud.info: true            # 允许查看云端扩展信息
      placeholderapi.ecloud.list: true            # 允许列出云端扩展
      placeholderapi.ecloud.clear: true           # 允许清空本地扩展缓存
      placeholderapi.ecloud.status: true          # 允许查看云端扩展状态
      placeholderapi.ecloud.update: true          # 允许更新已注册的云端扩展
      placeholderapi.ecloud.refresh: true         # 允许刷新本地扩展缓存
      placeholderapi.ecloud.download: true        # 允许从云端下载扩展
      placeholderapi.ecloud.placeholders: true    # 允许查看云端扩展的占位符列表

  # ======================
  # 以下是具体的独立权限节点
  # 默认权限均为 OP (操作员)
  # ======================

  # 基础指令权限
  placeholderapi.help:
    default: "op"
    description: "允许您查看 PAPI 指令列表"
  placeholderapi.info:
    default: "op"
    description: "允许您查看扩展的详细信息"
  placeholderapi.list:
    default: "op"
    description: "允许您列出所有已激活的扩展"

  # 扩展云基础权限
  placeholderapi.ecloud:
    default: "op"
    description: "允许您访问 PAPI 扩展云系统"

  # 核心功能权限
  placeholderapi.parse:
    default: "op"
    description: "允许您解析特定占位符以查看其输出结果"
  placeholderapi.reload:
    default: "op"
    description: "允许您重载 PAPI 及其配置文件"
  placeholderapi.version:
    default: "op"
    description: "允许您查看已安装的 PAPI 版本号"

  # 扩展管理权限
  placeholderapi.register:
    default: "op"
    description: "允许您手动注册一个扩展"
  placeholderapi.unregister:
    default: "op"
    description: "允许您手动注销一个扩展"
  placeholderapi.updatenotify:
    default: "op"
    description: "当有可用的 PAPI 更新时通知您"

  # 扩展云详细操作权限
  placeholderapi.ecloud.info:
    default: "op"
    description: "允许您查看云端扩展的详细信息"
  placeholderapi.ecloud.list:
    default: "op"
    description: "允许您列出扩展云中的所有可用扩展"
  placeholderapi.ecloud.clear:
    default: "op"
    description: "允许您清空本地的扩展云缓存"
  placeholderapi.ecloud.status:
    default: "op"
    description: "允许您查看扩展云中各个扩展的状态（如已安装、可更新等）"
  placeholderapi.ecloud.update:
    default: "op"
    description: "允许您更新所有已注册且可用的云端扩展"
  placeholderapi.ecloud.refresh:
    default: "op"
    description: "允许您刷新本地的扩展云缓存，以获取最新扩展列表"
  placeholderapi.ecloud.download:
    default: "op"
    description: "允许您从扩展云下载指定的扩展"
  placeholderapi.ecloud.placeholders:
    default: "op"
    description: "允许您查看某个云端扩展所提供的所有占位符列表"

解析指令

这些指令用于直接解析和测试占位符。

指令格式	说明
/papi bcparse <玩家/--null/me> <文本	广播解析 - 解析文本中的占位符并将结果广播给全服玩家。
/papi cmdparse <玩家/me> <文本>	命令解析 - 解析文本中的占位符并将结果作为控制台命令执行
/papi parse <玩家/--null/me> <文本>	普通解析 - 解析文本中的占位符并将结果显示给你自己（在聊天栏或控制台）。
/papi parserel <玩家> <玩家> <文本>	关系解析 - 解析文本中的占位符，其中第一个玩家是"来源"，第二个玩家是"目标"（用于解析如 %player_distance% 这类需要两个上下文的占位符）。

扩展云指令
这些指令用于从 PAPI 的官方扩展云 (eCloud) 搜索、下载和管理扩展。

指令        说明
/papi ecloud status        状态检查 - 查看已安装扩展的更新状态。
/papi ecloud clear        清理缓存 - 清除本地扩展云的缓存数据。
/papi ecloud download <扩展名> [版本]        下载扩展 - 从云端下载指定扩展，可指定版本（不填则下载最新版）。
/papi ecloud update <扩展名/all>        更新扩展 - 更新指定扩展或使用 all 更新所有已安装扩展。
/papi ecloud info <扩展名> [版本]        扩展信息 - 查看云端上某个扩展的详细信息。
/papi ecloud list <all|<作者>|installed> [页码]        列表查询 - 列出所有/指定作者/已安装的扩展。
/papi ecloud placeholders <扩展名>        占位符列表 - 查看某个扩展提供的所有占位符列表。
/papi ecloud refresh        刷新列表 - 从云端获取最新的扩展列表，刷新本地缓存。
扩展管理指令
这些指令用于管理服务器上已安装的扩展。

指令        说明
/papi info <扩展名>        扩展详情 - 查看某个已安装扩展的详细信息。
/papi list        本地列表 - 列出服务器上所有已激活的扩展。
/papi register <Jar文件>        注册扩展 - 手动注册一个放在 plugins/PlaceholderAPI/expansions 文件夹下的 Jar 文件扩展。
/papi unregister <Jar文件>        注销扩展 - 从 PAPI 中注销一个扩展。
工具指令
这些是其他实用工具指令。

指令        说明
/papi dump        信息转储 - 生成一份详细的诊断报告（包括版本、扩展列表等），用于故障排查。
/papi reload        重载配置 - 重载 PlaceholderAPI 的配置文件。
/papi version        版本信息 - 检查已安装的 PlaceholderAPI 版本。

支持原作者
我提供了最新的下载地址，给不方便的人
[url=]PlaceholderAPI-2.11.6.jar[/url]


来自圈子: 严氏易