TrueUUID

Modrinth

TrueUUID lets premium and offline-mode Minecraft players play together on the same server. Premium players keep their real Minecraft UUID and skin, while offline players can still join normally.

35.6K downloads18 followersUpdated 1mo ago

1.3.0+forge-1.21.6 · MC 1.21.6 · Forge

View on Modrinth

Files

1.3.0+forge-1.21.6
release
TrueUUID 1.3.0 for Forge 1.21.6
1.21.6forge
2026-09-13 · 114 downloads
trueuuid-1.3.0-forge-1.21.6.jar · 254 KB
1.3.0+fabric-1.20.2
release
TrueUUID 1.3.0 for Fabric 1.20.2
1.20.2fabric
2026-09-13 · 37 downloads
trueuuid-1.3.0-fabric-1.20.2.jar · 242 KB
1.3.0+neoforge-1.20.1
release
TrueUUID 1.3.0 for NeoForge 1.20.1
1.20.1neoforge
2026-09-13 · 125 downloads
trueuuid-1.3.0-neoforge-1.20.1.jar · 290 KB
1.3.0+fabric-1.20.3
release
TrueUUID 1.3.0 for Fabric 1.20.3
1.20.3fabric
2026-09-13 · 13 downloads
trueuuid-1.3.0-fabric-1.20.3.jar · 242 KB
1.3.0+neoforge-1.20.4
release
TrueUUID 1.3.0 for NeoForge 1.20.4
1.20.4neoforge
2026-09-13 · 31 downloads
trueuuid-1.3.0-neoforge-1.20.4.jar · 235 KB
1.3.0+forge-1.21.9
release
TrueUUID 1.3.0 for Forge 1.21.9
1.21.9forge
2026-09-13 · 21 downloads
trueuuid-1.3.0-forge-1.21.9.jar · 255 KB
1.3.0+fabric-1.20.1
release
TrueUUID 1.3.0 for Fabric 1.20.1
1.20.1fabric
2026-09-13 · 249 downloads
trueuuid-1.3.0-fabric-1.20.1.jar · 242 KB
1.3.0+fabric-1.21.7
release
TrueUUID 1.3.0 for Fabric 1.21.7
1.21.7fabric
2026-09-13 · 22 downloads
trueuuid-1.3.0-fabric-1.21.7.jar · 244 KB
1.3.0+neoforge-1.21.10
release
TrueUUID 1.3.0 for NeoForge 1.21.10
1.21.10neoforge
2026-09-13 · 39 downloads
trueuuid-1.3.0-neoforge-1.21.10.jar · 236 KB
1.3.0+fabric-1.21.8
release
TrueUUID 1.3.0 for Fabric 1.21.8
1.21.8fabric
2026-09-13 · 55 downloads
trueuuid-1.3.0-fabric-1.21.8.jar · 244 KB
1.3.0+forge-1.20.3
release
TrueUUID 1.3.0 for Forge 1.20.3
1.20.3forge
2026-09-13 · 23 downloads
trueuuid-1.3.0-forge-1.20.3.jar · 238 KB
1.3.0+fabric-1.21.6
release
TrueUUID 1.3.0 for Fabric 1.21.6
1.21.6fabric
2026-09-13 · 18 downloads
trueuuid-1.3.0-fabric-1.21.6.jar · 244 KB
1.3.0+neoforge-1.21.6
release
TrueUUID 1.3.0 for NeoForge 1.21.6
1.21.6neoforge
2026-09-13 · 11 downloads
trueuuid-1.3.0-neoforge-1.21.6.jar · 236 KB
1.3.0+forge-1.21
release
TrueUUID 1.3.0 for Forge 1.21
1.21forge
2026-09-13 · 16 downloads
trueuuid-1.3.0-forge-1.21.jar · 254 KB
1.3.0+paper-1.20.1
release
TrueUUID 1.3.0 for Paper 1.20.1
1.20.1paper
2026-09-13 · 80 downloads
trueuuid-1.3.0-paper-1.20.1.jar · 328 KB
1.3.0+forge-1.21.8
release
TrueUUID 1.3.0 for Forge 1.21.8
1.21.8forge
2026-09-13 · 19 downloads
trueuuid-1.3.0-forge-1.21.8.jar · 256 KB
1.3.0+neoforge-1.21.4
release
TrueUUID 1.3.0 for NeoForge 1.21.4
1.21.4neoforge
2026-09-13 · 17 downloads
trueuuid-1.3.0-neoforge-1.21.4.jar · 236 KB
1.3.0+forge-1.21.1
release
TrueUUID 1.3.0 for Forge 1.21.1
1.21.1forge
2026-09-13 · 90 downloads
trueuuid-1.3.0-forge-1.21.1.jar · 254 KB
1.3.0+fabric-1.21.5
release
TrueUUID 1.3.0 for Fabric 1.21.5
1.21.5fabric
2026-09-13 · 12 downloads
trueuuid-1.3.0-fabric-1.21.5.jar · 244 KB
1.3.0+forge-1.20.6
release
TrueUUID 1.3.0 for Forge 1.20.6
1.20.6forge
2026-09-13 · 14 downloads
trueuuid-1.3.0-forge-1.20.6.jar · 236 KB
1.3.0+neoforge-1.20.3
release
TrueUUID 1.3.0 for NeoForge 1.20.3
1.20.3neoforge
2026-09-13 · 1 downloads
trueuuid-1.3.0-neoforge-1.20.3.jar · 236 KB
1.3.0+neoforge-1.21.9
release
TrueUUID 1.3.0 for NeoForge 1.21.9
1.21.9neoforge
2026-09-13 · 15 downloads
trueuuid-1.3.0-neoforge-1.21.9.jar · 236 KB
1.3.0+forge-1.21.11
release
TrueUUID 1.3.0 for Forge 1.21.11
1.21.11forge
2026-09-13 · 159 downloads
trueuuid-1.3.0-forge-1.21.11.jar · 255 KB
1.3.0+neoforge-1.20.6
release
TrueUUID 1.3.0 for NeoForge 1.20.6
1.20.6neoforge
2026-09-13 · 18 downloads
trueuuid-1.3.0-neoforge-1.20.6.jar · 235 KB
1.3.0+neoforge-1.21.3
release
TrueUUID 1.3.0 for NeoForge 1.21.3
1.21.3neoforge
2026-09-13 · 12 downloads
trueuuid-1.3.0-neoforge-1.21.3.jar · 236 KB
1.3.0+neoforge-1.20.5
release
TrueUUID 1.3.0 for NeoForge 1.20.5
1.20.5neoforge
2026-09-13 · 1 downloads
trueuuid-1.3.0-neoforge-1.20.5.jar · 235 KB
1.3.0+neoforge-1.21.7
release
TrueUUID 1.3.0 for NeoForge 1.21.7
1.21.7neoforge
2026-09-13 · 21 downloads
trueuuid-1.3.0-neoforge-1.21.7.jar · 236 KB
1.3.0+fabric-1.21.11
release
TrueUUID 1.3.0 for Fabric 1.21.11
1.21.11fabric
2026-09-13 · 649 downloads
trueuuid-1.3.0-fabric-1.21.11.jar · 244 KB
1.3.0+forge-1.21.4
release
TrueUUID 1.3.0 for Forge 1.21.4
1.21.4forge
2026-09-13 · 29 downloads
trueuuid-1.3.0-forge-1.21.4.jar · 255 KB
1.3.0+fabric-1.21.10
release
TrueUUID 1.3.0 for Fabric 1.21.10
1.21.10fabric
2026-09-13 · 38 downloads
trueuuid-1.3.0-fabric-1.21.10.jar · 244 KB
1.3.0+spigot-1.20.1
release
TrueUUID 1.3.0 for Spigot 1.20.1
1.20.1spigot
2026-09-13 · 19 downloads
trueuuid-1.3.0-spigot-1.20.1.jar · 325 KB
1.3.0+neoforge-1.21
release
TrueUUID 1.3.0 for NeoForge 1.21
1.21neoforge
2026-09-13 · 16 downloads
trueuuid-1.3.0-neoforge-1.21.jar · 236 KB
1.3.0+neoforge-1.21.8
release
TrueUUID 1.3.0 for NeoForge 1.21.8
1.21.8neoforge
2026-09-13 · 3 downloads
trueuuid-1.3.0-neoforge-1.21.8.jar · 236 KB
1.3.0+fabric-1.21
release
TrueUUID 1.3.0 for Fabric 1.21
1.21fabric
2026-09-13 · 17 downloads
trueuuid-1.3.0-fabric-1.21.jar · 244 KB
1.3.0+fabric-1.20.6
release
TrueUUID 1.3.0 for Fabric 1.20.6
1.20.6fabric
2026-09-13 · 5 downloads
trueuuid-1.3.0-fabric-1.20.6.jar · 244 KB
1.3.0+fabric-1.21.4
release
TrueUUID 1.3.0 for Fabric 1.21.4
1.21.4fabric
2026-09-13 · 81 downloads
trueuuid-1.3.0-fabric-1.21.4.jar · 244 KB
1.3.0+forge-1.20.2
release
TrueUUID 1.3.0 for Forge 1.20.2
1.20.2forge
2026-09-13 · 15 downloads
trueuuid-1.3.0-forge-1.20.2.jar · 238 KB
1.3.0+forge-1.21.7
release
TrueUUID 1.3.0 for Forge 1.21.7
1.21.7forge
2026-09-13 · 12 downloads
trueuuid-1.3.0-forge-1.21.7.jar · 254 KB
1.3.0+forge-1.21.3
release
TrueUUID 1.3.0 for Forge 1.21.3
1.21.3forge
2026-09-13 · 18 downloads
trueuuid-1.3.0-forge-1.21.3.jar · 254 KB
1.3.0+forge-1.21.10
release
TrueUUID 1.3.0 for Forge 1.21.10
1.21.10forge
2026-09-13 · 33 downloads
trueuuid-1.3.0-forge-1.21.10.jar · 256 KB
1.3.0+fabric-1.21.9
release
TrueUUID 1.3.0 for Fabric 1.21.9
1.21.9fabric
2026-09-13 · 9 downloads
trueuuid-1.3.0-fabric-1.21.9.jar · 244 KB
1.3.0+neoforge-1.20.2
release
TrueUUID 1.3.0 for NeoForge 1.20.2
1.20.2neoforge
2026-09-13 · 2 downloads
trueuuid-1.3.0-neoforge-1.20.2.jar · 236 KB
1.3.0+fabric-1.20.4
release
TrueUUID 1.3.0 for Fabric 1.20.4
1.20.4fabric
2026-09-13 · 19 downloads
trueuuid-1.3.0-fabric-1.20.4.jar · 242 KB
1.3.0+neoforge-1.21.1
release
TrueUUID 1.3.0 for NeoForge 1.21.1
1.21.1neoforge
2026-09-13 · 2.2K downloads
trueuuid-1.3.0-neoforge-1.21.1.jar · 254 KB
1.3.0+fabric-1.20.5
release
TrueUUID 1.3.0 for Fabric 1.20.5
1.20.5fabric
2026-09-13 · 2 downloads
trueuuid-1.3.0-fabric-1.20.5.jar · 244 KB
1.3.0+neoforge-1.21.5
release
TrueUUID 1.3.0 for NeoForge 1.21.5
1.21.5neoforge
2026-09-13 · 18 downloads
trueuuid-1.3.0-neoforge-1.21.5.jar · 236 KB
1.3.0+fabric-1.21.3
release
TrueUUID 1.3.0 for Fabric 1.21.3
1.21.3fabric
2026-09-13 · 11 downloads
trueuuid-1.3.0-fabric-1.21.3.jar · 244 KB
1.3.0+forge-1.20.1
release
TrueUUID 1.3.0 for Forge 1.20.1
1.20.1forge
2026-09-13 · 2.4K downloads
trueuuid-1.3.0-forge-1.20.1.jar · 290 KB
1.3.0+neoforge-1.21.2
release
TrueUUID 1.3.0 for NeoForge 1.21.2
1.21.2neoforge
2026-09-13 · 15 downloads
trueuuid-1.3.0-neoforge-1.21.2.jar · 236 KB
1.3.0+forge-1.21.5
release
TrueUUID 1.3.0 for Forge 1.21.5
1.21.5forge
2026-09-13 · 5 downloads
trueuuid-1.3.0-forge-1.21.5.jar · 255 KB
1.3.0+forge-1.20.4
release
TrueUUID 1.3.0 for Forge 1.20.4
1.20.4forge
2026-09-13 · 14 downloads
trueuuid-1.3.0-forge-1.20.4.jar · 238 KB
1.3.0+neoforge-1.21.11
release
TrueUUID 1.3.0 for NeoForge 1.21.11
1.21.11neoforge
2026-09-13 · 158 downloads
trueuuid-1.3.0-neoforge-1.21.11.jar · 236 KB
1.3.0+fabric-1.21.2
release
TrueUUID 1.3.0 for Fabric 1.21.2
1.21.2fabric
2026-09-13 · 4 downloads
trueuuid-1.3.0-fabric-1.21.2.jar · 244 KB
1.3.0+fabric-1.21.1
release
TrueUUID 1.3.0 for Fabric 1.21.1
1.21.1fabric
2026-09-13 · 317 downloads
trueuuid-1.3.0-fabric-1.21.1.jar · 244 KB
1.2.0+forge-1.21.6
release
TrueUUID 1.2.0 for Forge 1.21.6
1.21.6forge
2026-07-23 · 67 downloads
trueuuid-1.2.0-forge-1.21.6.jar · 190 KB
1.2.0+fabric-1.21.8
release
TrueUUID 1.2.0 for Fabric 1.21.8
1.21.8fabric
2026-07-23 · 58 downloads
trueuuid-1.2.0-fabric-1.21.8.jar · 178 KB
1.2.0+fabric-1.21.1
release
TrueUUID 1.2.0 for Fabric 1.21.1
1.21.1fabric
2026-07-23 · 387 downloads
trueuuid-1.2.0-fabric-1.21.1.jar · 178 KB
1.2.0+neoforge-1.20.6
release
TrueUUID 1.2.0 for NeoForge 1.20.6
1.20.6neoforge
2026-07-23 · 31 downloads
trueuuid-1.2.0-neoforge-1.20.6.jar · 171 KB
1.2.0+forge-1.21.8
release
TrueUUID 1.2.0 for Forge 1.21.8
1.21.8forge
2026-07-23 · 38 downloads
trueuuid-1.2.0-forge-1.21.8.jar · 191 KB
1.2.0+forge-1.20.1
release
TrueUUID 1.2.0 for Forge 1.20.1
1.20.1forge
2026-07-23 · 2.3K downloads
trueuuid-1.2.0-forge-1.20.1.jar · 226 KB
1.2.0+neoforge-1.21.10
release
TrueUUID 1.2.0 for NeoForge 1.21.10
1.21.10neoforge
2026-07-23 · 53 downloads
trueuuid-1.2.0-neoforge-1.21.10.jar · 171 KB
1.2.0+fabric-1.21.6
release
TrueUUID 1.2.0 for Fabric 1.21.6
1.21.6fabric
2026-07-23 · 42 downloads
trueuuid-1.2.0-fabric-1.21.6.jar · 178 KB
1.2.0+forge-1.21.3
release
TrueUUID 1.2.0 for Forge 1.21.3
1.21.3forge
2026-07-23 · 35 downloads
trueuuid-1.2.0-forge-1.21.3.jar · 190 KB
1.2.0+neoforge-1.21.1
release
TrueUUID 1.2.0 for NeoForge 1.21.1
1.21.1neoforge
2026-07-23 · 2K downloads
trueuuid-1.2.0-neoforge-1.21.1.jar · 190 KB
1.2.0+fabric-1.20.2
release
TrueUUID 1.2.0 for Fabric 1.20.2
1.20.2fabric
2026-07-23 · 29 downloads
trueuuid-1.2.0-fabric-1.20.2.jar · 176 KB
1.2.0+neoforge-1.21.4
release
TrueUUID 1.2.0 for NeoForge 1.21.4
1.21.4neoforge
2026-07-23 · 39 downloads
trueuuid-1.2.0-neoforge-1.21.4.jar · 171 KB
1.2.0+neoforge-1.20.2
release
TrueUUID 1.2.0 for NeoForge 1.20.2
1.20.2neoforge
2026-07-23 · 19 downloads
trueuuid-1.2.0-neoforge-1.20.2.jar · 172 KB
1.2.0+neoforge-1.21.5
release
TrueUUID 1.2.0 for NeoForge 1.21.5
1.21.5neoforge
2026-07-23 · 30 downloads
trueuuid-1.2.0-neoforge-1.21.5.jar · 171 KB
1.2.0+fabric-1.20.6
release
TrueUUID 1.2.0 for Fabric 1.20.6
1.20.6fabric
2026-07-23 · 19 downloads
trueuuid-1.2.0-fabric-1.20.6.jar · 178 KB
1.2.0+neoforge-1.20.4
release
TrueUUID 1.2.0 for NeoForge 1.20.4
1.20.4neoforge
2026-07-23 · 16 downloads
trueuuid-1.2.0-neoforge-1.20.4.jar · 171 KB
1.2.0+forge-1.21.5
release
TrueUUID 1.2.0 for Forge 1.21.5
1.21.5forge
2026-07-23 · 12 downloads
trueuuid-1.2.0-forge-1.21.5.jar · 191 KB
1.2.0+fabric-1.21.10
release
TrueUUID 1.2.0 for Fabric 1.21.10
1.21.10fabric
2026-07-23 · 45 downloads
trueuuid-1.2.0-fabric-1.21.10.jar · 178 KB
1.2.0+forge-1.21.4
release
TrueUUID 1.2.0 for Forge 1.21.4
1.21.4forge
2026-07-23 · 48 downloads
trueuuid-1.2.0-forge-1.21.4.jar · 191 KB
1.2.0+neoforge-1.21.8
release
TrueUUID 1.2.0 for NeoForge 1.21.8
1.21.8neoforge
2026-07-23 · 29 downloads
trueuuid-1.2.0-neoforge-1.21.8.jar · 171 KB
1.2.0+fabric-1.20.4
release
TrueUUID 1.2.0 for Fabric 1.20.4
1.20.4fabric
2026-07-23 · 16 downloads
trueuuid-1.2.0-fabric-1.20.4.jar · 176 KB
1.2.0+neoforge-1.21.11
release
TrueUUID 1.2.0 for NeoForge 1.21.11
1.21.11neoforge
2026-07-23 · 137 downloads
trueuuid-1.2.0-neoforge-1.21.11.jar · 171 KB
1.2.0+fabric-1.21.3
release
TrueUUID 1.2.0 for Fabric 1.21.3
1.21.3fabric
2026-07-23 · 11 downloads
trueuuid-1.2.0-fabric-1.21.3.jar · 178 KB
1.2.0+neoforge-1.20.1
release
TrueUUID 1.2.0 for NeoForge 1.20.1
1.20.1neoforge
2026-07-23 · 64 downloads
trueuuid-1.2.0-neoforge-1.20.1.jar · 226 KB
1.2.0+fabric-1.20.1
release
TrueUUID 1.2.0 for Fabric 1.20.1
1.20.1fabric
2026-07-23 · 201 downloads
trueuuid-1.2.0-fabric-1.20.1.jar · 176 KB
1.2.0+forge-1.20.4
release
TrueUUID 1.2.0 for Forge 1.20.4
1.20.4forge
2026-07-23 · 18 downloads
trueuuid-1.2.0-forge-1.20.4.jar · 174 KB
1.2.0+fabric-1.21.4
release
TrueUUID 1.2.0 for Fabric 1.21.4
1.21.4fabric
2026-07-23 · 59 downloads
trueuuid-1.2.0-fabric-1.21.4.jar · 178 KB
1.2.0+neoforge-1.21.3
release
TrueUUID 1.2.0 for NeoForge 1.21.3
1.21.3neoforge
2026-07-23 · 18 downloads
trueuuid-1.2.0-neoforge-1.21.3.jar · 171 KB
1.2.0+forge-1.21.1
release
TrueUUID 1.2.0 for Forge 1.21.1
1.21.1forge
2026-07-23 · 60 downloads
trueuuid-1.2.0-forge-1.21.1.jar · 190 KB
1.2.0+fabric-1.21.5
release
TrueUUID 1.2.0 for Fabric 1.21.5
1.21.5fabric
2026-07-23 · 22 downloads
trueuuid-1.2.0-fabric-1.21.5.jar · 178 KB
1.2.0+fabric-1.21.11
release
TrueUUID 1.2.0 for Fabric 1.21.11
1.21.11fabric
2026-07-23 · 465 downloads
trueuuid-1.2.0-fabric-1.21.11.jar · 178 KB
1.2.0+neoforge-1.21.6
release
TrueUUID 1.2.0 for NeoForge 1.21.6
1.21.6neoforge
2026-07-23 · 19 downloads
trueuuid-1.2.0-neoforge-1.21.6.jar · 171 KB
1.2.0+forge-1.21.10
release
TrueUUID 1.2.0 for Forge 1.21.10
1.21.10forge
2026-07-23 · 35 downloads
trueuuid-1.2.0-forge-1.21.10.jar · 191 KB
1.2.0+forge-1.21.11
release
TrueUUID 1.2.0 for Forge 1.21.11
1.21.11forge
2026-07-23 · 147 downloads
trueuuid-1.2.0-forge-1.21.11.jar · 191 KB
1.2.0+forge-1.20.2
release
TrueUUID 1.2.0 for Forge 1.20.2
1.20.2forge
2026-07-23 · 8 downloads
trueuuid-1.2.0-forge-1.20.2.jar · 174 KB
1.2.0+forge-1.20.6
release
TrueUUID 1.2.0 for Forge 1.20.6
1.20.6forge
2026-07-23 · 31 downloads
trueuuid-1.2.0-forge-1.20.6.jar · 172 KB
1.1.2
release
TrueUUID 1.1.2
1.21.1neoforge
2026-07-13 · 478 downloads
trueuuid-1.1.2-neoforge1.21.1.jar · 87 KB
1.1.2
release
TrueUUID 1.1.2
1.20.1forge
2026-07-13 · 538 downloads
trueuuid-1.1.2-forge1.20.1.jar · 80 KB
1.1.0
release
TrueUUID 1.1.0
1.21.1neoforge
2026-07-02 · 469 downloads
trueuuid-1.1.0-neoforge1.21.1.jar · 85 KB
1.1.0
release
TrueUUID 1.1.0
1.20.61.20.51.20.41.20.3+2forge
2026-07-02 · 456 downloads
trueuuid-1.1.0-forge1.20.1.jar · 78 KB
1.0.9
release
TrueUUID 1.0.9
1.21.1neoforge
2026-06-01 · 1.1K downloads
trueuuid-1.0.9-neoforge1.21.1.jar · 83 KB
1.0.9
release
TrueUUID 1.0.9
1.20.61.20.51.20.41.20.3+2forge
2026-06-01 · 2K downloads
trueuuid-1.0.9-forge1.20.1.jar · 76 KB
1.0.4
release
TrueUUID 1.0.4
1.21.1neoforge
2025-11-28 · 2.6K downloads
trueuuid-1.0.4-neoforge1.21.1.jar · 56 KB
1.0.5
release
TrueUUID 1.0.5
1.20.51.20.41.20.31.20.2+1forge
2025-10-19 · 12.3K downloads
trueuuid-1.0.5.jar · 51 KB
1.0.2
release
TrueUUID 1.0.2
1.20.61.20.51.20.41.20.3+2forge
2025-09-09 · 1.5K downloads
trueuuid-1.0.2.jar · 46 KB
1.0.1
release
TrueUUID 1.0.1
1.20.61.20.51.20.41.20.3+2forge
2025-09-08 · 102 downloads
trueuuid-1.0.1.jar · 40 KB

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

