PAPIProxyBridge - это плагин-библиотека, который решает давнюю проблему: как заставить PlaceholderAPI работать на прокси-серверах вроде BungeeCord или Velocity. Дело в том, что сам PAPI привязан к бэкенд-серверам (Spigot, Fabric), а на прокси его нет. Из-за этого плагины на прокси не могут использовать плейсхолдеры типа %player_name% или %some_plugin_some_value%. PAPIProxyBridge как раз и соединяет эти миры.

Для владельцев серверов

Это библиотечный плагин - сам по себе он ничего не делает, но без него не заработают плагины, которые используют его API. Настраивать в нём нечего.

Установка простая:

• Ставишь PAPIProxyBridge на бэкенд-сервер (Spigot 1.16.5+ или Fabric 1.19.3+) вместе с обычным PlaceholderAPI.
• Ставишь тот же PAPIProxyBridge на прокси (BungeeCord или Velocity).

Важный момент: это не замена PlaceholderAPI. PAPI всё ещё должен быть установлен на каждом бэкенд-сервере. PAPIProxyBridge просто передаёт запросы от прокси к бэкенду и обратно.

Для разработчиков

PAPIProxyBridge даёт кросс-платформенное API, чтобы форматировать текст с плейсхолдерами прямо на прокси. Это удобно, если ты пишешь, например, плагин для лобби, который показывает статистику игрока, или систему сообщений, работающую через прокси.

Подключение библиотеки

Репозиторий Maven:

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

Зависимость:

dependencies {
    implementation 'net.william278:papiproxybridge:1.6'
}

Пример использования

Основной класс - PlaceholderAPI. Получаешь его экземпляр через PlaceholderAPI.createInstance(), потом вызываешь #formatPlaceholders. Метод принимает строку с плейсхолдерами и UUID игрока (так проще для кросс-платформенности). Возвращает CompletableFuture, чтобы не блокировать потоки, пока прокси общается с бэкендом.

// Форматируем строку с плейсхолдерами
final PlaceholderAPI api = PlaceholderAPI.createInstance();
final UUID player = player.getUniqueId();
api.formatPlaceholders("Привет %player_name%!", player).thenAccept(formatted -> {
    player.sendMessage(formatted);
});

Никогда не вызывай #join() на этом CompletableFuture - это небезопасно, может повесить поток.

Есть ещё метод #formatComponentPlaceholders. Он возвращает adventure-компонент, который может содержать форматирование и чат-события. Удобно, если нужно не просто текст, а кликабельные сообщения.

Кеширование

PAPIProxyBridge кеширует выполненные запросы на 30 секунд (30000 мс). Это чтобы не гонять лишние пакеты по сети сервера. Если нужно, можно изменить время кеша через PlaceholderAPI#setCacheExpiry(long).

Итог

Если ты собираешь сервер с прокси и хочешь, чтобы плагины на нём нормально работали с PlaceholderAPI - PAPIProxyBridge это must-have. Без него многие вещи просто не будут работать, либо придётся костылить. А так - поставил и забыл, разработчики сами подключат API.

Скачать PAPIProxyBridge можно на GitHub, а если что-то непонятно - есть Discord-сообщество (но ссылки я тут не даю, сам найдёшь).