{"id":37906318,"url":"https://github.com/leafuke/minebackup","last_synced_at":"2026-02-24T09:25:19.084Z","repository":{"id":198466539,"uuid":"700854277","full_name":"Leafuke/MineBackup","owner":"Leafuke","description":"A simple but useful GUI program to backup and restore your MC saves.","archived":false,"fork":false,"pushed_at":"2026-02-21T08:04:35.000Z","size":9586,"stargazers_count":85,"open_issues_count":11,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-02-21T15:07:57.961Z","etag":null,"topics":["automation","backup","linux","macos","minecraft","tools","windows"],"latest_commit_sha":null,"homepage":"https://leafuke.github.io/MineBackup-Web/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Leafuke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"notice","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-05T12:33:29.000Z","updated_at":"2026-02-14T05:16:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"4867b36d-469f-4ccc-810e-7bbee33de9b1","html_url":"https://github.com/Leafuke/MineBackup","commit_stats":null,"previous_names":["leafuke/minebackup"],"tags_count":56,"template":false,"template_full_name":null,"purl":"pkg:github/Leafuke/MineBackup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leafuke%2FMineBackup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leafuke%2FMineBackup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leafuke%2FMineBackup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leafuke%2FMineBackup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Leafuke","download_url":"https://codeload.github.com/Leafuke/MineBackup/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leafuke%2FMineBackup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29705845,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-22T05:59:28.568Z","status":"ssl_error","status_checked_at":"2026-02-22T05:58:46.208Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","backup","linux","macos","minecraft","tools","windows"],"created_at":"2026-01-16T17:11:48.103Z","updated_at":"2026-02-22T06:03:07.146Z","avatar_url":"https://github.com/Leafuke.png","language":"C++","readme":"# MineBackup — The Ultimate Backup Companion for Your Minecraft Worlds 🗂️💾\n\n[![中文说明](https://img.shields.io/badge/README-中文-blue)](README_zh.md)\n[![Latest Release](https://img.shields.io/github/v/release/Leafuke/MineBackup?style=flat-square)](https://github.com/Leafuke/MineBackup/releases)\n[![Issues](https://img.shields.io/github/issues/Leafuke/MineBackup?style=flat-square)](https://github.com/Leafuke/MineBackup/issues)\n\n![MineBackup Banner](MineBackup/MineBackup.png)\n\n\u003e **Back up with confidence · Restore in seconds · Compress intelligently**  \n\u003e Keep your Minecraft worlds safe — and yes, you can back up any folder on your PC, too.\n\n---\n\n## ✨ Why MineBackup?\n- 🎯 **Plug-and-Play** — A single executable. Download, double-click, done.\n- 🖥 **Clean, Fast GUI** — Powered by ImGui. Simple layout, snappy response.\n- 💾 **Secure Backups** — One click to safeguard your Minecraft saves.\n- 🔄 **Quick Restores** — Roll back to any previous state from a `.7z` file or local backup.\n- 📦 **High Compression** — Built-in 7-Zip core saves disk space.\n- 🧠 **Smart Mode** — Git-like incremental backups to save time and storage.\n- 📁 **Custom Paths** — Store backups wherever you want.\n- 🌏 **Multi-language** — Currently supports English and Chinese — more are welcome!\n- 💻 **Multi-platform** — Currently supports Windows, Linux and MacOS.\n\n💡 **Pro tip:** It works on any folder, not just Minecraft worlds.\n\n---\n\n## 🚀 Getting Started\n\n### 1️⃣ Download \u0026 Run\n1. Go to the [latest release](https://github.com/Leafuke/MineBackup/releases).\n2. Download the single Windows executable.\n3. Double-click to run — **no installation required**.\n\n### 2️⃣ Basic Actions - Basic\n| Feature      | How to Use |\n|--------------|------------|\n| Back up a world | Select a world → click **Backup** |\n| Restore a world | Select a world → click **Restore** (from `.7z` or local directory) |\n| Change backup location | Open **Settings** → choose your path |\n| Switch language | Settings → Language |\n\n### 3️⃣ Power Features\n- **Hotkey Backup** — Press **Alt+Ctrl+S** in-game to trigger a live backup.\n- **Exit Detection** — Enable *DetectOnExit* to back up automatically when Minecraft closes.\n- **KnotLink Integration** — Let MineBackup talk to mods or other tools to trigger “save before backup.” An example mod is [here](https://modrinth.com/mod/minebackup).\n\n---\n\n## 🛠 Feature Highlights\n\n### 🔥 Hotkey Backups\n- Hit **Alt + Ctrl + S** while playing:  \n  Detects the currently active world → broadcasts a save request → runs a hot backup in the background.\n\n### 🕒 Auto Exit Backups\n- With *DetectOnExit* enabled, MineBackup checks every 10 seconds for changes to `level.dat`.\n- When it sees the file go from “in use” to “released,” it automatically performs a hot backup.\n\n### 📡 KnotLink Messaging\nMineBackup can send and receive simple text events to coordinate with other apps or mods. View [MineBackup](https://modrinth.com/mod/minebackup) as an example mod for detail.\n\n- **Supported Commands:**\n```\n\nBACKUP \\\u003cconfig\\_idx\u003e \\\u003cworld\\_idx\u003e \\[comment]\nRESTORE \\\u003cconfig\\_idx\u003e\nLIST\\_WORLDS \\\u003cconfig\\_idx\u003e\nLIST\\_CONFIGS\nSET\\_CONFIG \\\u003cconfig\\_idx\u003e \u003ckey\u003e \u003cvalue\u003e\n\n````\n*key*: `backup_mode` / `hot_backup`  \n*value*: `1/2/3` or `0/1`\n\n\u003e 🔍 See [Developer \u0026 Advanced User Guide](#-developer--advanced-user-guide) for full protocol details.\n\n---\n\n## ⚙️ Installation \u0026 Build\n\n**Requirements:**\n- Windows/Linux/MacOS\n- C++20 compiler\n- ImGui library linked\n- 7-Zip executable\n\n**Build:**\n```bash\n# Clone the repo\ngit clone https://github.com/Leafuke/MineBackup.git\ncd MineBackup\n\n# Make sure the ImGui source is included\n````\n\n---\n\n## 🤝 Contributing \u0026 Support\n\n* **Report bugs / request features:** [GitHub Issues](https://github.com/Leafuke/MineBackup/issues)\n* **Help translate:** Edit [`i18n.h`](MineBackup/i18n.cpp) and submit a pull request.\n* **Improve docs:** PRs welcome — examples, screenshots, and tips appreciated.\n\n---\n\n## 📚 Developer \u0026 Advanced User Guide\n\n### KnotLink Quick Reference\n\n| Command       | Description                              |\n| ------------- | ---------------------------------------- |\n| BACKUP        | Immediately back up a given config/world |\n| RESTORE       | Restore a given config                   |\n| LIST_WORLDS  | List all worlds under a config           |\n| LIST_CONFIGS | List all configs                         |\n\n\n**APPID:** `0x00000020`\n**socket ID:** `0x00000010`\n**signal ID:** `0x00000020`\n\n---\n\n## 📄 Project References\n\n* [**7-Zip**](https://github.com/ip7z/7zip) — Compression core (7z.exe)\n* [**ImGui**](https://github.com/ocornut/imgui) — GUI framework\n* [**stb**](https://github.com/nothings/stb) — Image loading\n* [**KnotLink**](https://github.com/hxh230802/KnotLink) — Lightweight inter-process messaging\n* [**json**](https://github.com/nlohmann/json) — Metadata read \u0026 write\n* [**Font-Awesome**](https://github.com/FortAwesome/Font-Awesome) - Icons\n\n---\n\n## 📜 Note\n\nThe next generation of MineBackup has been realesed as [FolderRewind](https://github.com/Leafuke/FolderRewind). It features better versatility and a modern UI. Features are being actively developed there.\n\n---\n\n**MineBackup** — Peace of mind for your Minecraft worlds.\n⭐ If you find it useful, please give it a star!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleafuke%2Fminebackup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleafuke%2Fminebackup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleafuke%2Fminebackup/lists"}