About

English | 简体中文

TrueUUID adds account verification to modded Minecraft servers that run in offline mode. A premium player's access token stays on their own computer; the server receives only the login proof needed to verify their UUID and skin.

The same TrueUUID JAR must be installed on the client and server. Always choose the JAR made for your exact Minecraft version and loader.

[!IMPORTANT] Version 1.2.0 publishes only the 36 exact targets approved in the target matrix. Omitted Minecraft patches are not implicitly supported.

Quick start

Download or build the JAR for your exact loader and Minecraft version.
Put that same JAR in the client's and server's mods folders.
Set the server to offline mode:
```
online-mode=false
```
Start the server once to generate the TrueUUID configuration.
Join with a matching modded client. The HUD shows green for a verified premium login and red when the server accepts offline fallback.

Do not expose a development server created by run-dev-target.sh to the internet. It deliberately binds to localhost and uses offline mode for testing.

What TrueUUID does

Verifies Mojang sessions without sending the player's access token to the server.
Uses the verified UUID, username casing, and signed skin properties during login.
Can allow offline players while blocking offline reuse of names that were previously verified.
Stores known verified names in trueuuid-registry.json.
Shows localized login feedback and a small premium/offline status badge.
Supports bounded login timeouts, response limits, HTTPS validation, public address checks, and redirect refusal.
Supports configured Yggdrasil/authlib-injector services on adapters that list that feature in the target matrix.

