开源 前置/API PlaceholderAPI —— 应用广泛的变量前置插件 [1.8-1.21] 2.12.2

这个更新介绍对 Adventure 组件的支持！
也包括了一些安全更新，新的 eCloud 地址，和其它提高质量的更新。

组件支持 [#1157]​

PlaceholderAPI 现在可以解析 Kyori Adventure 组件 中的变量。
默认实现使用自定义构建的递归替换器，会扫描组件中的组件树，包括所有样式（悬停/点击事件），甚至是 NBT/数据 组件。如果你有任何有关替换的问题，你可以在配置文件中修改选项 use_adventure_provided_replacer 以使用 adventure 内置的替换器。

一个叫 PAPIComponents 的新类添加到 API。提前警告，如果你尝试在 Spigot 服务器上使用这个类，插件会在调用时报错，这个类应当仅能在 Paper 或其衍生服务端上使用。

安全更新​

变量扩展 jar 哈希检查​

PlaceholderAPI 现在会在启动或重载时，检查下载的变量扩展的哈希值，以避免出现已知的被感染变量扩展。如果有误，服务器将会强制停止并在控制台输出感染的 jar。

每个版本验证​

eCloud 作为大修的一部分接受了每个版本的扩展验证，PlaceholderAPI 也进行了更新以支持这一更改。
从现在开始，扩展版本将单独进行验证，就像之前经过验证的扩展一样，PlaceholderAPI 只允许通过 /papi ecloud 命令下载经过验证的版本。

服务商需要注意​

我们已经开始将 api.extendedclip.com 域名迁移到 *.placeholderapi.com 了。如果用户遇到了任何关于连接错误的问题，你们需要更新出站白名单。

新的 eCloud 地址为 https://ecloud.placeholderapi.com

要注意，从这个版本开始，PlaceholderAPI 会开始使用新的域名。

被阻止访问的 eCloud​

我们注意到，由于防火墙、服务器主机、ISP或国家施加的审查限制，越来越多的用户与 eCloud 的连接出现问题。我们在游戏和控制台中添加了一些更有用的错误消息，以帮助用户找到使用 eCloud 的替代方法。

漏洞修复 / 次要变更​

• 更改更新器 URL 以使用 PAPI 的主要分发平台
• 对所有的命令补全检查权限
• 鼠标悬停在 /papi ecloud list 的扩展上时显示扩展版本

Hytale​

PlaceholderAPI 现在也在 Hytale 上可用！如果你正在运营一个 Hytale 服务器，或正在开发模组，详见 https://placeholderapi.com/download 或我们的 wiki 以获取更多详情。

完整更新日志：https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.11.7...2.12.2

2.11.7​

在漫长的等待以及无数的请求之后，包括多个 PR 去实现 —— PlaceholderAPI 终于能够支持 Folia 服务端了！
另外，还有一些小的代码优化，包括更新 NMSVersion 枚举，使其包含最新的 1.21.x 版本。

Folia 支持 [#1127]​

已添加 Folia 服务端支持，允许 PlaceholderAPI 运行在基于 Folia 的服务器上，解决了调度器相关问题。我们已经测试了核心功能，目前还没有办法验证每一个扩展是否能用，所以一些边缘情况导致的问题可能依然存在。如果你发现了任何漏洞，请向我们报告，以便我们能够调查并解决它们。

NMSVersion 更新​

枚举 NMSVersion 已更新到支持最新 1.21.x 的版本，包括 1.21.10 版本也能跑依赖了这个类的扩展了。

完整更新日志​

请查阅原文。

2.11.6

该更新支持了 1.20.6，但是也有一些开发者需要关心的重要变更，特别是弃用的部分。

弃用 Version 类 [#1035]
PlaceholderAPI 中的 Version 类已弃用
最主要的一个原因是，有其它更多的方法可以获取当前服务器版本，以保证服务器和扩展兼容。

虽然这个类依然可以正常用，但是 PlaceholderAPI 获取服务器版本的方式已改变（为了兼容 1.20.6），所以二者显示上会有一些微小的差异。

如果你有使用这个类，请尽快寻找其它方法，因为我们不能保证这个类在以后还能正常使用。

解析命令改进

修复了 cmdparse 命令的提示信息 “You must provide a target and message” 显示命令有误的问题。在两个参数都是 me 时也一样。

新 Wiki

以免你没看到，PlaceholderAPI wiki 已经移到新的地方了。

虽然在 Github 上的旧 wiki 能为非中国大陆地区的我们提供了很好的服务，但它缺乏个性化设置和自定义功能。新的 wiki 能帮助我们更自由地展示内容。

新 Wiki 地址：https://wiki.placeholderapi.com/

你一样可以通过 Pull Request 向我们的 wiki 分支 做出贡献！

其它更改内容

• 将 Hangar 和 BuiltByBit 页面添加到 README
• 更新配置文件里面的 wiki、eCloud 链接域名
• 使用 OfflinePlayer#getPlayer 方法获取玩家实例，而不是强制转换为 Player
• 在 /papi dump 添加插件作者信息

提交者、PR链接、新的贡献者什么的懒得打了，想看去原文看。