Keskin Auto Backup
Safe scheduled backups, protected shutdowns and automatic restarts for Paper & Purpur servers by keskinreal
✨ Comprehensive Features
- ✦ Automated Scheduler: Configurable intervals and initial startup delay for background backups.
- ✦ Complete Plugins Backup: Archives the full
plugins directory, including all plugin JARs and configuration folders.
- ✦ Smart World & Player Data Detection: Automatically discovers world folders via
level.dat, preserving player data, advancements, and statistics alongside essential server root files.
- ✦ Data Integrity & Save Protection: Triggers
save-all flush prior to archiving, with optional save-off protection while world files are being cloned.
- ✦ Shutdown Safeguard: Intercepts console/RCON
stop and restart. Cancels shutdown if the pre-shutdown backup fails (unless overridden in settings).
- ✦ Automated Restarts: Built-in configurable automatic restart intervals with broadcast countdown timers.
- ✦ Retention Limits: Automatically purges old backups based on maximum backup count or age thresholds.
- ✦ Compression & Checksums: Efficient ZIP compression with optional SHA-256 verification files.
- ✦ Locked-File Resilience: Safe per-file staging with Windows and active database retry mechanisms.
📌 Requirements
Java Environment: Java 21+
Server Core: Paper / Purpur 1.21.4+ API
⚡ Commands & Permissions
Aliases: /backupadmin, /kab | Permission: keskinautobackup.admin
/autobackup status
Displays scheduler status & next run time.
/autobackup now
Triggers an immediate background backup task.
/autobackup list [page]
Lists completed backups and file sizes.
/autobackup restart
Restarts the background backup scheduler.
/autobackup reload
Reloads plugin configuration files.
/autobackup license
Verifies release cryptographic authenticity.
📂 Storage Paths & Locked Files
Backup Storage Location:
Supports custom absolute or relative paths. When set to backup.path: AUTO, directories are generated automatically under:
<server folder>/backups/KeskinAutoBackup/
Locked-File Handling:
Retries files temporarily locked by Windows, databases, or active plugins. Files are fully staged before archive insertion to prevent corruption.
backup.fail-on-unreadable-file: false — Unreadable files are safely skipped and recorded in KeskinAutoBackup-skipped-files.txt inside the completed ZIP.backup.fail-on-unreadable-file: true — Strict mode; aborts backup if any locked file remains unreadable.
🌐 17 Native Languages Supported
English Turkish Spanish German French Portuguese Dutch Bulgarian Hindi Simplified Chinese Traditional Chinese Russian Italian Japanese Korean Polish Ukrainian
⚠️ Limitations & Security
Shutdown Interception Limits
Protection applies exclusively to commands received by the running server. No Bukkit plugin can intercept process crashes, OS kills, server panel "Kill/Terminate" actions, power loss, or SIGKILL.
Release Security
All builds feature offline, cryptographic Ed25519 release signatures by keskinreal to verify distribution integrity.
Developed with passion by keskinreal