All 36 currently declared adapters include offline-to-verified data migration, admin commands, and the addon API. Every exact target passed the premium, offline fallback, confirmed migration, and known-name denial installed-JAR matrix. Consult the target matrix instead of assuming every implemented feature or an omitted adjacent Minecraft patch was exercised.

How login verification works

The offline-mode server sends the client a one-time login challenge.
The client uses its local session to answer the challenge through Mojang's joinServer call. Its access token never leaves the client.
The server checks the result with Mojang's hasJoined endpoint.
A successful login receives the verified UUID and signed skin properties.
A failed or timed-out check is either rejected or handled by the configured offline-fallback policy.

For an allowed Yggdrasil provider, the same flow uses its HTTPS session endpoint. Custom endpoints are disabled until their host is explicitly allowlisted.

Installation

Server

Install the loader and Minecraft version matching the TrueUUID filename.
Copy the JAR into the server's mods directory.
Set online-mode=false in server.properties.
Keep the server behind a firewall while configuring and testing it.

Prism Launcher

Open the instance matching the JAR's Minecraft version and loader.
Select Edit → Mods → Add file.
Select the built TrueUUID JAR from the target's build/libs directory.
Install the same JAR on the server.

Do not use a Forge JAR in NeoForge, or a JAR built for another Minecraft patch. For Fabric, use the remapped JAR in build/libs, never the development JAR in build/devlibs.

