PotatoSack (Потатосак)

Плагин для серверов Майнкрафт, который создаёт резервные копии указанных папок и отправляет их в облачное хранилище. Подходит для серверов с небольшим запасом места на диске: архив можно сжимать и загружать по частям без сохранения целого ZIP-файла локально.

Возможности

• Создаёт полные и инкрементальные резервные копии.
• Инкрементальные копии сохраняют только изменённые чанки в файлах регионов .mca, уменьшая размер архива.
• Работает с OneDrive, Dropbox, AWS S3 и совместимыми S3-хранилищами, включая MinIO, Cloudflare R2, Wasabi и QCloud COS.
• Хранит полную копию и следующие за ней инкрементальные копии как одну группу. При удалении полной копии удаляется и вся её группа.
• Утилита BackupsMerger объединяет полную и инкрементальные копии группы в один комплект данных для восстановления.

Команды

• /potatosack reload — перечитывает файл настроек без перезапуска сервера.

Права

• potatosack.reload — разрешает использовать /potatosack reload; выдаётся операторам сервера.

Настройка

Основной файл находится по пути plugins/PotatoSack/configs.yml.

• В client.use выберите хранилище: onedrive, dropbox или s3.
• client.base-dir задаёт папку для резервных копий в облаке.
• В paths перечислите папки для копирования относительно корневой папки сервера, например world, world_nether или plugins/GroupManager. Пути не должны пересекаться и не могут указывать на саму корневую папку сервера.
• cron.full-backup и cron.incremental-backup задают расписание полных и инкрементальных копий в формате UNIX Cron.
• max-full-backups-retained определяет число сохраняемых групп резервных копий.
• stop-incremental-backup-when-no-player и stop-full-backup-when-no-player позволяют пропускать копирование при отсутствии игроков.
• use-streaming-compression-upload включает одновременное сжатие и отправку архива; это снижает потребность в свободном месте на диске.

Для исключения файлов создайте .potatosackignore в корневой папке сервера. Правила похожи на .gitignore: поддерживаются *, ?, **, комментарии с # и привязка к корню через /; исключения правил с ! не поддерживаются.

В OneDrive резервные копии размещаются в папке приложения либо в корне хранилища — это задаётся параметром client.onedrive.use-app-folder. В Dropbox и S3 путь определяется client.base-dir; для S3 также указываются endpoint, region, bucket, access-key, secret-key и при необходимости session-token.

Требования

Для OneDrive нужны client-id, client-secret и refresh-token. Для Dropbox требуются app-key, app-secret и refresh-token с правами на чтение метаданных и работу с файлами. Для S3 у учётной записи хранилища должны быть разрешения s3:ListBucket, s3:GetObject, s3:PutObject, s3:AbortMultipartUpload и s3:DeleteObject.