TrueUUID

模组

· 作者 YuWan030

TrueUUID 允许高级账号和离线模式的 Minecraft 玩家在同一个服务器上一起游玩。高级玩家保留其真实的 Minecraft UUID 和皮肤,而离线玩家也可以正常加入。

0 本站下载 0 关注 更新于 2 个月前

最新 1.3.0+forge-1.21.6 · 1.21.6 · Forge

一键开服(送7天)

TrueUUID

English | 简体中文

TrueUUID 为运行在离线模式下的模组化 Minecraft 服务器添加了账户验证功能。正版玩家的访问令牌保留在其本地计算机上;服务器仅接收用于验证其 UUID 和皮肤所需的登录凭证。

客户端和服务端必须安装相同的 TrueUUID JAR 文件。请务必选择与你的 Minecraft 版本及加载器完全匹配的 JAR。

[!IMPORTANT] 版本 1.2.0 仅发布 目标矩阵 中批准的 36 个确切目标。未包含的 Minecraft 补丁不隐含支持。

快速开始

  1. 下载或构建与你所用加载器和 Minecraft 版本完全匹配的 JAR 文件。

  2. 将该 JAR 文件放入客户端和服务端的 mods 文件夹中。

  3. 将服务端设置为离线模式:

    online-mode=false
    
  4. 启动一次服务端以生成 TrueUUID 配置文件。

  5. 使用匹配的模组化客户端加入游戏。HUD 会显示绿色表示已验证的正版登录,当服务端接受离线回退时则显示红色。

请勿将 run-dev-target.sh 创建的测试服务端暴露到互联网。它故意绑定到 localhost 并使用离线模式进行测试。

TrueUUID 的功能

  • 在不向服务器发送玩家访问令牌的情况下验证 Mojang 会话。
  • 在登录时使用已验证的 UUID、用户名大小写以及签名的皮肤属性。
  • 允许离线玩家加入,同时阻止之前已验证过的名称被重复用于离线模式。
  • 将已知已验证的名称存储在 trueuuid-registry.json 中。
  • 显示本地化的登录反馈以及小型的正版/离线状态徽章。
  • 支持有界的登录超时、响应限制、HTTPS 验证、公共地址检查以及拒绝重定向。
  • 对于目标矩阵中标注了该功能的适配器,支持配置的 Yggdrasil/authlib-injector 服务。

所有目前声明的 36 个适配器均包含离线到已验证的数据迁移、管理员命令以及插件 API。每一个确切目标都通过了正版、离线回退、确认迁移以及已知名称拒绝的安装 JAR 矩阵测试。请参阅目标矩阵,不要假设每个已实现的功能或未包含的相邻 Minecraft 补丁都已经过测试。

登录验证工作原理

  1. 离线模式服务端向客户端发送一次性登录挑战。
  2. 客户端使用其本地会话通过 Mojang 的 joinServer 调用回应挑战。其访问令牌永远不会离开客户端。
  3. 服务端通过 Mojang 的 hasJoined 端点检查结果。
  4. 成功的登录将获得已验证的 UUID 和签名的皮肤属性。
  5. 失败或超时的检查将被拒绝或由配置的离线回退策略处理。

对于允许的 Yggdrasil 提供商,相同的流程使用其 HTTPS 会话端点。自定义端点在主机被明确列入白名单之前处于禁用状态。

安装

服务端

  1. 安装与 TrueUUID 文件名相匹配的加载器和 Minecraft 版本。
  2. 将 JAR 文件复制到服务端的 mods 目录中。
  3. 在 server.properties 中设置 online-mode=false。
  4. 在配置和测试期间,让服务端保持在防火墙后面。

Prism Launcher

  1. 打开与 JAR 文件的 Minecraft 版本和加载器匹配的实例。
  2. 选择 Edit → Mods → Add file。
  3. 从目标的 build/libs 目录中选择构建好的 TrueUUID JAR。
  4. 在服务端安装相同的 JAR。

请勿在 NeoForge 中使用 Forge JAR,也不要使用为其他 Minecraft 补丁构建的 JAR。对于 Fabric,请使用 build/libs 中的重映射 JAR,切勿使用 build/devlibs 中的开发 JAR。

配置

Forge 和 NeoForge 生成:

config/trueuuid-common.toml

Fabric 生成:

config/trueuuid.json

Forge 和 NeoForge 使用以下 TOML 键。Fabric 将匹配的登录策略设置存储在 JSON 的 auth 对象中;目标矩阵列出了任何适配器特定的差异。

