Minecraft

How to Edit Player Data on a Minecraft Server

Change a player's position, inventory or stats by editing their player data file in the panel's NBT editor.

Updated 1 min read

Each player's data (position, inventory, health, experience) is saved in a file named after their UUID, in world/playerdata. The panel can open these files in an NBT editor.

Warning

Create a backup in Backups first. A broken player file can reset that player.

Find the player's file

Files are named after the player's UUID, not their name. To find it:

  • run whitelist add <name> and look at whitelist.json in Files; or
  • look the name up on a site such as namemc.com.

Edit it

  1. Make sure the player is offline. The server saves their data when they leave, which would undo your edit. Stopping the server is safest.
  2. Go to Files and open world/playerdata.
  3. Click <uuid>.dat. It opens in the NBT editor.
  4. Use Search NBT tags to find what you need, change it, and save.
  5. Start the server (if you stopped it) and have the player join.

Useful tags

Tag What it is
Pos Position: X, Y, Z
Dimension Which dimension they're in, e.g. minecraft:overworld
Inventory Their items, one entry per slot
Health, foodLevel Health and hunger
XpLevel Experience level
playerGameType Game mode (0 survival, 1 creative, 2 adventure, 3 spectator)

Tip

To move a player stuck somewhere they can't escape, change Pos to safe coordinates and Dimension to minecraft:overworld.

To reset a player completely, see How to Reset Player Data.

Still stuck?

Ask the community on Discord, or open a ticket and we'll reply within 4 hours on business days.