Configuration

Forge and NeoForge generate:

config/trueuuid-common.toml

Fabric generates:

config/trueuuid.json

Forge and NeoForge use the TOML keys below. Fabric stores the matching login policy settings in the JSON auth object; the target matrix lists any adapter-specific gaps.

The main policy options are:

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

The recommended defaults allow an unknown offline name but stop that name from falling back to offline mode after it has completed a verified login.

All three loaders can position the account badge. Forge and NeoForge use TOML; Fabric uses the matching keys inside the JSON auth object:

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

For Yggdrasil/authlib-injector providers, add only hosts you trust:

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

An empty allowlist keeps Mojang as the only accepted session service.

Migration and admin commands

TrueUUID can back up and move same-name offline player data to a verified UUID. Migration requires confirmation and preserves both the old offline data and any existing destination data before changing files.

Available admin commands:

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

Both commands require permission level 4. The target matrix identifies which adapters currently include migration.

Addon API

The server-side API exposes cn.alini.trueuuid.api.TrueuuidApi. Other mods can query whether a player joined as premium or through offline fallback:

AccountStatus status = TrueuuidApi.getStatus(serverPlayer);
if (status.isOffline()) {
    // Apply your server's offline-player policy.
}

The API also provides a login callback and access to the verified-name registry. Check the target matrix before depending on it.

