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