DataGuard

Never Lose Your Progress Again.

DataGuard is a PaperMC survival plugin built to solve one of the most frustrating problems on multiplayer servers — data rollbacks. Whether your server crashes, restores a backup from the wrong date, or something just goes wrong behind the scenes, DataGuard makes sure your players' hard-earned progress is always recoverable.

---

🛡️ What It Does

DataGuard automatically takes snapshots of player and server data at key moments — every time a player joins, every time they leave, and every 30 minutes while they're online. Each snapshot captures everything that matters:

• Inventory contents
• Armor & offhand item
• Ender chest contents
• XP level & progress
• Health & hunger
• Active potion effects
• Player location
• Game mode

No databases, no external software. Everything is saved directly to your server's file system in an organized, human-readable format.

---

⚙️ How It Works

Every player gets their own snapshot folder, organized by timestamp. Server-wide snapshots capture all online players at once along with server metadata like world time and player count. Old snapshots are automatically pruned based on limits you configure, so your disk never gets out of hand.

Admins have full control — they can manually create, delete, and load any snapshot at any time using simple commands. Players have limited but useful control over their own data, able to create and delete their own snapshots and toggle their own auto-saving.

---

🔒 Anti-Abuse by Design

Members cannot use /data load — this is intentional. Allowing players to restore their own data on demand would open the door to item duplication exploits. For example, a player could drop Netherite gear on the ground, load an old snapshot to get it back in their inventory, then pick up the gear they dropped — duplicating it for free. Only server staff with the dataguard.admin permission can restore data.

---

📋 Commands

Admin / OP

• /data server create [label] — Take a full server snapshot
• /data server delete <label> — Delete a server snapshot
• /data server automatic <true/false> — Toggle server-wide auto-saving
• /data player create [player] [label] — Snapshot a specific player
• /data player delete <player> <label> — Delete a player's snapshot
• /data load player <player> <snapshot> — Restore a player's data
• /data load server <snapshot> — Restore all online players from a server snapshot
• /data list server — View all server snapshots
• /data reload — Reload the config live

Members

• /data player create [label] — Save your own data manually
• /data player delete <label> — Delete one of your own snapshots
• /data automatic <true/false> — Toggle your personal auto-saving
• /data list player — View your own snapshots

---

🔧 Configuration

Everything is tunable in config.yml:

• Auto-save interval (default: 30 minutes)
• Max snapshots per player before old ones are pruned
• Max server snapshots to keep
• All plugin messages and the chat prefix

---

📌 Requirements

• Server: PaperMC 1.21.11
• Java: 21+
• No dependencies, no external plugins required.