PAPIProxyBridge

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 (поскольку мы не хотим блокировать потоки, пока прокси обменивается данными с игроками на backend), который вы можете использовать, чтобы принять отформатированную строку.

// Форматирование строки с плейсхолдерами
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. Этот метод позволяет передать строку, содержащую плейсхолдеры, и получить adventure-компонент с отформатированным текстом, который может содержать форматирование и события чата.