PAPIProxyBridge

GitHub — Discord

​

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

对于服务器所有者

这是一个供实现其 API 的插件使用的库插件，无需进行任何配置。

在您的 Spigot (1.16.5+) 服务器上安装最新版本的插件以及 PlaceholderAPI 插件，或在您的 Fabric (1.19.3+) 服务器上安装 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 组件，该组件可能包含格式和聊天事件。