|
|
用于在代理服务器上使用PlaceholderAPI的桥接库插件
GitHub
—
Discord
PAPIProxyBridge是一个库桥接插件，你需要在后端和代理服务器上安装它，以便代理插件可以使用PlaceholderAPI占位符来格式化文本。
##对于服务器所有者
这是一个库插件，旨在与实现其API的插件一起使用。无需进行任何配置。
在你的Spigot（1.16.5+）服务器上，将最新版本的插件与[PlaceholderAPI插件](https://www.spigotmc.org/resources/placeholderapi.6245/)一起安装，或者在你的Fabric（1.19.3+）服务器上安装[PlaceholderAPI模组](https://placeholders.pb4.eu/)，然后在你的BungeeCord或Velocity代理服务器上安装该插件。
请注意，此插件不是PlaceholderAPI的替代品。你仍然需要在你的Spigot/Fabric服务器上安装PlaceholderAPI。
##对于开发者
PAPIProxyBridge公开了一个跨平台API，让你可以使用PlaceholderAPI占位符来格式化文本。
将库添加到你的项目中
PAPIProxyBridge可在`repo.william278.net`上获取（[在此查看Java文档](https://repo.william278.net/javadoc/releases/net/william278/papiproxybridge/latest)）。首先，将Maven存储库添加到你的`build.gradle`中：
```groovy
repositories{
maven{url\'https://repo.william278.net/releases/\'}
}
```
然后添加依赖项：
```groovy
dependencies{
implementation\'net.william278:papiproxybridge:1.6\'
}
```
示例用法
`PlaceholderAPI`类公开了用于格式化占位符的API。目前，仅支持单例非括号占位符（未来会有更多）。
使用PlaceholderAPI.getInstance()获取该类的实例，然后使用`#formatPlaceholders`方法在玩家（使用UUID指定以实现跨平台简单性）上格式化包含占位符的字符串。
该方法返回一个[CompletableFuture](https://www.baeldung.com/java-completablefuture)（因为我们不希望在代理与后端的玩家进行网络连接时锁定线程），你可以使用它来接受格式化后的字符串。
```java
//使用占位符格式化字符串
finalPlaceholderAPIapi=PlaceholderAPI.createInstance();
finalUUIDplayer=player.getUniqueId();
api.formatPlaceholders(\"Hello%player_name%!\",player).thenAccept(formatted->{
player.sendMessage(formatted);
});
```
切勿在对`#formatPlaceholders`的调用上调用`#join()`；这是不安全的。
PAPIProxyBridge将已解析的请求缓存30000毫秒（30秒），以避免在服务器的网络通道上导致过多的流量。你可以使用`PlaceholderAPI#setCacheExpiry(long)`方法调整缓存请求的时间长度。
还存在`#formatComponentPlaceholders`。此方法允许你提供包含占位符的字符串，并接收包含格式化文本的冒险组件，该文本可能包含格式和聊天事件。
===下载地址===
所有版本下载地址已整理至网盘，请下载对应文件：
文件名：downloads/PAPIProxyBridge.txt |
楼主
2025-7-25 18:47:46
回复(0)
收起回复
|
|Archiver|手机版|小黑屋|Minecraft(我的世界)小僵尸论坛
|网站地图
经验
金粒
绿宝石
爱心
发表于 2025-7-25 18:47:46
提升卡
置顶卡
喧嚣卡
变色卡
千斤顶
