FiguraBackend

FiguraBackend

A self-hosted Figura avatar backend for Purpur / Paper / Fabric 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 CustomFigura
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 or 1.21.11 for plugin
• Fabric server 1.21.1/1.21.11 for mod
• A backend port (separate from the Minecraft port) reachable by clients

Setup

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

Setup for mod

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

RU:

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

Хранилище аватаров – сам сервер: при заходе игрока плагин выдаёт одноразовый токен, привязанный
к его UUID, и отправляет клиенту по доверенному игровому каналу. Клиент CustomFigura авторизуется этим
токеном – никаких внешних сервисов и рассинхрона 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 или 1.21.11 для плагина
• Fabric сервер 1.21.1/1.21.11 для мода
• Отдельный порт под бэкенд (не порт Minecraft), доступный клиентам

Установка

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

Установка для мода

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