Figure Ely

Figura Ely

通过 Figura 登录您的 Ely.by 账号，即可使用 Figura 头像。

为什么需要这个模组

Figura 通过 Mojang 的会话服务器验证账号所有者。如果您 通过 Ely.by（离线生态，authlib injector）游玩，Figura 的官方后端 将不允许您通过——您的头像将无法加载，也无法被其他人看到。

Figura Ely 解决了这个问题：该模组将 Figura 重定向到一个通过 Ely.by 验证登录的后端（来自 Ely.by 的 hasJoined，而非 Mojang）。默认情况下， 使用公共后端，因此无需任何配置——只需安装它并 开始游戏。

工作原理

1. 您使用 Ely.by 账号启动游戏（通过 authlib injector——例如， ElyPrismLauncher）。这意味着 Figura 的登录检查（joinServer）已发送到 Ely.by 服务器。
2. 该模组将 Figura 中的官方地址替换为兼容 Ely.by 的后端地址。
3. 后端通过 Ely.by 验证您的登录并签发令牌。头像加载、 同步，并且对所有使用同一后端的玩家可见。

该模组纯粹是 客户端 模组；它不干扰游戏会话，并通过 反射与 Figura 通信——因此它能在 Figura 更新期间继续工作，如果 Figura 内部将来发生变化，它只会记录如何手动设置地址的说明， 而不会破坏游戏。

要求

加载器	Fabric（Fabric Loader 0.16+）
Minecraft	1.21.x
Java	21+
依赖项	Figura 和 Fabric API（必需）
账号	使用 [authlib-injector]（https://docs.ely.by/ru/authlib-injector.html）通过 Ely.by 登录（最简单的方法——ElyPrismLauncher）

如果未通过 Ely.by 登录，该模组毫无意义：后端专门通过 Ely.by 验证您的身份。普通的 Microsoft 账号应与标准版 Figura 配合使用。

安装

1. 安装 Fabric Loader、Fabric API 和 Figura。
2. 将 figura-ely-x.y.z.jar 放入 mods/ 文件夹。
3. 使用您的 Ely.by 账号（authlib-injector / ElyPrismLauncher）启动游戏。
4. 完成。装备您的头像——安装了此模组的其他玩家将能看到它。

配置（可选）

首次启动游戏时，会创建 config/figura-ely.json 文件：

{
  “enabled”: true,
  “backendHost”: “example.com”
}

• enabled — 模组的总开关（false → Figura 保持使用官方后端）。
• backendHost — 兼容 Ely.by 的后端地址。您可以指定自己的， 包括端口：“myhost.example:8443”。

编辑文件后，请重启游戏。

您自己的后端

默认的公共后端是一个共享的“岛屿”：头像仅对 同一地址的用户可见，并且未连接到主 Figura 网络。如果您想要完全 控制权（您自己的服务器、您自己的团队、局域网），您可以自行搭建 后端（Node.js、Docker + 自动 HTTPS，或用于局域网的自动签名 TLS）并 在 backendHost 中进行配置。后端和模组的源代码可通过 此页面上的 Source 链接获取。

对于使用自签名证书的自托管后端，该模组可以自动添加 信任：将 config/figura-ely.crt 放在配置文件旁边（或构建 一个嵌入了证书的 JAR）——模组将在启动时将其导入游戏 JVM 的信任库。 对于使用标准证书（Let’s Encrypt）的公共域名，则无需此操作。

限制

• 只有使用相同 backendHost 的玩家才能看到彼此的头像。
• 这是一个单独的附加组件，不 连接到主 Figura 网络。
• 您必须通过 Ely.by 登录——使用 Microsoft/Mojang 账号没有意义。

免责声明

这是一个非官方项目。它与 Figura 团队或 Ely.by 无关。Figura、Fabric 和 Ely.by 归其各自作者所有。该模组根据 MIT 许可证授权。