PAPIProxyBridge

插件

· 作者 WiIIiam278

一个用于在代理服务器上配合 PlaceholderAPI 使用的桥接库插件

0 本站下载 0 关注 更新于 2 个月前

最新 1.8.4-1959e64 · 1.21.8 · Velocity

一键开服(送7天)
GitHub — Discord
​

PAPIProxyBridge 是一个库桥接插件,你需要将其安装在后端和代理服务器上,它允许代理插件使用 PlaceholderAPI 占位符来格式化文本。

面向服务器所有者

这是一个库插件,旨在与实现了其 API 的插件配合使用。无需进行任何配置。

在你的 Spigot (1.16.5+) 或 Fabric (1.19.3+) 服务器上安装该插件的最新版本以及 PlaceholderAPI 插件(在 Fabric 上为 PlaceholderAPI 模组),然后在你的 BungeeCord 或 Velocity 代理服务器上安装此插件。

请注意,本插件不能替代 PlaceholderAPI。你仍然需要在 Spigot/Fabric 服务器上安装 PlaceholderAPI。

面向开发者

PAPIProxyBridge 提供了一个跨平台的 API,让你能够使用 PlaceholderAPI 占位符来格式化文本。

将库添加到你的项目中

PAPIProxyBridge 可在 repo.william278.net 上获取(在此查看 javadocs)。首先,将 maven 仓库添加到你的 build.gradle 中:

repositories {
    maven { url 'https://repo.william278.net/releases/' }
}

然后添加依赖项:

dependencies {
    implementation 'net.william278:papiproxybridge:1.6'
}
用法示例

PlaceholderAPI 类暴露了用于格式化占位符的 API。目前,仅支持单例非括号占位符(未来将支持更多)。

通过 PlaceholderAPI.getInstance() 获取该类的一个实例,然后使用 #formatPlaceholders 方法为玩家(为跨平台简洁性而指定 UUID)格式化带有占位符的字符串。

该方法返回一个 CompletableFuture(因为我们不希望在前端网络与后端玩家通信时阻塞线程),你可以用它来获取格式化后的字符串。

// 使用占位符格式化字符串
final PlaceholderAPI api = PlaceholderAPI.createInstance();
final UUID player = player.getUniqueId();
api.formatPlaceholders("Hello %player_name%!", player).thenAccept(formatted -> {
    player.sendMessage(formatted);
});

切勿对 #formatPlaceholders 的调用使用 #join();这是不安全的。

PAPIProxyBridge 会缓存已解析的请求 30000 毫秒(30 秒),以避免在服务器的网络通道上产生过多的流量。你可以使用 PlaceholderAPI#setCacheExpiry(long) 方法来调整请求的缓存时间。

此外还存在 #formatComponentPlaceholders 方法。该方法允许你提供一个包含占位符的字符串,并接收一个包含格式化文本的 adventure component,其中可能包含格式化和聊天事件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源