FiguraBackend

A self-hosted Figura avatar backend for Purpur / Paper servers. Lets your players see each other's Figura avatars without the Figura cloud, Mojang authentication, or authlib-injector - perfect for offline-mode servers.

The server itself is the source of avatars: when a player joins, the plugin issues a one-time token bound to their UUID and hands it to the client over a trusted in-game channel. The Figura client authenticates with that token - no external services, no UUID drift.

Requires the companion client mod: Custom Figura.

Features

HTTP + WebSocket backend on a single port (embedded, no extra process).
Avatar upload / download, presence, ping forwarding and reload events between players.
On-disk avatar storage that survives restarts; in-memory cache.
In-game session auth via plugin-messaging (figura:auth) - never contacts Mojang.
Configurable size limit, MOTD, rates, log level.
proxy-protocol option for hosts that put the port behind a HAProxy/anti-DDoS proxy.
WebSocket keepalive so connections survive NAT / anti-DDoS idle timeouts.
Admin command: /figurabackend <status|list|clear <uuid>|reload>.

Permissions

figurabackend.use - upload figura in cloud
figurabackend.admin - access for /figurabackend

Commands

/figurabackend status - show plugin status
/figurabackend list - show players uuid's and avatars count
/figurabackend clear <uuid> - clear player's avatar from cloud
/figurabackend reload - reload plugin

Requirements

Purpur / Paper 1.21.1, Java 21
A backend port (separate from the Minecraft port) reachable by clients

Setup

Drop the jar into plugins/, start the server, then edit plugins/FiguraBackend/config.yml (set port; keep bind-host: 0.0.0.0).
Open that port at your host.
Use Custom Figura client mod and set its backend address to your-host:port.

RU:

Свой бэкенд аватаров Figura для серверов Purpur / Paper. Позволяет игрокам видеть аватары Figura друг друга без облака Figura, без авторизации Mojang и без authlib-injector - идеально для offline-mode серверов.

Хранилище аватаров - сам сервер: при заходе игрока плагин выдаёт одноразовый токен, привязанный к его UUID, и отправляет клиенту по доверенному игровому каналу. Клиент Figura авторизуется этим токеном - никаких внешних сервисов и рассинхрона UUID.

Требуется клиентский мод-компаньон: Custom Figura.

Возможности

HTTP + WebSocket бэкенд на одном порту (встроенный, без отдельного процесса).
Загрузка / скачивание аватаров, презенс, форвардинг пингов и события перезагрузки между игроками.
Хранение аватаров на диске - переживает рестарты; in-memory кэш.
Авторизация по игровой сессии через plugin-messaging (figura:auth) - сервер авторизации Mojang не используется.
Настраиваемые лимит размера, MOTD, рейты, уровень логов.
Опция proxy-protocol для хостингов, где порт идёт через HAProxy/анти-DDoS прокси.
WebSocket keepalive - соединения переживают idle-таймауты NAT / анти-DDoS.
Админ-команда: /figurabackend <status|list|clear <uuid>|reload>.

Права

figurabackend.use - загрузить фигуру в облако
figurabackend.admin - доступ к /figurabackend

Команды

/figurabackend status - посмотреть статус плагина
/figurabackend list - показать uuid игроков и количество их аватаров
/figurabackend clear <uuid> - удалить аватар игрока из облака
/figurabackend reload - перезагрузить плагин

Требования

Purpur / Paper 1.21.1, Java 21
Отдельный порт под бэкенд (не порт Minecraft), доступный клиентам

Установка

Положи jar в plugins/, запусти сервер, отредактируй plugins/FiguraBackend/config.yml (укажи port; bind-host оставь 0.0.0.0).
Открой этот порт у хостинга.
Используй клиентский мод Custom Figura и укажи в нём адрес бэкенда твой-host:port.