Плагин для серверов Майнкрафт Purpur и Paper, который создаёт собственный сервер аватаров Figura. Игроки видят аватары друг друга без облака Figura, авторизации Mojang и authlib-injector, поэтому решение подходит и для серверов без лицензионной авторизации.
Возможности
- Встроенный HTTP- и WebSocket-бэкенд на одном порту без отдельного процесса.
- Загрузка и скачивание аватаров, отображение присутствия игроков, передача пингов и событий перезагрузки.
- Аватары хранятся на диске и сохраняются после перезапуска сервера; часто используемые данные остаются в памяти.
- При входе игрок получает одноразовый токен, связанный с его UUID; авторизация проходит через канал
figura:auth. - Настраиваются лимит размера аватара,
MOTD, ограничения запросов, уровень журналирования иproxy-protocolдля HAProxy либо анти-DDoS-прокси. - WebSocket keepalive помогает не терять соединение из-за тайм-аутов NAT и прокси.
Команды
/figurabackend status— показать состояние плагина./figurabackend list— показать UUID игроков и число их аватаров./figurabackend clear <uuid>— удалить аватар указанного игрока./figurabackend reload— перезагрузить плагин.
Права
figurabackend.use— загрузка аватара.figurabackend.admin— доступ к команде/figurabackend.
Настройка
В plugins/FiguraBackend/config.yml укажите port, а bind-host оставьте равным 0.0.0.0. Этот отдельный от игрового порт должен быть доступен клиентам; в Custom Figura нужно указать адрес ваш-хост:порт.
Требования
Нужны Purpur или Paper, Java 21 и клиентский мод Custom Figura.
