AutoSavePlayer

🎒 AutoSavePlayer is a Spigot/Bukkit plugin that automatically saves player inventories and allows quick restoration via a GUI.

✨ Why this plugin?

• ⚡ Restore a lost inventory in just a few clicks
• 🧹 Keep a clean history with a backup retention limit (last 10 days)
• 🎛️ Control backups globally or individually
• 📝 Clear logs for admin actions

⏱️ How Backups Work (V4)

Active in-game backups are triggered by real-time intervals (server time), then applied to players who are online at that specific time.

Active Snapshots (with triggers)

• 1h -> every hour (xx:00)
• 30min -> every 30 minutes (xx:00 and xx:30)
• 5min -> every 5 minutes
• Retention: kept as long as the day belongs to the last 10 backed-up days

Daily Snapshots (created upon logout)

• 1day -> 1 backup/day (the most recent one of the day)
• 2day -> 2 backups/day (spread across the day)
• 4day -> 4 backups/day (spread across the day)
• Retention: max 10 login days (not 10 calendar days, but the last 10 days the player actually logged in)

📌 Important

• ✅ All active backups (5min/30min/1h) only occur if the player is online.
• ✅ Daily snapshots (1day/2day/4day) are created automatically when the player logs out.
• ✅ The 10 days are 10 backed-up days: when an 11th day arrives, the oldest one is deleted.
• ✅ Deleting a day removes all of its backups (1day, 2day, 4day, 1h, 30min, 5min).
• ✅ The GUI is paginated to view any backup from a specific day (useful for 5min/30min/1h).
• ⛔ If the server is offline, no backups can be performed.
• 📂 Backups are stored as .dat files.

🧰 Restoration

Admin command:

• /restore-inv
  • Opens a GUI listing online players
  • Select the day (last 10 available days)
  • Select the backup type (1/day, 2/day, 4/day, 1h, 30min, 5min)
  • Select the dated backup (with pagination if > 45 snapshots)
• /restore-inv <player>
  • Directly opens the GUI for the target player (day selection → type)

🛡️ Admin Management

• /asp -> opens the language GUI
• /asp players -> opens the backup management GUI per player (enable/disable)
• /asp start -> enables global backups
• /asp stop -> disables global backups
• /asp fr|en|all -> changes the language (all = German)

🔑 Permissions

• autosaveplayer.restore
• autosaveplayer.language
• autosaveplayer.admin

📜 Logs

• Restoration logs: plugins/AutoSavePlayer/plugin-logs/plugin-logs.log
• Disabled players configuration: plugins/AutoSavePlayer/player-controls.yml

🚀 Installation

1. Place the .jar file into your server's plugins/ directory.
2. Restart the server.
3. Configure admin permissions using your permission manager.
4. Use /asp and /restore-inv in-game.

---

💬 v4: restoration by day + multiple types + pagination for hourly/minute backups.

AutoSavePlayer - Version française

🎒 AutoSavePlayer est un plugin Spigot/Bukkit qui sauvegarde automatiquement les inventaires des joueurs et permet une restauration rapide via GUI.

✨ Pourquoi ce plugin ?

• ⚡ Restaurer un inventaire perdu en quelques clics
• 🧹 Garder un historique propre et limite des sauvegardes (10 derniers jours)
• 🎛️ Controler globalement ou individuellement les sauvegardes
• 📝 Avoir des logs clairs pour les actions admin

⏱️ Fonctionnement des sauvegardes (V4)

Les sauvegardes actives en jeu sont declenchees par creneaux horaires reels (heure serveur), puis appliquees aux joueurs connectes au moment du creneau.

Snapshots actifs (avec triggers)

• 1h -> toutes les heures (xx:00)
• 30min -> toutes les 30 minutes (xx:00 et xx:30)
• 5min -> toutes les 5 minutes
• Rétention : conservées tant que le jour fait partie des 10 derniers jours sauvegardés

Snapshots journaliers (créés à la déconnexion)

• 1day -> 1 sauvegarde/jour (la plus récente du jour)
• 2day -> 2 sauvegardes/jour (réparties sur le jour)
• 4day -> 4 sauvegardes/jour (réparties sur le jour)
• Rétention : 10 jours de connexion max (pas 10 jours calendaires, mais 10 derniers jours où le joueur s'est connecté)

📌 Important

• ✅ Toutes les sauvegardes actives (5min/30min/1h) ne se font que si le joueur est connecte.
• ✅ Les snapshots journaliers (1day/2day/4day) sont créés automatiquement à la déconnexion du joueur.
• ✅ Les 10 jours sont 10 jours sauvegardés : quand un 11e jour arrive, le plus ancien est supprimé.
• ✅ La suppression d'un jour retire toutes ses sauvegardes (1day, 2day, 4day, 1h, 30min, 5min).
• ✅ Le GUI est paginé pour consulter n'importe quelle sauvegarde d'un jour (utile pour 5min/30min/1h).
• ⛔ Si le serveur est eteint, aucune sauvegarde ne peut se faire.
• 📂 Les sauvegardes sont stockees en .dat.

🧰 Restauration

Commande admin:

• /restore-inv
  • Ouvre un GUI avec les joueurs connectes
  • Sélection du jour (10 derniers jours disponibles)
  • Sélection du type de sauvegarde (1/jour, 2/jour, 4/jour, 1h, 30min, 5min)
  • Sélection de la sauvegarde datée (avec pagination si > 45 snapshots)
• /restore-inv <player>
  • Ouvre directement le GUI du joueur cible (sélection jour → type)

🛡️ Gestion admin

• /asp -> ouvre le GUI de langue
• /asp players -> ouvre le GUI de gestion des sauvegardes par joueur (activation/desactivation)
• /asp start -> active les sauvegardes globales
• /asp stop -> desactive les sauvegardes globales
• /asp fr|en|all -> change la langue (all = allemand)

🔑 Permissions

• autosaveplayer.restore
• autosaveplayer.language
• autosaveplayer.admin

📜 Logs

• Logs restoration: plugins/AutoSavePlayer/plugin-logs/plugin-logs.log
• Configuration des joueurs desactives: plugins/AutoSavePlayer/player-controls.yml

🚀 Installation

1. Place le fichier .jar dans le dossier plugins/ de ton serveur.
2. Redemarre le serveur.
3. Configure les permissions admin selon ton gestionnaire de permissions.
4. Utilise /asp et /restore-inv en jeu.

---

💬 v4 : restauration par jour + types multiples + pagination pour les sauvegardes horaires/minutaires.