Unlock FTB Teams｜FTB Teams 离线界面修复
当你已经能进入服务器，却无法正常使用 FTB Teams 队伍界面时，问题可能来自客户端和服务器记录的玩家 UUID 不一致。
Unlock FTB Teams 是一个安装在客户端的轻量兼容补丁：让 FTB Teams 使用当前服务器连接确认的玩家 UUID 查找本地玩家，修复由这一身份差异引发的界面异常。
适用场景
- 服务端启用离线模式，玩家的服务器 UUID 与启动器会话 UUID 不一致。
- 客户端使用离线身份，加入允许该身份登录的服务器后出现队伍界面异常。
- 代理或认证插件分配的 UUID 与客户端启动器 UUID 不一致，且服务器已正确同步 FTB Teams 玩家数据。
是否属于此问题，应结合日志和实际 UUID 判断；并非所有 FTB Teams 界面异常都由离线模式导致。
支持版本
| Minecraft | 加载器 | 推荐搭配的 FTB Teams | Java |
|---|---|---|---|
| 1.20.1 | Forge | 2001.3.2 | 17+ |
| 1.20.1 | Fabric | 2001.3.2 | 17+ |
| 1.21.1 | NeoForge | 2101.1.11 | 21+ |
| 1.21.1 | Fabric | 2101.1.11 | 21+ |
采用 Architectury 多加载器架构，各版本提供独立 JAR。请选择与你的游戏版本和加载器一致的文件。
验证情况
已完成四个平台发行 JAR 的构建、包装检查，以及真实 FTB Teams 类上的 Mixin 行为回归检查（每轮 17 项）。尚未进行真实客户端与服务器的联机 GUI 验收，建议先在测试实例中试用。
安装方法
- 在客户端安装对应版本的 FTB Teams，并安装它所要求的 FTB Library、Architectury API、Fabric API 等依赖（以对应发行版要求为准）。
- 将本补丁对应版本的发行 JAR 放入客户端
mods文件夹。 - 重启客户端并重新进入服务器。
本补丁只需安装在客户端，服务器无需安装。 补丁自身没有新增前置库；FTB Teams 的原有依赖仍需安装。请勿同时安装其他针对同一位置的离线修复，以免重复注入。
与参考方案的区别
参考方案通过用户名计算标准离线 UUID。本项目使用服务器连接实际确认的 UUID，因此也能覆盖不符合标准离线 UUID 算法的自定义身份。
修复同时作用于初次同步与后续队伍增量同步；加入或离开队伍后继续按玩家身份查找，不混淆玩家 UUID 和队伍 UUID。每次从当前连接读取身份，不保存跨服务器的玩家 UUID。
使用边界
- 本补丁不改变服务器登录验证；你需要先能正常进入服务器。
- 本补丁不修改服务端的队伍权限或存档数据，也不会迁移旧 UUID 对应的任务、领地和队伍归属。
- 服务器缺失玩家同步数据、其他模组冲突或网络异常需要另行排查。
- 推荐使用上表版本；其他 FTB Teams 版本若改动了内部方法，可能需要适配。当前测试的范围请查看随项目提供的验证记录。
来源与致谢
- FTB Teams：CurseForge Forge / NeoForge · Fabric · 官方源码
这是独立社区兼容补丁，与 FTB 官方无隶属关系。补丁代码采用 MIT 许可。