UnifiedInventory

One inventory. Every server.

Sync player inventories, stats and more across multiple servers — powered by MySQL, configured in a single config.yml.

---

✨ Features

Feature	Description
Inventory Sync	Main inventory, hotbar, armor & offhand — all synced
Ender Chest Sync	Ender chest contents follow the player
Stats Sync	Health, hunger, saturation & XP level/progress
Gamemode Sync	Optional — toggle per config
Backup System	Keep the last X saves per player, restore via command
Admin Commands	Sync, reset, copy, inspect & restore backups
PlaceholderAPI	20 built-in placeholders
Per-feature toggles	Enable/disable each sync component individually

---

📦 Requirements

• Paper 1.21+ (up to 1.26.x)
• MySQL / MariaDB — required
• PlaceholderAPI — optional

---

🛠️ Commands

Command	Description
/uinv sync <player>	Force sync a player
/uinv reset <player>	Clear a player's inventory
/uinv copy <from> <to>	Copy inventory between players
/uinv inspect <player>	Open a player's inventory live
/uinv backup <player> list	List saved backups
/uinv backup <player> restore [index]	Restore a backup
/uinv reload	Reload config

---

🔑 Permissions

Permission	Description	Default
unifiedinventory.sync	Player's inventory is synced	true
unifiedinventory.bypass	Player is excluded from sync	false
unifiedinventory.admin	Access to all admin commands	OP

---

📊 PlaceholderAPI Placeholders

Placeholder	Description
%uinv_synced%	Is the player being synced
%uinv_inventory_items%	Items in main inventory
%uinv_enderchest_items%	Items in ender chest
%uinv_xp_level%	XP level
%uinv_health%	Current health
%uinv_health_percent%	Health as percentage
%uinv_food_level%	Food level
%uinv_food_percent%	Food as percentage
%uinv_saturation%	Saturation value
%uinv_gamemode%	Current gamemode
%uinv_last_save%	Last save timestamp
%uinv_last_save_ago%	Seconds since last save
%uinv_has_bypass%	Has bypass permission
%uinv_inventory_full%	Is inventory full
%uinv_empty_slots%	Empty inventory slots
%uinv_armor_pieces%	Armor pieces equipped
%uinv_has_offhand%	Has offhand item
%uinv_max_health%	Max health
%uinv_food_percent%	Food as percentage
%uinv_backup_count%	Backups in cache

---

⚙️ Configuration

mysql:
  host: "localhost"
  port: 3306
  database: "unifiedinventory"
  username: "root"
  password: "yourpassword"

sync:
  inventory: true
  armor: true
  offhand: true
  enderchest: true
  xp: true
  health: true
  hunger: true
  gamemode: false
  join-delay-ticks: 0

backup:
  max-saves: 5

---

👥 Credits

LucasTHCR	Author & developer

Discord: dc.gg/paperstream