Build one JAR for Prism Launcher

Gradle must be launched with Java 21 for every target. Java 17 targets are still compiled and run with their declared Java 17 toolchain automatically.

On Linux, from the repository checkout:

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"

The Prism-ready JAR is then:

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

Change TARGET to any ID in release/targets.json, for example:

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

List every available target with:

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

On Windows PowerShell, with Java 21 selected:

.\gradlew.bat :platform:neoforge-1.21.11:build --no-daemon
# Forge 1.21.11 is the standalone Gradle 9.5 target:
.\platform\forge-1.21.11\gradlew.bat -p platform/forge-1.21.11 build --no-daemon

To build every target instead:

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

Each finished production JAR is written to:

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

For local client/server development runs, see local runtime testing.

Privacy and security

The player's access token stays on the client.
The server receives a nonce result, UUID, username, and signed profile properties—not the token.
Custom authentication endpoints must use HTTPS and pass the configured host, DNS/IP, timeout, response-size, and redirect checks.
Offline fallback is a server policy. Keep known-name protection enabled on shared servers.

License

TrueUUID is licensed under the GNU LGPL 3.0.

Maintained by @YuWan-030, @wish131400, and @F1xGOD.

TrueUUID

Files

1.3.0+forge-1.21.6

1.3.0+fabric-1.20.2

1.3.0+neoforge-1.20.1

1.3.0+fabric-1.20.3

1.3.0+neoforge-1.20.4

1.3.0+forge-1.21.9

1.3.0+fabric-1.20.1

1.3.0+fabric-1.21.7

1.3.0+neoforge-1.21.10

1.3.0+fabric-1.21.8

1.3.0+forge-1.20.3

1.3.0+fabric-1.21.6

1.3.0+neoforge-1.21.6

1.3.0+forge-1.21

1.3.0+paper-1.20.1

1.3.0+forge-1.21.8

1.3.0+neoforge-1.21.4

1.3.0+forge-1.21.1

1.3.0+fabric-1.21.5

1.3.0+forge-1.20.6

1.3.0+neoforge-1.20.3

1.3.0+neoforge-1.21.9

1.3.0+forge-1.21.11

1.3.0+neoforge-1.20.6

1.3.0+neoforge-1.21.3

1.3.0+neoforge-1.20.5

1.3.0+neoforge-1.21.7

1.3.0+fabric-1.21.11

1.3.0+forge-1.21.4

1.3.0+fabric-1.21.10

1.3.0+spigot-1.20.1

1.3.0+neoforge-1.21

1.3.0+neoforge-1.21.8

1.3.0+fabric-1.21

1.3.0+fabric-1.20.6

