NameMCAPI (Нейм МС АПИ)

Плагин для серверов Майнкрафт на Paper и Folia, который даёт другим плагинам доступ к публичным данным NameMC через сервис Bukkit. Запросы выполняются асинхронно, поэтому не блокируют основной поток сервера.

Возможности

• Получение списка друзей профиля по UUID.
• Проверка дружбы двух профилей.
• Получение числа отметок «нравится» у сервера и проверка, поставил ли её конкретный профиль.
• Необязательное кеширование ответов с ограниченным сроком хранения.
• Для запросов без кеша можно получать актуальные данные.

Поддерживаются обращения к данным друзей профиля и отметок серверов NameMC.

Настройка

В конфиге доступны параметры:

• namemc.base-url — адрес сервиса NameMC;
• namemc.http-timeout-ms — время ожидания HTTP-запроса в миллисекундах;
• namemc.cache-ttl-ms — срок хранения кеша в миллисекундах. Значение 0 отключает кеширование.

Обработчики результатов API работают вне основного потока. Если другой плагин меняет объекты Bukkit — игроков, миры или таблицы счёта, — это действие нужно вернуть в основной поток сервера.

Требования

Нужен сервер на Paper или Folia. Плагин предназначен для разработчиков других плагинов, использующих сервис NameMCAPIService.