主要策略选项如下:

auth.timeoutMs = 30000
auth.allowOfflineOnTimeout = false
auth.allowOfflineOnFailure = true
auth.knownPremiumDenyOffline = true
auth.allowOfflineForUnknownOnly = true
auth.recentIpGrace.enabled = true
auth.recentIpGrace.ttlSeconds = 10
auth.showJoinFeedback = true
auth.showJoinTitle = false
auth.showAccountOverlay = true

推荐的默认值允许未知的离线名称,但阻止该名称在完成已验证登录后回退到离线模式。

三种加载器都可以定位账户徽章。Forge 和 NeoForge 使用 TOML;Fabric 使用 JSON auth 对象内的匹配键:

auth.overlayCorner = "bottom_right"
auth.overlayOffsetX = 0
auth.overlayOffsetY = 0
auth.overlayScale = 1.25

对于 Yggdrasil/authlib-injector 提供商,仅添加你信任的主机:

auth.yggdrasil.apiRootWhitelist = ["littleskin.cn"]

空的白名单将使 Mojang 成为唯一接受的会话服务。

迁移和管理员命令

TrueUUID 可以备份并将同名离线玩家数据移动到已验证的 UUID。迁移需要确认,并在更改文件之前保留旧的离线数据和任何现有的目标数据。

可用的管理员命令:

/trueuuid cleanupuuid <name>
/trueuuid migrateuuid <name>

这两个命令都需要权限等级 4。目标矩阵标识了当前哪些适配器包含迁移功能。

插件 API

服务端 API 公开了 cn.alini.trueuuid.api.TrueuuidApi。其他模组可以查询玩家是以正版身份加入还是通过离线回退加入:

AccountStatus status = TrueuuidApi.getStatus(serverPlayer);
if (status.isOffline()) {
    // 应用你的服务器的离线玩家策略。
}

API 还提供登录回调和对已验证名称注册表的访问。在使用之前请检查目标矩阵。

为 Prism Launcher 构建单个 JAR

Gradle 必须使用 Java 21 启动,以支持所有目标平台。Java 17 目标仍会自动使用其声明的 Java 17 工具链进行编译和运行。

在 Linux 上,从仓库检出目录执行:

cd ~/TrueUUID
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
export PATH="$JAVA_HOME/bin:$PATH"

TARGET=neoforge-1.21.11
./scripts/ci/build-target.sh "$TARGET"

生成的适用于 Prism 的 JAR 文件路径如下:

platform/neoforge-1.21.11/build/libs/trueuuid-1.2.0-neoforge-1.21.11.jar

将 TARGET 更改为 release/targets.json 中的任意 ID,例如:

forge-1.20.1
forge-1.21.6
forge-1.21.8
fabric-1.20.1
fabric-1.20.2
fabric-1.20.4
fabric-1.20.6
fabric-1.21.1
fabric-1.21.3
fabric-1.21.4
fabric-1.21.5
fabric-1.21.6
fabric-1.21.8
fabric-1.21.10
fabric-1.21.11
neoforge-1.20.4
neoforge-1.21.11

列出所有可用目标的方法:

jq -r '.targets[].id' release/targets.json

在 Windows PowerShell 中,已选择 Java 21 的情况下:

.\gradlew.bat :platform:neoforge-1.21.11:build --no-daemon
# Forge 1.21.11 是独立的 Gradle 9.5 目标:
.\platform\forge-1.21.11\gradlew.bat -p platform/forge-1.21.11 build --no-daemon

若要构建所有目标,请执行:

./scripts/ci/build-all-targets.sh

每个完成的生产用 JAR 文件均写入至以下路径:

platform/<loader>-<minecraft-version>/build/libs/

有关本地客户端/服务器开发运行,请参阅 本地运行时测试。

隐私与安全

  • 玩家的访问令牌仅保留在客户端。
  • 服务器接收的是非ce结果、UUID、用户名以及签名的配置文件属性——而非令牌本身。
  • 自定义认证端点必须使用 HTTPS,并通过配置的 host、DNS/IP、超时时间、响应大小及重定向检查。
  • 离线回退是一种服务器策略。在公共服务器上请保持已知名称保护功能启用。

许可证

TrueUUID 遵循 GNU LGPL 3.0 许可协议。

原始 TrueUUID 锁徽标纹理版权归 © 2026 F1xGOD 所有,并随项目一同分发,同样采用 GNU LGPL 3.0 许可协议。

由 @YuWan-030、@wish131400 和 @F1xGOD 维护。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源