PAPIProxyBridge — плагин для Minecraft

PAPIProxyBridge — это библиотечный плагин для серверов, предназначенный для интеграции PlaceholderAPI с прокси-серверами BungeeCord и Velocity. Он позволяет прокси-плагинам использовать placeholders из PlaceholderAPI для форматирования текста, например, в сообщениях, титулах, в чатах и других системах, где нужна динамическая подстановка данных игроков. Плагин работает совместно с PlaceholderAPI на бэкенд-серверах (Spigot 1.16.5+ или Fabric 1.19.3+) и должен быть установлен одновременно на прокси и на каждом бэкенд-сервере.

Для администраторов сервера установка проста: нужно разместить файл плагина в папку plugins на всех серверах — и на прокси, и на бэкендах. После перезапуска серверов плагин начинает работать без дополнительной настройки. Клиенту ничего устанавливать не нужно — всё происходит на стороне сервера. Этот плагин не заменяет PlaceholderAPI, его нужно ставить отдельно на Spigot или Fabric, а PAPIProxyBridge лишь обеспечивает мост между прокси и бэкендами для передачи и обработки placeholder-данных.

Для разработчиков плагин предоставляет API для форматирования текста с использованием placeholders через CompletableFuture. Используя метод formatPlaceholders с UUID игрока, можно получить отформатированную строку, не блокируя потоки. Поддерживаются только неразделённые (singleton) placeholders без квадратных скобок. Плагин доступен в репозитории repo.william278.net и интегрируется в проекты через Gradle.

Частые вопросы

На каких версиях игры работает?

Работает на 1.16.5, 1.17.1, 1.18.2, 1.19.4 и 1.20.1.

Какие серверные платформы поддерживаются?

BungeeCord, Velocity, Spigot (1.16.5+), Fabric (1.19.3+).

Что нужно поставить, кроме этого плагина?

На бэкенд-серверах обязательно нужен PlaceholderAPI (плагин или мод).