# Config Cloud Backuper<\/p>\n
A simple Minecraft mod for backing up game configuration files, with configurable backup paths and WebDAV cloud backup support for both client and server usage.<\/p>\n
## Features<\/p>\n
– **Client + server command support** \u2014 both sides can use commands; server also supports `\/server_config_backuper …` (requires **Fabric API**)
\n– **Client-to-server upload** \u2014 clients can upload local backups to server storage; files are saved per player and retention is configurable
\n– **Optional GUI** \u2014 install ModMenu and Cloth Config API, then open settings from ModMenu
\n– Backup game configs, mod configs, shader configs, and more folders (see `config\/config-cloud-backuper.json`)
\n– Backup compression and automatic old-backup cleanup
\n– **WebDAV** \u2014 auto upload after backup (if enabled), plus manual list\/upload\/download commands
\n– **Security checks** \u2014 client upload only accepts `.zip` with size limit and filename sanitization; server validates SHA-256 and writes audit logs<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.21.1
\n– Fabric Loader >=0.16.0
\n– Java 21+
\n– **Fabric API** (required for command registration)
\n– ModMenu (optional)
\n– Cloth Config API (optional, needed only for ModMenu GUI)<\/p>\n
## Commands (Client\/Server)<\/p>\n
Commands are grouped under: `remote cloud` \/ `remote server`.<\/p>\n
Root command prefixes (kept for compatibility):<\/p>\n
– Client: `\/config_backuper`
\n– Server: `\/config_backuper` or `\/server_config_backuper` (same functionality)<\/p>\n
> Note: The command prefix is intentionally kept for backward compatibility with existing scripts and habits. A cloud-style prefix can be introduced later in a major release with alias transition.<\/p>\n
| Subcommand | Description | Running root command without subcommand prints brief help.<\/p>\n ### Server Examples<\/p>\n – `\/server_config_backuper backup`: run server backup ## Configuration<\/p>\n Main config: `config\/config-cloud-backuper.json` You can also edit values with `config` \/ `remote cloud` \/ `remote server` commands above.<\/p>\n ### General and Backup Storage<\/p>\n Main fields include: `includeGameConfigs`, `includeModConfigs`, `includeShaderPackConfigs`, `includeSchematics`, `include3dSkin`, `includeSyncmatics`, `includeDefaultConfigs`, `compressionEnabled`, `maxBackups`, `backupFolder`, `backupFilePrefix`, `backupFileSuffix`.<\/p>\n ### Client Upload to Server (main config fields)<\/p>\n – `clientUploadToServerEnabled`: allow client uploads to server (default `true`) Server storage structure:<\/p>\n – ` ### WebDAV (`config-cloud-backuper_webdav.json`)<\/p>\n – `enabled` \u2014 auto upload latest backup after local backup flow WebDAV security behavior:<\/p>\n – Upload also writes checksum file: ` ## Modpack Usage<\/p>\n You may freely include this mod in modpacks without requesting permission.<\/p>\n ## Development<\/p>\n ### Build<\/p>\n “`shell For local client testing with ModMenu + Cloth GUI, this repo already includes Cloth via `modLocalRuntime`. You still need to add ModMenu in your run profile (or `modRuntimeOnly`).<\/p>\n","protected":false},"excerpt":{"rendered":" A simple Minecraft mod for backing up game configuration files, with configurable backup paths and WebDAV cloud backup support for both client and server usage.<\/p>\n","protected":false},"featured_media":45067,"template":"","meta":{"_minecraft_slug":"config-cloud-backuper","_minecraft_project_id":"gzbwSrra","_minecraft_author":"Akiyy","_minecraft_license":"MIT","_minecraft_downloads":43,"_minecraft_follows":1,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"config-cloud-backuper.zip","_minecraft_size_bytes":18958541,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T12:49:49.861453Z","_minecraft_date_created":"2026-05-08T03:51:53.649340Z","_minecraft_date_modified":"2026-05-10T10:54:31.013609Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/config-cloud-backuper","_minecraft_icon_attachment_id":45067,"_minecraft_imported_at":"2026-06-02T04:21:03+00:00","_minecraft_import_hash":"81bb9cfe636f66843601f10d35720b58","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,92],"mod_loader":[99],"minecraft_version":[37],"class_list":["post-45066","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-1"],"yoast_head":"\n
\n|—|—|
\n| `backup` | Run local backup and clean old files exceeding `maxBackups`; if WebDAV auto-upload is enabled, upload the **latest** backup afterward |
\n| `list` | List local backup files matching configured prefix\/suffix |
\n| `config reload` | Reload `config-cloud-backuper.json` from disk and refresh runtime instances |
\n| `config show` | Show current main config values |
\n| `config set
\n| `remote cloud status` | Show WebDAV config (password masked) |
\n| `remote cloud list` | List files in remote WebDAV directory |
\n| `remote cloud upload [file]` | Force upload local backup file (latest by default) to WebDAV; credentials are still required |
\n| `remote cloud download [file]` | Download remote file into local backup directory (latest by name by default) |
\n| `remote cloud set
\n| `remote server status` | (Client) Query server-side client-upload config |
\n| `remote server list` | (Client) Query current player’s uploaded backups on server |
\n| `remote server upload [file]` | (Client) Upload local backup to server (latest by default) |<\/p>\n
\n– `\/server_config_backuper list`: list server local backups
\n– `\/server_config_backuper config show`: show current server config
\n– `\/server_config_backuper remote server status`: show client-upload config
\n– `\/server_config_backuper remote server list`: show your uploaded backups (requires OP level > 2)
\n– `\/server_config_backuper remote server set folder .\/configcloudbackuper-backups\/client-uploads`: set upload root folder
\n– `\/server_config_backuper remote server set maxPerPlayer 20`: set max backups per player<\/p>\n
\nWebDAV config: `config\/config-cloud-backuper_webdav.json`<\/p>\n
\n– `clientUploadFolder`: server storage root for uploaded backups (default `.\/configcloudbackuper-backups\/client-uploads`)
\n– `clientUploadMaxBackupsPerPlayer`: max backups per player (`-1` means unlimited, default `10`)<\/p>\n
\n– `serverUrl`, `username`, `password`, `remotePath` \u2014 server and path settings<\/p>\n
\n– Download reads `.sha256` first, then verifies SHA-256 after download; mismatch deletes the file and returns error<\/p>\n
\ncd fabric
\n.\/gradlew build
\n“`<\/p>\n