PAPIProxyBridge
Плагин библиотеки-моста для использования PlaceholderAPI на прокси-серверах.
39,55k
Быстрое задание
Как далеко вы сможете убежать, прежде чем вас поймают толпы?
Проверка Minecraft
Подтвердите свой запуск
Пройдите быструю проверку, чтобы получить свой код.
PAPIProxyBridge
GitHub — Discord PAPIProxyBridge — это плагин-мост для библиотеки, который устанавливается как на бэкэнд, так и на прокси-серверы и позволяет плагинам прокси форматировать текст с помощью заполнителей PlaceholderAPI.
Для владельцев серверов
Это плагин для библиотеки, предназначенный для использования с плагинами, реализующими его API. Ничего настраивать не нужно.
Установите последнюю версию плагина вместе с плагином PlaceholderAPI на вашем сервере Spigot (1.16.5+) или модом PlaceholderAPI на вашем сервере Fabric (1.19.3+), затем установите плагин на ваш прокси-сервер BungeeCord или Velocity.
Обратите внимание, что этот плагин не заменяет PlaceholderAPI. Вам по-прежнему необходимо установить PlaceholderAPI на вашем сервере Spigot/Fabric.
для разработчиков
PAPIProxyBridge предоставляет кроссплатформенный API, позволяющий форматировать текст с помощью заполнителей PlaceholderAPI.
Добавление библиотеки в ваш проект
PAPIProxyBridge доступен в `repo.william278.net` (документацию Javadoc можно посмотреть здесь). Сначала добавьте репозиторий Maven в ваш `build.gradle`: ```groovy repositories { maven { url 'https://repo.william278.net/releases/' } } ```
Затем добавьте зависимость: ```groovy dependencies { implementation 'net.william278:papiproxybridge:1.6' } ```
Пример использования
Класс `PlaceholderAPI` предоставляет API для форматирования заполнителей. В настоящее время поддерживаются только одиночные заполнители без скобок (в будущем будут поддерживаться и другие).
Получите экземпляр класса с помощью метода PlaceholderAPI.getInstance(), затем используйте метод `#formatPlaceholders` для форматирования строки с заполнителями для игрока (указанными с помощью UUID для простоты кроссплатформенной работы).
Метод возвращает объект CompletableFuture (поскольку мы не хотим блокировать потоки, пока прокси-сервер взаимодействует с игроками на бэкэнде), который можно использовать для приема отформатированной строки.
```java // Форматирование строки с заполнителями final PlaceholderAPI api = PlaceholderAPI.createInstance(); final UUID player = player.getUniqueId(); api.formatPlaceholders("Hello %player_name%!", player).thenAccept(formatted -> { player.sendMessage(formatted); }); ```
Никогда не вызывайте `#join()` при вызовах `#formatPlaceholders`; это небезопасно.
PAPIProxyBridge кэширует обработанные запросы в течение 30000 миллисекунд (30 секунд), чтобы избежать чрезмерной нагрузки на сетевые каналы вашего сервера. Вы можете настроить время кэширования запросов с помощью метода `PlaceholderAPI#setCacheExpiry(long)`.
Существует также метод `#formatComponentPlaceholders`. Этот метод позволяет передать строку, содержащую заполнители, и получить компонент приключения, содержащий отформатированный текст, который может содержать события форматирования и чата.
