PlayerDataPlus

Safely manage Minecraft player data — even while players are offline.

PlayerDataPlus is a lightweight Paper administration plugin that allows server owners and administrators to clear, copy, transfer, back up, and restore vanilla player data using a username or UUID.

It supports online, offline, premium, and offline-mode/cracked players while taking extra precautions to prevent player data from being accidentally overwritten.

---

✨ Features

• 🗑️ Clear complete player data
• 📋 Copy one player's data to another
• 🔄 Transfer player data and remove the original
• 💾 Create manual backups
• ♻️ Restore previous backups
• 🔍 Find players using usernames or UUIDs
• 📴 Manage offline players
• 🌐 Support offline-mode/cracked UUIDs
• 🛡️ Safely handle players who are currently online
• ⚠️ Confirmation required for destructive operations
• 💾 Automatic backups before modifications
• 🗃️ Configurable backup retention
• 🔐 Permission-controlled commands
• 📦 No external dependencies

---

🛡️ Safe Online Player Handling

Editing a player's files while they are online can cause Minecraft or Paper to overwrite your changes.

PlayerDataPlus automatically handles this safely.

When an affected player is online, the plugin will:

1. Save their current player data.
2. Disconnect them using a configurable message.
3. Temporarily prevent them from reconnecting.
4. Wait for their logout data to finish saving.
5. Create a backup and perform the requested operation.
6. Allow them to reconnect.

No manual kicking or server restart is required.

---

📁 Data Managed

PlayerDataPlus can manage:

• Inventory
• Armor
• Offhand items
• Ender chest
• Experience and levels
• Health
• Hunger
• Status effects
• Player location
• Dimension
• Bed/respawn location
• Player abilities
• Advancements
• Statistics
• .dat player files
• .dat_old fallback files
• Operator status when clearing a player

Note: PlayerDataPlus manages vanilla Minecraft player data. Data belonging to other plugins such as LuckPerms, Essentials, or inventory-management plugins is not modified.

Physical blocks placed by a player also cannot be automatically removed because vanilla Minecraft does not store which player originally placed each block.

---

💻 Commands

/playerdata info <player>
/playerdata backup <player>
/playerdata backups <player>

/playerdata clear <player> --confirm
/playerdata copy <source> <target> --confirm
/playerdata transfer <source> <target> --confirm
/playerdata restore <player> <backup-id> --confirm

/playerdata reload

Command Aliases

/pdata
/pdp

---

🔐 Permissions

playerdataplus.use
playerdataplus.backup
playerdataplus.modify
playerdataplus.reload

All permissions default to server operators.

---

📦 Requirements

• Minecraft: 1.21.11
• Server: Paper
• Java: 21
• Dependencies: None
• Client mod required: No

---

⚠️ Important

Although PlayerDataPlus automatically creates backups before destructive operations, keeping regular backups of your server is always recommended when modifying player data.

PlayerDataPlus only modifies the player selected in the command and does not modify unrelated player files.