FiguraBackend

插件

· 作者 zqicev

用于 Paper/Purpur/Fabric 的自托管 Figura 头像后端 - 在您的离线模式 Minecraft 服务器上共享头像

0 本站下载 0 关注 更新于 4 周前

最新 0.1.6+mc1.21.11 · 1.21.11 · Fabric

一键开服(送7天)

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 端口分离且客户端可达的后端端口

设置步骤

  1. 将 jar 文件放入 plugins/ 目录,启动服务器,然后编辑 plugins/FiguraBackend/config.yml(设置 port;保持 bind-host: 0.0.0.0)。
  2. 在主机上开放该端口。
  3. 使用 Custom Figura 客户端模组,并将其后端地址设置为 your-host:port。

模组设置步骤

  1. 将 jar 文件放入 mods/ 目录,启动服务器,然后编辑 config/FiguraBackend/config.yml(设置 port;保持 bind-host: 0.0.0.0)。
  2. 在主机上开放该端口。
  3. 使用 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), доступный клиентам

Установка

  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,并在其中指定后端地址 你的主机:端口。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源