Minecraft Offline UUIDs: Why Player Data Resets
A server owner flips online-mode in server.properties, restarts, and every player logs in with an empty inventory. Nothing was deleted. The players now have different UUIDs, and their data is still sitting under the old ones.
Two kinds of player UUID
Every Java Edition account gets a permanent UUID when it is bought and registered. These are version 4 UUIDs, which means they are random, and they never change, even when the player changes their name.
When online-mode is false, the server cannot ask Mojang who a player is, so it makes up a UUID from the name alone. The Minecraft Wiki describes it as a version 3 UUID generated from the MD5 hash of OfflinePlayer:<username>. The player Steve always gets 5627dd98-e6be-3c21-b8a8-e92344183641 on every offline server, and you can compute any name with the offline UUID generator.
Why inventories vanish when online-mode changes
The world stores each player's data under their UUID: playerdata/<uuid>.dat for inventory and position, stats/<uuid>.json and advancements/<uuid>.json. whitelist.json, ops.json and banned-players.json use UUIDs too, and so do most plugins.
Switch online-mode from false to true, or the other way, and every player arrives with a UUID the server has never seen. The game creates fresh data for them. The old files are untouched, so nothing is lost as long as you do not delete them.
Offline UUIDs follow the exact name
Because the offline UUID is a hash of the name, the exact spelling matters. Steve and steve are different strings and get different UUIDs, and a player who renames their account becomes a new player on an offline server. Online UUIDs do not have this problem: they stay the same through name changes. The UUID lookup shows the real online UUID for any Java name.
Proxies: the one normal reason for offline mode
Networks running Velocity or BungeeCord set online-mode=false on the backend servers, because the proxy does the login check instead. The proxy then forwards each player's real UUID, IP address and skin to the backend. PaperMC's documentation recommends Velocity's modern forwarding, which signs the data so the backend cannot be fooled. It calls legacy BungeeCord forwarding fundamentally insecure unless the backend can only be reached through the proxy.
If forwarding is not set up, the backend falls back to offline UUIDs, and you get the vanishing-inventory problem across the whole network.
The risk of running offline without a proxy
The Minecraft Wiki is blunt about online-mode=false on a public server: anyone can connect under any name, including yours, because nothing is checked. That makes ops.json and name-based permissions meaningless. Keep online-mode=true on any server reachable from the internet, unless a proxy in front of it handles authentication. On a managed server host the setting is usually in the panel's server.properties editor, so check it there after any migration.
Moving player data to the right UUID
If you switched modes by mistake, switch back: the old data loads again. If you are moving a server from offline to online mode on purpose, rename each player's files from their offline UUID to their online UUID.
- Stop the server and back up the world folder.
- For each player, get the offline UUID from the offline UUID generator and the online UUID from the UUID lookup.
- In the world folder, rename playerdata/<offline>.dat, stats/<offline>.json and advancements/<offline>.json to the online UUID.
- Update whitelist.json and ops.json, or remove the entries and add the players again by name once online mode is on.
- Check each plugin's own storage. Economy, permissions and claims plugins usually key data by UUID and may need their own migration command.
- Start the server with online-mode=true and have one player log in to confirm before announcing the change.
Frequently asked questions
What is the offline UUID for a name?
The version 3 UUID of the MD5 hash of OfflinePlayer:<name>. The offline UUID generator calculates it in your browser.
Did switching online-mode delete my world?
No. Only the players changed UUIDs. Their old files are still in the world folder, and switching back loads them again.
Is offline mode the same as a cracked server?
Yes. The Minecraft Wiki calls a server running with online-mode off a cracked server, because it lets unlicensed copies join.
Do Bedrock players have these UUIDs?
No. Bedrock accounts are Xbox accounts, so the Java online and offline UUID rules above do not apply to them.
Sources
- Minecraft Wiki: Universally unique identifier
- Minecraft Wiki: server.properties
- PaperMC: Velocity player information forwarding