1.3.0+fabric-1.21.4

1.3.0+forge-1.20.2

1.3.0+forge-1.21.7

1.3.0+forge-1.21.3

1.3.0+forge-1.21.10

1.3.0+fabric-1.21.9

1.3.0+neoforge-1.20.2

1.3.0+fabric-1.20.4

1.3.0+neoforge-1.21.1

1.3.0+fabric-1.20.5

1.3.0+neoforge-1.21.5

1.3.0+fabric-1.21.3

1.3.0+forge-1.20.1

1.3.0+neoforge-1.21.2

1.3.0+forge-1.21.5

1.3.0+forge-1.20.4

1.3.0+neoforge-1.21.11

1.3.0+fabric-1.21.2

1.3.0+fabric-1.21.1

1.2.0+forge-1.21.6

1.2.0+fabric-1.21.8

1.2.0+fabric-1.21.1

1.2.0+neoforge-1.20.6

1.2.0+forge-1.21.8

1.2.0+forge-1.20.1

1.2.0+neoforge-1.21.10

1.2.0+fabric-1.21.6

1.2.0+forge-1.21.3

1.2.0+neoforge-1.21.1

1.2.0+fabric-1.20.2

1.2.0+neoforge-1.21.4

1.2.0+neoforge-1.20.2

1.2.0+neoforge-1.21.5

1.2.0+fabric-1.20.6

1.2.0+neoforge-1.20.4

1.2.0+forge-1.21.5

1.2.0+fabric-1.21.10

1.2.0+forge-1.21.4

1.2.0+neoforge-1.21.8

1.2.0+fabric-1.20.4

1.2.0+neoforge-1.21.11

1.2.0+fabric-1.21.3

1.2.0+neoforge-1.20.1