Config-Cloud-Backuper

Config Cloud Backuper

Простой мод для Minecraft, который создаёт резервные копии файлов конфигурации игры. Поддерживает настраиваемые пути резервного копирования и облачное резервное копирование через WebDAV как на клиенте, так и на сервере.

Возможности

• Поддержка команд на клиенте и сервере — обе стороны могут использовать команды; сервер также поддерживает /server_config_backuper ... (требуется Fabric API)
• Загрузка с клиента на сервер — клиенты могут загружать локальные резервные копии в хранилище сервера; файлы сохраняются отдельно для каждого игрока, срок хранения настраивается
• Опциональный GUI — установите ModMenu и Cloth Config API, затем откройте настройки через ModMenu
• Резервное копирование конфигов игры, конфигов модов, конфигов шейдеров и других папок (см. config/config-cloud-backuper.json)
• Сжатие резервных копий и автоматическая очистка старых
• WebDAV — автозагрузка после резервного копирования (если включена), а также ручные команды просмотра списка, загрузки и скачивания
• Проверки безопасности — при загрузке с клиента принимаются только .zip с ограничением размера и очисткой имени файла; сервер проверяет SHA-256 и ведёт журнал аудита

Требования

• Minecraft 1.21.1
• Fabric Loader >=0.16.0
• Java 21+
• Fabric API (требуется для регистрации команд)
• ModMenu (опционально)
• Cloth Config API (опционально, нужен только для GUI в ModMenu)

Команды (клиент/сервер)

Команды сгруппированы в: remote cloud / remote server. Корневые префиксы команд (сохранены для совместимости):

• Клиент: /config_backuper
• Сервер: /config_backuper или /server_config_backuper (одинаковая функциональность)

Примечание: префикс команды намеренно сохранён для обратной совместимости с существующими скриптами и привычками. Префикс в стиле cloud может быть введён позже в крупном релизе с переходом через алиасы.

Подкоманда	Описание
backup	Запустить локальное резервное копирование и удалить старые файлы, превышающие maxBackups; если включена автозагрузка WebDAV, после этого загрузить последнюю резервную копию
list	Показать локальные файлы резервных копий, соответствующие настроенным префиксу/суффиксу
config reload	Перезагрузить config-cloud-backuper.json с диска и обновить рабочие экземпляры
config show	Показать текущие значения основной конфигурации
`config set `	Обновить и сохранить основную конфигурацию (для булевых значений поддерживаются true/false и т. п.)
remote cloud status	Показать конфигурацию WebDAV (пароль замаскирован)
remote cloud list	Показать файлы в удалённой директории WebDAV
remote cloud upload [file]	Принудительно загрузить локальный файл резервной копии (по умолчанию последний) в WebDAV; учётные данные всё равно требуются
remote cloud download [file]	Скачать удалённый файл в локальную директорию резервных копий (по умолчанию последний по имени)
`remote cloud set `	Записать поля в config-cloud-backuper_webdav.json: enabled, serverUrl, username, password, remotePath
remote server status	(Клиент) Запросить конфигурацию загрузки с клиента на стороне сервера
remote server list	(Клиент) Запросить резервные копии текущего игрока, загруженные на сервер
remote server upload [file]	(Клиент) Загрузить локальную резервную копию на сервер (по умолчанию последнюю)

Запуск корневой команды без подкоманды выводит краткую справку.

Примеры для сервера

• /server_config_backuper backup: запустить резервное копирование на сервере
• /server_config_backuper list: показать локальные резервные копии сервера
• /server_config_backuper config show: показать текущую конфигурацию сервера
• /server_config_backuper remote server status: показать конфигурацию загрузки с клиента
• /server_config_backuper remote server list: показать ваши загруженные резервные копии (требуется уровень OP > 2)
• /server_config_backuper remote server set folder ./configcloudbackuper-backups/client-uploads: задать корневую папку для загрузок
• /server_config_backuper remote server set maxPerPlayer 20: задать максимальное число резервных копий на игрока

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

Основная конфигурация: config/config-cloud-backuper.json
Конфигурация WebDAV: config/config-cloud-backuper_webdav.json Значения также можно редактировать командами config / remote cloud / remote server, описанными выше.

Общие настройки и хранилище резервных копий

Основные поля включают: includeGameConfigs, includeModConfigs, includeShaderPackConfigs, includeSchematics, include3dSkin, includeSyncmatics, includeDefaultConfigs, compressionEnabled, maxBackups, backupFolder, backupFilePrefix, backupFileSuffix.

Загрузка с клиента на сервер (поля основной конфигурации)

• clientUploadToServerEnabled: разрешить загрузку с клиента на сервер (по умолчанию true)
• clientUploadFolder: корень хранилища сервера для загруженных резервных копий (по умолчанию ./configcloudbackuper-backups/client-uploads)
• clientUploadMaxBackupsPerPlayer: максимальное число резервных копий на игрока (-1 означает без ограничений, по умолчанию 10) Структура хранилища сервера:
• `//`

WebDAV (config-cloud-backuper_webdav.json)

• enabled — автоматически загружать последнюю резервную копию после локального резервного копирования
• serverUrl, username, password, remotePath — настройки сервера и пути Поведение безопасности WebDAV:
• При загрузке также записывается файл контрольной суммы: `.sha256`
• При скачивании сначала читается .sha256, затем после загрузки проверяется SHA-256; при несовпадении файл удаляется и возвращается ошибка

Использование в сборках

Вы можете свободно включать этот мод в сборки без запроса разрешения.

Разработка

Сборка

cd fabric
./gradlew build

Для локального тестирования клиента с ModMenu + Cloth GUI этот репозиторий уже включает Cloth через modLocalRuntime. Вам всё ещё нужно добавить ModMenu в ваш профиль запуска (или modRuntimeOnly).