Chronos Backups

Мод Chronos Backups для Minecraft — создание компактных резервных копий миров

Chronos Backups — это утилита для создания резервных копий миров в Minecraft, которая работает на множестве загрузчиков (Fabric, NeoForge, Bukkit, Spigot, Paper, Purpur, Folia) и версий игры. Основная цель проекта — минимизировать размер создаваемых архивов, сохраняя только критически важные данные. Инструмент использует алгоритмы обрезки (pruning) старых чанков и фильтрации данных от сторонних модов, таких как Distant Horizons и Voxy. Это позволяет сократить размер бэкапа до 1–15% от оригинального размера мира, а при полной фильтрации — до менее чем 7%.

Принцип работы и экономия места

В отличие от традиционных инструментов, которые создают точные копии файлов мира, Chronos Backups работает по принципу умной фильтрации. Программа анализирует данные мира и оставляет в резервной копии только те части, которые считаются важными. Это достигается за счет исключения старых чанков, которые не менялись давно, а также данных, генерируемых модификациями для оптимизации рендеринга, если они не являются частью основного мира. Такой подход позволяет создавать архивы, занимающие на порядок меньше места на диске, что критически важно для серверов с большими мирами.

📊 Результаты тестирования производительности

Разработчик провел серию тестов на сервере с процессором AMD Ryzen 7 9800X3D и SSD Samsung 970 EVO Plus. В среднем скорость создания бэкапа составляла около 10–15 МБ в секунду для крупных миров. Результаты показали впечатляющую эффективность алгоритма: для мира размером 4,8 ГБ итоговый размер бэкапа составил всего 46,5 МБ (менее 1% от оригинала). Даже при сохранении данных от модов Distant Horizons и Voxy размер архива не превышал 7% от полного объема на диске. Время выполнения бэкапа для крупного мира заняло около 11 секунд.

🛠 Управление и команды

Утилита предоставляет набор команд для управления процессами резервного копирования. Основная команда /chronos backup запускает создание бэкапа немедленно. Если процесс запущен, его можно остановить командой /chronos cancel. Для диагностики и оценки скорости работы системы предусмотрен режим тестирования /chronos speedtest, который выполняет несколько быстрых бэкапов подряд. По умолчанию для выполнения этих команд требуется уровень прав 4. Все команды работают из игрового чата или консоли сервера.

☁️ Синхронизация с облаком (Cloud Sync)

Chronos Backups поддерживает автоматическую загрузку готовых резервных копий в облачные хранилища. После успешной загрузки на сервере можно настроить автоматическое удаление локальной копии файла, чтобы экономить место на диске. Поддерживается интеграция с Google Drive через OAuth. Для настройки необходимо включить параметр googleDriveEnabled в конфигурации, после чего в консоли появится ссылка для авторизации. Токены доступа хранятся локально в папке google-drive-tokens. Если сервер работает в безголовочном режиме (headless), токены можно скопировать с локальной машины на сервер вручную. Система также поддерживает ограничение количества сохраняемых копий (maxStoredBackups), автоматически удаляя старые версии как локально, так и в облаке.

⚠️ Ограничения и нюансы восстановления

Главное ограничение метода — приоритет старых данных. Алгоритм обрезки (pruning) учитывает возраст чанка, то есть время, прошедшее с момента его последней модификации. Если игрок создает новый чанк, меняет блоки или предметы, а бэкап запускается до того, как этот чанк успеет «постареть», изменения могут не попасть в архив. В документации это описывается как крайне редкий сценарий, который может привести к потере данных при восстановлении, но никогда не вызывает их дублирования. Для минимизации рисков рекомендуется настраивать интервал между бэкапами (backupIntervalSeconds) в соответствии с динамикой изменений в мире.

Параметры сжатия и хранения

В конфигурации можно выбрать метод сжатия архивов. Доступны два варианта: сжатие в ZIP-архив для компактности или сохранение как несжатая папка для максимальной скорости доступа. Параметр shouldKeepLocalBackups определяет судьбу локальных копий после загрузки в облако: если установлено true, файлы остаются на сервере, если false — удаляются сразу после успешной передачи. Рекомендуется устанавливать значение maxStoredBackups не ниже 3, чтобы избежать риска потери данных при критических сбоях, но при необходимости можно снизить до 1 для экономии места.

🔧 Технические детали и архитектура

Мод написан с использованием Rust для ядра обработки данных (библиотека rust_pruner), что обеспечивает высокую производительность и безопасность при работе с файлами. В архиве присутствуют нативные библиотеки для различных операционных систем: Linux (x86_64 и aarch64), macOS (aarch64) и Windows (x86_64 и aarch64). Это позволяет утилите работать на большинстве современных серверов без необходимости компиляции. Файл архива весит около 9 МБ, но распаковывается до 20 МБ из-за наличия нативных компонентов.

📅 Выпуск nightly-сборок

Помимо стабильных релизов, доступных на Modrinth и CurseForge, разработчик предоставляет nightly-сборки через GitHub Actions. Эти сборки создаются автоматически каждый день и загружаются на страницу релизов GitHub. Важно понимать, что nightly-сборки не являются стабильными и могут содержать ошибки или быть несовместимыми с другими модами. Их следует использовать только для тестирования новых функций или если стабильная версия не поддерживает вашу версию игры. Стабильные версии всегда проходят более тщательную проверку перед публикацией.

Сравнительная таблица производительности

⚙️ Настройка конфигурации

Настройки мода хранятся в файле config/chronos.toml, который создается автоматически при первом запуске. Интерфейс с графическим управлением отсутствует. Ключевые параметры включают backupFolderName (имя папки с бэкапами), pruneChunks (включение обрезки чанков), pruneTimeRequirementSeconds (минимальное время жизни чанка для его сохранения) и pruneMaxWorkerThreads (максимум потоков для обработки). Для автоматизации доступны scheduleBackups и backupIntervalSeconds. Параметр compressionMethod выбирает между ZIP-архивами и несжатой папкой. Важно помнить, что maxStoredBackups ограничивает количество копий как локально, так и в облаке; значения ниже 3 увеличивают риск потери данных при сбоях.

⚠️ Важное предупреждение

Chronos Backups не предназначен для создания точных снимков состояния мира в конкретный момент времени. Он оптимизирован для экономии места за счет удаления «старых» данных. Если вам критически важно сохранить все изменения, сделанные недавно, или восстановить мир в точном состоянии на момент создания бэкапа, этот инструмент может не подойти без дополнительных настроек. Используйте его для долгосрочного архивирования и экономии дискового пространства, а не для мгновенного восстановления после краша.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Cherished Worlds — похожий мод

Автор: MagicJinn · Лицензия: MIT