PAPIProxyBridge

Мод PAPIProxyBridge для Minecraft — мост для интеграции PlaceholderAPI на прокси

PAPIProxyBridge — это библиотека-мост для серверов с прокси (BungeeCord, Velocity), которая позволяет плагинам прокси использовать заглушки PlaceholderAPI без необходимости устанавливать саму библиотеку на бэкенд-серверы. Мод работает в связке с PlaceholderAPI на бэкенде и предоставляет API для форматирования текста с переменными.

Как работает библиотека

PAPIProxyBridge устанавливается на оба типа серверов: на бэкенд (Spigot, Fabric и др.) и на сервер прокси (BungeeCord, Velocity). На бэкенде должен быть установлен соответствующий плагин PlaceholderAPI. Библиотека не заменяет его, а лишь обеспечивает передачу данных о заглушках через сеть прокси. Это позволяет плагинам на прокси-уровне отображать динамическую информацию (например, никнеймы, баланс, статусы) без сложной архитектуры бэкенда.

Интеграция в проекты

Для разработчиков, желающих использовать библиотеку в своих проектах, доступна версия для Maven-репозитория. Добавление в build.gradle требует указания репозитория repo.william278.net и зависимости net.william278:papiproxybridge. Библиотека предоставляет класс PlaceholderAPI с методом formatPlaceholders, который принимает строку с заглушками и UUID игрока. Результат возвращается через CompletableFuture, что позволяет избежать блокировки потоков при сетевых запросах к бэкенду. В API также есть метод formatComponentPlaceholders для получения Adventure-компонентов с форматированием.

Настройки кэширования

Для оптимизации сетевой нагрузки библиотека кэширует результаты запросов к бэкенду в течение 30 секунд. Если требуется изменить этот период, можно использовать метод setCacheExpiry с параметром в миллисекундах. Важно не вызывать метод join() на возвращаемых задачах, так как это может привести к блокировке потоков и нестабильной работе сервера.

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

Для форматирования сообщения с никнеймом игрока используется следующий код: создается экземпляр API через PlaceholderAPI.createInstance(), затем вызывается метод formatPlaceholders с целевой строкой и UUID игрока. Результат передается в thenAccept, который отправляет отформатированное сообщение игроку. Пример: api.formatPlaceholders("Привет, %player_name%!", player).thenAccept(formatted -> { player.sendMessage(formatted); });