AutoSavePlayer

# 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 *