Java Edition recovery tool

Minecraft Player Data Editor

Open a Java player .dat file, inspect stored values, repair common problems, edit inventory and player stats, then download a verified replacement. Everything runs locally in your browser.

Your player data is never uploaded

Private browser workspace · no file upload

Player health check

Flags dead health values, invalid positions, unusual dimensions, and hunger outside its normal range.

Safe repair actions

Restore health and hunger, clear fire and fall damage, or lift a trapped player without rebuilding the file.

Verified saving

Preserves NBT types and gzip compression, then reparses the generated file before allowing download.

Private by design

Your player UUID, coordinates, inventory, and other server data stay entirely on your device.

Before editing

Use the playerdata file safely

Minecraft Java servers store one NBT file per player inside world/playerdata. The filename is the player's UUID. Stop the server before downloading or replacing this file; otherwise Minecraft may overwrite your changes with the copy still held in memory.

  1. 1Stop the Minecraft server completely.
  2. 2Download the correct UUID.dat file.
  3. 3Use Backup before changing risky values.
  4. 4Replace the server file and restart.

Singleplayer also stores its active player inside level.dat. This tool targets standalone server-style playerdata/UUID.dat files; use the full NBT editor for other file types.

What can you edit in a Minecraft player .dat file?

The guided dashboard covers common recovery work. The Advanced NBT tab exposes every scalar tag for less common server, mod, and datapack fields without flattening byte, integer, float, double, or long types.

Recovery

Health, hunger, saturation, fire ticks, fall distance, death timers, position, movement, rotation, and dimension.

Progress

Experience level, total XP, XP progress, score, selected hotbar slot, game mode, spawn data, and abilities.

Items and advanced data

Inventory, armor, offhand, Ender Chest items, recipes, attributes, effects, shoulder entities, and mod-added NBT.

Player recovery

How to fix corrupted player data

“Corrupted player data” can mean two different things: readable NBT containing a bad value, or a file whose gzip/NBT structure is physically damaged. Only the first kind can be safely edited.

1. Stop the server and make a backup

Do not edit a live player's file. Download UUID.dat from world/playerdata and keep an untouched copy before trying a repair.

2. Open the file and review warnings

If the file parses, the tool checks for dead or invalid health, impossible coordinates, below-world positions, abnormal hunger, and unusual dimensions.

3. Repair only the broken state

Move a player out of the void, restore health, clear fall damage, correct their dimension, remove a broken item, or use Advanced NBT for a specific modded tag.

4. Download, replace, and restart

The edited binary is reparsed before download. Replace the UUID.dat file while the server is still stopped, then start it and test the player's login.

If the editor reports an invalid compression stream or cannot parse the NBT root, do not keep modifying the damaged bytes. Restore the player from a recent backup. Deleting UUID.dat is a last resort because Minecraft creates a fresh player and loses their inventory, Ender Chest, position, XP, and other state.

Common offline player edits

These changes work without the player joining. Keep the server stopped until the edited file is back in the playerdata folder so the in-memory copy cannot overwrite it.

Give items to an offline player

Open Items, click an empty slot, and enter a namespaced ID such as minecraft:diamond_sword. Set a stack count from 1–64 and save. Existing slots can be changed to another item instead of deleted.

Edit Minecraft XP

Change XP level (XpLevel), total accumulated XP (XpTotal), and progress to the next level (XpP). XP progress is normally a decimal from 0 to just under 1.

Edit score and game mode

Set Score directly and choose Survival, Creative, Adventure, or Spectator from the game mode menu. The underlying playerGameType integer is preserved correctly.

Fix a stuck or crashing player

Correct Pos and Dimension, clear Fire and FallDistance, lift the player to Y=100, or remove a malformed inventory entry that crashes the client during login.

Restore health and hunger

Set Health and foodLevel to 20, adjust saturation, and clear damage timers. The guided repair action changes the related values together.

Edit an Ender Chest

Add, replace, or remove EnderItems in the same visual slot grid as the main inventory. The tool writes the item format appropriate for the file's DataVersion.

Teleport an offline player

Enter destination X, Y, and Z coordinates and select the correct dimension. This can rescue a player from a crash loop, unloaded mod dimension, void, or trapped portal.

Reset only part of playerdata

Clear inventory, reset XP, move the player, or restore their vitals without deleting UUID.dat and wiping every saved player field or mod capability.

Player data editor questions

Where is a Minecraft player .dat file?

For a Java server, open the main world folder and then playerdata. Each file is named with a player's UUID, for example world/playerdata/uuid.dat. Stop the server before downloading or replacing it.

Can this fix a player stuck in the void or a broken dimension?

Yes, when the file can still be parsed. You can change Pos, Dimension, FallDistance, Motion, Health, and related tags. The safe action can lift a player to Y=100 without changing their X, Z, or dimension.

Can I edit a player's inventory and Ender Chest?

Yes. Click an occupied slot to change its item ID, count, or slot. Click an empty slot or Add item to spawn a new stack directly into the player's inventory or Ender Chest. Modern and legacy item formats are written automatically.

Are player files uploaded to CraftMC?

No. Parsing, editing, validation, and saving happen locally in your browser. The .dat file is never sent to CraftMC or stored on a server.

Can every corrupted .dat file be repaired?

No. This tool can repair bad player values when the NBT structure and compression stream are readable. A truncated file or destroyed gzip stream may need restoration from a server backup.

How do I fix corrupted player data in Minecraft?

Stop the server, back up world/playerdata/UUID.dat, and open it here. If it parses, inspect warnings and repair bad position, dimension, health, inventory, or other NBT values. Download the verified file, replace the original while the server remains stopped, and restart. If the file cannot be parsed, restore a backup or reset that player's data.

How do I give items to an offline Minecraft player?

Open the offline player's UUID.dat file, choose Items, click an empty inventory slot, enter an item ID such as minecraft:diamond and a count, then save the edited file. Replace the server file before that player logs in.

How do I edit a player's XP level?

Change XP level for the displayed level, Total XP for the player's accumulated experience, and XP progress for progress toward the next level. These correspond to XpLevel, XpTotal, and XpP in player NBT.

Can I edit an offline player's score or game mode?

Yes. Score and playerGameType are editable in the Overview tab. Game mode values are presented as Survival, Creative, Adventure, and Spectator instead of requiring you to remember their numeric IDs.

How do I teleport an offline Minecraft player?

With the server stopped, open the player's UUID.dat file and change the X, Y, and Z coordinates under Location and rotation. Set Dimension to the destination dimension, save the file, replace it in world/playerdata, and restart the server.

How do I reset Minecraft player data without deleting everything?

Edit only the state that needs resetting. You can clear inventory or Ender Chest items, restore health, change position, reset XP, or change game mode while preserving other NBT and mod data. Deleting UUID.dat instead resets the whole player.

CraftMC

Your ultimate resource for Minecraft tools and guides.

CraftMC's tools are free to use. If the site has helped you, you can support its hosting and continued development.

Support CraftMC
Professional ToolsExpert GuidesActive Support

Popular Tools

Quick Links

Also from us

We also run a Fortnite tools site — free calculators, weapon guides, map drops, and season helpers.

Visit FortniteTools.com

© 2026 CraftMC. All rights reserved. Also check out our Fortnite tools site.