Fast Async Backups

World Backup

Простые и надёжные бэкапы мира по нажатию клавиши — или по вводу команды.

Когда-нибудь мир ломался из-за кривого мода, отключения электричества или просто неудачного решения в WorldEdit? World Backup позволяет создавать мгновенные сжатые zip-бэкапы всей папки мира одной командой. Бэкапы выполняются асинхронно, так что сервер никогда не зависает, а автоматическая ротация не даёт диску забиться.

✨ Возможности

• Мгновенные бэкапы — создаёт полный .zip-бэкап мира командой `/backup `
• Без блокировок — бэкапы выполняются в отдельном потоке; сервер остаётся отзывчивым
• Автоматическая ротация — старые бэкапы удаляются автоматически по настраиваемому лимиту
• Настраиваемость — лимит бэкапов задаётся командой или через JSON-конфиг
• Безопасность по умолчанию — проверка имени защищает от path traversal-атак
• Дружелюбность к конфликтам — сначала копирует мир во временную папку, а затем архивирует чистую копию. Файлы, заблокированные другими модами (Sable и т. п.), автоматически повторяются с увеличивающейся задержкой.
• Оповещение всего сервера — все игроки видят сообщения о ходе и завершении бэкапа

📋 Команды

Примеры:

/backup before-portal          →  before-portal_2025-06-03_21-30-00.zip
/backup vanilla-test           →  vanilla-test_2025-06-03_21-31-15.zip
/backuplimit 25                →  Устанавливает лимит ротации в 25 бэкапов

По умолчанию эти команды доступны всем игрокам — права оператора не нужны.

⚙️ Конфигурация

Лимит бэкапов хранится в backup/backup_config.json в папке сервера. Файл создаётся автоматически при первом использовании, и его можно редактировать напрямую:

{
  "backupLimit": 10
}

Лимит также можно изменить прямо в игре командой `/backuplimit `.

📁 Где хранятся бэкапы?

Бэкапы сохраняются в папку backup/ внутри папки сервера (рядом с папками миров). Каждый бэкап — это сжатый .zip-файл с именем в формате:

<name>_<YYYY-MM-DD_HH-mm-ss>.zip

🔄 Совместимость

World Backup создан для мирного сосуществования с другими модами:

• Sable — полностью совместим. Файлы мира копируются во временную папку перед архивацией, поэтому блокировки файлов Sable не мешают. Повтор до 5 раз с увеличивающейся задержкой.
• Ice and Fire, Dread Land и другие моды с измерениями — все подуровни и кастомные измерения попадают в бэкап.
• Любой мод, блокирующий файлы — стратегия «сначала копирование» вместе с логикой повторов обрабатывает файлы, заблокированные другими модами, без пропуска данных.
• Любой тип мира — работает с ванильными, модовыми и кастомными форматами миров.

🛠 Технические детали

• Стратегия «сначала копирование» — папка мира копируется во временную директорию через Files.copy (path-to-path), что в Windows использует API CopyFileEx для обработки заблокированных файлов
• Перед копированием все чанки сбрасываются на диск (saveAllChunks)
• Асинхронное выполнение через CompletableFuture — без лагов серверного тика
• Автоматический повтор с задержкой (до 5 попыток) для временно заблокированных файлов
• Временная директория автоматически очищается после завершения бэкапа (даже при ошибке)
• Ротация бэкапов удаляет самые старые файлы первыми по времени изменения
• Безопасная проверка имён файлов: допускаются только буквы, цифры, дефисы и подчёркивания

📦 Установка

1. Установите NeoForge для Minecraft 1.21.1+
2. Поместите worldbackup-1.0.0.jar в папку mods/
3. Запустите сервер — бэкапы готовы к работе

Настройка не требуется — просто введи /backup my-backup, и всё готово.