If you’ve run a Minecraft server for any length of time, you’ve probably run into a situation where you need to clear out old or corrupted player files. Maybe you have dozens of inactive users taking up storage, a player’s inventory is glitched beyond repair, or you’re prepping for a fresh server season. Knowing how to delete player data on a Minecraft server correctly saves you from accidentally corrupting your world or losing important progress for active players. This guide walks you through every step, from pre-deletion checks to avoiding common mistakes that trip up new server admins.
Prep Steps Before You Delete Player Data on Your Minecraft Server
Jumping straight into deleting files is the easiest way to make a mistake you’ll regret later. Take 10 minutes to complete these prep steps first, no matter how small the task seems. First, never edit server files while the server is running. Even if you think the server is idle, it could run an autosave mid-deletion, which either restores the file you just removed or corrupts your entire world folder. Shut the server down completely, and wait 2 minutes after the shutdown confirmation to make sure all processes have closed.
Next, create a full backup of your entire world folder. You can save this to your local computer or a separate cloud storage folder, just make sure it’s separate from your active server files. If you accidentally delete the wrong player’s data, you can restore their file in 2 minutes flat, no awkward apologies required. Finally, track down the correct UUID for any player whose data you plan to delete. Minecraft stopped using usernames as file identifiers years ago, so looking for a file named “Notch.dat” won’t work. You can find a player’s UUID using a free online lookup tool, or by checking the usercache.json file in your main server directory, which lists every player who has ever joined your server alongside their UUID.
Step-by-Step Process to Remove Individual Player Data
Once you’ve completed your prep steps, deleting individual player data only takes a few minutes. First, open your server’s file directory, either through your hosting provider’s file manager or an FTP client if you’re self-hosting. Navigate to your active world folder, which is usually named “world” by default unless you changed it during setup.
Inside the world folder, you’ll see three subfolders that store player-specific data: playerdata, stats, and advancements. The playerdata folder holds .dat files with each player’s inventory, location, health, hunger, and other core game data. The stats folder has JSON files with playtime, blocks mined, mobs killed, and other gameplay statistics. The advancements folder stores progress for in-game achievements and advancement trees. Confirm no pending autosaves are running before you make any changes, even if the server is shut down, some hosting panels have delayed save processes.
To fully wipe a single player’s data, delete the file matching their UUID from all three folders. If you only want to reset their inventory and location but keep their stats and advancements, you only need to delete the file from the playerdata folder. Once you’ve deleted the relevant files, restart your server. To test if the process worked, ask the player to log in – they should spawn at the world spawn point with a fresh inventory, as if they’re joining the server for the first time. If you run a modded server, keep in mind that some mods store extra player data, like claim permissions or team info, in separate mod-specific folders. You’ll need to delete those files as well if you want a complete reset for the player.
How to Wipe All Player Data From Your Minecraft Server At Once
Sometimes you don’t need to delete just one player’s data – you need to wipe every player’s progress to start fresh. This is common when you’re launching a new server season, switching from vanilla to modded, or fixing widespread corruption that affects dozens of players. The process is similar to deleting individual files, but there are a few extra considerations to keep in mind.
Only do this if you want every player to start fresh – there’s no way to undo a full wipe unless you have a complete backup. Before you run a full wipe on a public server, you should announce the change at least 7 to 14 days in advance. That gives active players time to save screenshots of their builds, move important items to a separate storage area, or make other arrangements before their progress is erased.
There are a few common scenarios where a full player data wipe is the best solution:
- You’re launching a new server season with a fresh world and updated rules
- Your server experienced a widespread data corruption glitch affecting multiple players
- You’re switching server types (from vanilla to modded, or vice versa) and old player data causes compatibility crashes
- You want to clear inactive player data that’s taking up unnecessary storage space after 6+ months of no logins
To run the wipe, shut down your server, create a backup, then delete the entire playerdata, stats, and advancements folders. The server will automatically generate new, empty versions of these folders when you restart it. If you don’t want to wipe active players’ data, you can sort the files in the playerdata folder by last modified date, and delete only the files that haven’t been accessed in 6 months or more. This is a great way to free up storage without punishing players who log in regularly.
Common Mistakes to Avoid When Deleting Minecraft Player Data
Even experienced server admins make mistakes when managing player data, but most issues are completely avoidable if you know what to look for. The most common mistake is editing files while the server is running, which we already mentioned, but it’s worth repeating. I made this mistake on my first small survival server years ago, and I ended up corrupting the entire world folder, losing 3 months of progress for 20 active players. I’ve never skipped shutting down the server first since then.
Another common mistake is using usernames instead of UUIDs to find player files. Many new admins don’t realize that Minecraft uses UUIDs specifically because players can change their usernames whenever they want. If you look for a file named “Alex.dat” you might be deleting the data of a player who changed their username to Alex last week, not the inactive player you’re trying to remove. Always double check the UUID before you delete anything.
You also don’t want to forget to delete associated stats and advancements files if you’re doing a full reset for a player. If you only delete the playerdata .dat file, the player will still have all their old stats and achievements when they log back in, which can break immersion if you’re running a roleplay server or starting a new season. Finally, don’t skip creating a backup, even if you’re 100% sure you’re deleting the right files. It only takes a minute to save a copy of your world folder, and it’s the only safety net you have if something goes wrong.
Managing player data is one of the most routine parts of running a Minecraft server, and it doesn’t have to be stressful. As long as you take the time to back up your files, shut down the server before making changes, and double check UUIDs, you can avoid almost all common issues. Whether you’re clearing out one corrupted file or prepping for a full server reset, the steps we covered here will help you learn how to delete player data on a Minecraft server safely, with no lost progress or corrupted worlds. Next time you need to clear old player files, you’ll be able to get it done in minutes, no guesswork required.