Migration guide

Restore inventory after moving a server world to singleplayer

A world can load perfectly after moving from a server while your character appears empty. The world is usually fine; the player state is still stored in the server UUID file instead of the singleplayer Player compound.

Published 2026-08-098 min read

When a server world is opened in singleplayer, Minecraft may create a new local player identity. The terrain and world settings come across, but the old inventory, position, and Ender Chest remain under the server player's UUID file until you copy the relevant data into the singleplayer save.

Why the world loads but your player is empty

A dedicated server stores each player's state in <world>/playerdata/<uuid>.dat. A singleplayer save normally stores the active player under level.dat / Data / Player. Opening the same world folder does not automatically merge those two structures.

Find the server UUID file

  1. Make a copy of the original server world and the singleplayer copy.
  2. Look in the server world's playerdata folder for UUID-named .dat files.
  3. Match the username to a UUID using usercache.json from the server or a trusted account lookup.
  4. Open the matching playerdata file and confirm the position or inventory is the one you expect before copying anything.
Server player file
<server-world>/playerdata/<player-uuid>.dat

Understand the singleplayer Player compound

SourceUseful dataDestination in the singleplayer save
Server playerdata .datPos, Rotation, Dimension, Healthlevel.dat / Data / Player
Server playerdata .datInventory and SelectedItemSlotlevel.dat / Data / Player / Inventory
Server playerdata .datEnderItemslevel.dat / Data / Player / EnderItems

Copy only the data you need

  1. Back up the full singleplayer world folder and the original server playerdata file.
  2. Open the server UUID file and the singleplayer level.dat copy in separate editor tabs or windows.
  3. Copy only the compounds you intend to restore, such as Inventory, EnderItems, Pos, or Dimension.
  4. Preserve the singleplayer file's surrounding structure and export a separate edited level.dat copy.

Test in a duplicate world

  1. Rename the edited copy as a test save and leave the original singleplayer world alone.
  2. Load the test world and check inventory, Ender Chest, position, and dimension one at a time.
  3. If the player loads in an unsafe location, use a known safe Pos and Dimension from the backup rather than guessing.
  4. Keep the backup until you have closed and reopened the test world successfully.
Player state is UUID-based

Open a playerdata file

Inspect the server player's typed NBT tree before moving selected data into a singleplayer save.

Open the playerdata editor

If the old player data is already overwritten

Stop editing and look for a server backup, level.dat_old, a hosting snapshot, or an older copy of the playerdata folder. If no backup contains the old file, recovery may be limited to items or coordinates recorded elsewhere; do not assume the current empty file can recreate the old inventory.

Frequently asked questions

Does this also apply to a LAN world?

A LAN world hosted from singleplayer still uses the host's singleplayer Player compound. The dedicated-server playerdata workflow applies when the world was saved by a server with UUID-named player files.

Can I do this while players are online?

No. Only edit data for a server you administer, stop the server fully, and wait for all processes to release the world files before replacing anything.

Do I need both a world backup and a playerdata backup?

Yes. Keep a copy of the whole world and the original UUID file. A player-only backup is useful for comparison, but the whole-world copy is the safer rollback if metadata or region files are also changed.

Why did my Ender Chest not come back?

Ender Chest contents are stored in EnderItems inside the player data. Copy that compound deliberately, verify the tag type and list structure, and test on a duplicate world before using the live save.

Ready when your file is

Inspect the structure before you change it.

Open a supported Minecraft Java Edition file, stage edits, and export a separate copy without sending world data to a server.

Open the NBT editor