Repository navigation
Releases
v0.3.0
Automatic backups for Minecraft: Java Edition worlds, taken when you exit a world.
Status: a personal project, shared as-is. There are no guarantees on support or response time.
Changelog
New features
- feat: Windows app icon, version info and Start menu entry (#74)
- feat: check for new releases (#58)
- feat: compare a save with the current world (#68)
- feat: daily, weekly and monthly retention for automatic saves (#69)
- feat: desktop notification when a backup fails (#66)
- feat: one main player, player switcher and names from the launcher (#72)
- feat: start with the system from settings and the tray (#71)
- feat: test builds of develop on an update channel (#64)
- feat: test builds of pull request branches (#67)
- feat: tray menu language follows the UI language (#65)
Other changes
- build: Worldkeeper.app bundle for macOS (#70)
- build: generated release notes with install instructions (#73)
- build: group release notes by change type (#53)
- build: make app and make install-app for a local Worldkeeper.app (#76)
Install
Download the archive for your system, unpack it, and run worldkeeper. The web UI opens at http://127.0.0.1:25599 on the first start. To upgrade, quit Worldkeeper from the tray and replace the program; your settings and saves stay where they are.
| System | Download |
|---|---|
| Windows (most PCs) | worldkeeper_0.3.0_windows_amd64.zip |
| Windows on ARM | worldkeeper_0.3.0_windows_arm64.zip |
| macOS (Apple Silicon and Intel) | Worldkeeper_0.3.0_macOS.zip: unzip and move Worldkeeper.app to Applications |
| macOS, bare binary | worldkeeper_0.3.0_darwin_arm64.tar.gz / worldkeeper_0.3.0_darwin_amd64.tar.gz |
| Linux | worldkeeper_0.3.0_linux_amd64.tar.gz / worldkeeper_0.3.0_linux_arm64.tar.gz |
The binaries are not signed:
- Windows: SmartScreen warns on the first run. Click More info → Run anyway.
- macOS: right-click
Worldkeeper.app→ Open on the first launch (on macOS 15 and later: System Settings → Privacy & Security → Open Anyway). For the bare binary, clear the quarantine flag:xattr -d com.apple.quarantine ./worldkeeper.
See the README for setup, and all changes since v0.2.0.
Worldkeeper v0.2.0
Worldkeeper v0.2.0 makes what shipped in v0.1.0 dependable, and lets you rename and delete worlds.
Status: a personal project, shared as-is. I use it myself. There are no guarantees on support or response time.
Highlights
- Rename and delete worlds. Renaming changes the name shown in the game. The folder keeps its name, so the world stays linked to its saves. Before deleting a world, Worldkeeper saves it unless its latest state is already saved, so you can load a deleted world back.
- Progress for big backups and restores. Saves and restores run in the background with a progress bar, so a large world no longer leaves the page waiting on "Saving…". You can leave the page while one runs. Automatic backups show up there too.
- "Load as a new world" gives the copy its own name, "… (restored )", so the game no longer lists two worlds with the same name.
- The Activity feed survives restarts. The last 100 events are kept in
events.jsonnext to the config, so a failure from before a restart stays visible. - Your NAS can sleep. The tray status no longer reads the backup storage every 15 seconds. It reads it once and then keeps track of new backups, so network disks can spin down between games.
- Opening a world is never blocked. On Windows, the check for whether a world is open no longer takes a lock on
session.lock, so it can never stop the game from opening a world. Detection is now tested against Java's own file locking. - No console window flashes on Windows when Worldkeeper runs restic.
- The running version is shown in the web UI footer, with a link to its release notes, and in the tray menu.
- World info checked on real saves from 1.16.5, 1.20.6, 1.21.11 and 26.3. In v0.1.0 only 26.x had been checked.
Install
Download the archive for your system, unpack it, and run worldkeeper. The web UI opens at http://127.0.0.1:25599 on the first start. To upgrade from v0.1.0, quit Worldkeeper from the tray and replace the program. Your settings and saves stay where they are.
| System | Archive |
|---|---|
| Windows (most PCs) | windows_amd64.zip |
| Windows on ARM | windows_arm64.zip |
| macOS, Apple Silicon (M1–M4) | darwin_arm64.tar.gz |
| macOS, Intel | darwin_amd64.tar.gz |
| Linux | linux_amd64.tar.gz / linux_arm64.tar.gz |
The binaries are not signed:
- Windows: SmartScreen will warn on the first run. Click More info → Run anyway.
- macOS: clear the quarantine flag first:
xattr -d com.apple.quarantine ./worldkeeper.
To start Worldkeeper with your computer, see the README.
Known limitations
- Java Edition only.
- The tray and menu bar icon have been run by hand on Windows. On macOS and Linux they have been checked by building only.
Dev build 0.4.0-fix-backup-error-clears.202610112101.569b150
Test build of fix-backup-error-clears at 569b150, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Dev build 0.4.0-develop.202610111933.88945f9
Test build of develop at 88945f9, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Dev build 0.4.0-develop.202610111906.cb7b7ba
Test build of develop at cb7b7ba, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Dev build 0.4.0-develop.202610111902.cd65f6f
Test build of develop at cd65f6f, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Dev build 0.4.0-develop.202610111856.02a5223
Test build of develop at 02a5223, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Dev build 0.4.0-develop.202610111852.9d72393
Test build of develop at 9d72393, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Dev build 0.4.0-develop.202610111933.88945f9
Test build of develop at 88945f9, for Windows x64. Not a release: it may have bugs. Worldkeeper offers it when Settings → Offer updates is set to Test builds.
Worldkeeper v0.1.0
The first release of Worldkeeper: automatic backups for Minecraft: Java Edition worlds.
Status: a personal project, shared as-is. I use it myself. There are no guarantees on support or response time.
Highlights
- Backs up when you exit a world. Worldkeeper notices when the game releases a world's
session.lockand saves the world right away. On startup it also catches up on worlds you played while it was not running. - Finds your worlds: official launcher (including custom profile game directories), Prism Launcher, CurseForge, and Modrinth App on Windows, macOS, and Linux, plus any folder you add.
- Save slots. Name a save before something risky. Load any save, either replacing the world (a safety save of the current state is taken first) or as a new world next to it.
- What's inside each save. Open a save to see its world info and advancement tree as of that moment, even if the world is gone from this computer.
- World info read from the files: version, mode, difficulty, seed, day, weather, player, statistics, advancements, dimensions, data packs, and game rules. Supports the Minecraft 26.x world layout.
- Advancement tree with your progress, drawn by mcwidgets. This is opt-in, because it loads from mcwidgets.kaban.sh.
- Storage: plain zip files in any folder (a NAS share, or a Google Drive / OneDrive folder). Optionally a restic repository: encrypted and deduplicated. restic must be installed.
- Tray / menu bar icon with status, Back up now, and an auto-backup toggle. A red dot shows when a backup fails.
- UI in English and Russian.
Install
Download the archive for your system, unpack it, and run worldkeeper. The web UI opens at http://127.0.0.1:25599 on the first start.
| System | Archive |
|---|---|
| Windows (most PCs) | windows_amd64.zip |
| Windows on ARM | windows_arm64.zip |
| macOS, Apple Silicon (M1–M4) | darwin_arm64.tar.gz |
| macOS, Intel | darwin_amd64.tar.gz |
| Linux | linux_amd64.tar.gz / linux_arm64.tar.gz |
The binaries are not signed:
- Windows: SmartScreen will warn on the first run. Click More info → Run anyway.
- macOS: clear the quarantine flag first:
xattr -d com.apple.quarantine ./worldkeeper.
To start Worldkeeper with your computer, see the README.
Known limitations
- Java Edition only.
- The menu bar and tray icon have been checked by building only. They have not been run by hand on Windows and Linux yet.
- Minecraft 1.13–1.21 worlds are supported based on the known file format, but only 26.x has been checked against real saves.