FiguraBackend
一个面向 Purpur / Paper / Fabric 服务器的自托管 Figura 头像后端。让你的玩家无需通过 Figura 云服务、Mojang 身份验证或 authlib-injector 即可互相看到彼此的 Figura 头像——非常适合离线模式服务器。
服务器本身就是头像的来源:当玩家加入时,插件会生成一个绑定到其 UUID 的一次性令牌,并通过游戏内受信任的通道将其交给客户端。CustomFigura 客户端使用该令牌进行认证——无需外部服务,也不会出现 UUID 漂移。
需要搭配客户端模组:Custom Figura。
功能
- 单端口上的 HTTP + WebSocket 后端(嵌入式,无需额外进程)。
- 头像上传/下载、在线状态、Ping 转发以及玩家间的重载事件。
- 基于磁盘的头像存储支持重启后保留;内存缓存。
- 通过插件消息 (
figura:auth) 实现游戏内会话认证——从不联系 Mojang。
- 可配置的大小限制、MOTD、速率限制和日志级别。
- 支持
proxy-protocol 选项,适用于将端口置于 HAProxy/反 DDoS 代理后的主机。
- WebSocket 保活机制,确保连接能够存活于 NAT / 反 DDoS 空闲超时之后。
- 管理命令:
/figurabackend <status|list|clear <uuid>|reload>。
权限
figurabackend.use - 上传 Figura 头像至云端
figurabackend.admin - 访问 /figurabackend 命令
命令
/figurabackend status - 显示插件状态
/figurabackend list - 显示玩家的 UUID 及头像数量
/figurabackend clear <uuid> - 从云端清除玩家的头像
/figurabackend reload - 重载插件
要求
- Purpur / Paper 1.21.1 或 1.21.11(用于插件)
- Fabric server 1.21.1/1.21.11(用于模组)
- 一个与 Minecraft 端口分离且客户端可达的后端端口
设置步骤
- 将 jar 文件放入
plugins/ 目录,启动服务器,然后编辑
plugins/FiguraBackend/config.yml(设置 port;保持 bind-host: 0.0.0.0)。
- 在主机上开放该端口。
- 使用 Custom Figura 客户端模组,并将其后端地址设置为
your-host:port。
模组设置步骤
- 将 jar 文件放入
mods/ 目录,启动服务器,然后编辑
config/FiguraBackend/config.yml(设置 port;保持 bind-host: 0.0.0.0)。
- 在主机上开放该端口。
- 使用 Custom Figura 客户端模组,并将其后端地址设置为
your-host:port。
俄语:
Свой бэкенд аватаров 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), доступный клиентам
Установка
- Положи jar в
plugins/, запусти сервер, отредактируй
plugins/FiguraBackend/config.yml (укажи port; bind-host оставь 0.0.0.0).
- Открой этот порт у хостинга.
- Используй клиентский мод Custom Figura и укажи в нём
адрес бэкенда
твой-host:port.
模组安装方法
- 将
.jar 文件放入 mods/ 目录,启动服务器后编辑
config/FiguraBackend/config.yml(设置 port;保持 bind-host 为 0.0.0.0)。
- 在主机服务商处开放该端口。
- 使用客户端模组 Custom Figura,并在其中指定后端地址
你的主机:端口。
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
- 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.
Setup for mod
- Drop the jar into
mods/, start the server, then edit
config/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 / 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), доступный клиентам
Установка
- Положи jar в
plugins/, запусти сервер, отредактируй
plugins/FiguraBackend/config.yml (укажи port; bind-host оставь 0.0.0.0).
- Открой этот порт у хостинга.
- Используй клиентский мод Custom Figura и укажи в нём
адрес бэкенда
твой-host:port.
Установка для мода
- Положи jar в
mods/, запусти сервер, отредактируй
config/FiguraBackend/config.yml (укажи port; bind-host оставь 0.0.0.0).
- Открой этот порт у хостинга.
- Используй клиентский мод Custom Figura и укажи в нём
адрес бэкенда
твой-host:port.
评论 0
登录后参与评分
还没有评论,来抢沙发吧