Just Enough Backups (JEB)

Мод для Майнкрафт на Fabric, который создаёт резервные копии миров на сервере и позволяет управлять ими из игры. Подходит для сохранения мира по расписанию, ручного создания копий и безопасного восстановления после проблем.

Возможности

• Создаёт полные, частичные и дифференциальные копии мира.
• Запускает резервное копирование вручную, по отдельному расписанию для каждого типа, при запуске или остановке сервера.
• Может предупреждать игроков о начале операции в чате или строке действий.
• Хранит заданное число свежих копий каждого типа и ограничивает общий размер папки с копиями для каждого мира. Связанные базовые копии не удаляются, пока они нужны частичным или дифференциальным копиям.
• В браузере резервных копий можно обновлять список, создавать, переименовывать, удалять, искать и восстанавливать копии, а также смотреть их зависимости.
• Использует несколько потоков для сканирования мира, сжатия и распаковки больших копий.
• Показывает настраиваемое уведомление на экране; его положение и вид можно проверить в предпросмотре.

Как пользоваться

Основная команда — /jeb.

• /jeb now — создать резервную копию.
• /jeb now <name> — создать копию с указанным именем.
• /jeb create full <name> — создать полную копию.
• /jeb create partial <name> — создать частичную копию.
• /jeb create differential <name> — создать дифференциальную копию.
• /jeb list — открыть список копий.
• /jeb next — показать время до следующих запланированных копий.
• /jeb restore <backup> — подготовить восстановление выбранной копии. После подготовки сервер выключится, а восстановление применится при следующем запуске.
• /jeb config reload — перечитать конфигурацию.

Параметр <name> необязателен и становится именем ZIP-файла. В качестве <backup> указывается видимое имя копии, с расширением .zip или без него.

По умолчанию клавиша B открывает управление копиями, а N — экран настроек. Их можно изменить в настройках управления Майнкрафт. Доступ к командам определяется уровнем прав из конфигурации.

Настройки

Файл настроек: config/justenoughbackups.json.

Основные параметры:

• backupMode, automaticBackupsEnabled, automaticIntervalMinutes — режим и расписание автоматических копий;
• pauseAutomaticBackupsWithoutPlayers, backupOnServerStart, backupOnServerStop — условия запуска;
• commandPermissionLevel — уровень прав для команд;
• retention с full, incremental, differential, maxTotalSizeMb — правила хранения;
• threadCount — число потоков от 1 до количества потоков процессора;
• backupDirectory и tempBackupDirectory — папки готовых и временных копий;
• excludedPaths — пути внутри папки мира, которые не попадут в копию;
• popup — текст, цвета, каналы и расположение экранного уведомления.

Путь tempBackupDirectory удобен для временного сжатия на локальном диске, если готовые копии хранятся на медленном или сетевом накопителе. В excludedPaths папка исключает всё своё содержимое, а файл — только указанный файл; например: voxy или voxy/cache.db.

Перед созданием копии мод проверяет свободное место на диске назначения. Нужно не меньше размера текущего мира, умноженного на два, плюс значение minimumFreeSpaceReserveMb.

На выделенном сервере через игровой экран доступны только локальные настройки уведомления и предпросмотр. Серверные параметры меняются в config/justenoughbackups.json, затем применяется команда /jeb config reload.

Требования и совместимость

Работает на Fabric. Интеграция с Mod Menu необязательна.