Skip to content
YuWan-030Public

About

A mod that securely verifies premium accounts on an offline-mode server during the login phase, without sending the player's access token to the server.

Resources

Stars

16 stars

Watchers

1 watching

Forks

Repository files navigation

TrueUUID

English | 简体中文

TrueUUID verifies accounts on Minecraft servers using online-mode=false. Verified players keep their UUID, name, and skin. Access tokens go only to the player's authentication service, never to the Minecraft server.

Forge, Fabric, and NeoForge need TrueUUID on both client and server. Choose the JAR for your exact loader and Minecraft version. Spigot and Paper 1.20.1 use a server plugin with ProtocolLib 5.1.0 or newer and also accept unmodified premium clients.

The repository has 52 exact mod targets from Minecraft 1.20.1 through 1.21.11, plus the two server plugins. See the target matrix for versions and test evidence.

Install

  1. Download the JAR for your loader and exact Minecraft version.
  2. Put it in both mods folders. For Spigot/Paper, put the plugin and ProtocolLib in the server's plugins folder.
  3. Set online-mode=false in server.properties.
  4. Start the server to generate the config, then join.

The badge shows each player's verification status. Server owners decide whether players without a login session can join. Previously verified names are protected by default.

See the setup guide for configuration, Prism Launcher, Yggdrasil providers, and confirmed player-data migration. Plugin administrators can use the identity policy guide.

Build

Launch Gradle with JDK 21. Each target uses its declared Java toolchain.

export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
export PATH="$JAVA_HOME/bin:$PATH"
./scripts/ci/build-target.sh forge-1.20.1

The JAR is in platform/forge/1.20.1/build/libs/. Choose another target ID from release/targets.json. Use the remapped Fabric JAR in build/libs.

Development

License and credits

Code: LGPL-3.0. Lock icons drawn by F1xGOD: noncommercial use with credit.

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

About

A mod that securely verifies premium accounts on an offline-mode server during the login phase, without sending the player's access token to the server.

Resources

Stars

16 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages