Planet Crafter Save Tools
DISCLAIMER – I’m not actively maintaining this project (or only minimally). If you’d like to add improvements or fix bugs, feel free to fork it 😃
What you can do
- Merge two saves into one new file, ready to load in the game — pick which format to write when the two saves
come from different game versions.
- Visualize: progression, terraformation levels, players, energy balance, world settings - still a work in progress
- Check a save against the game's format, and see exactly which part is wrong, thanks to a validator running against
your save before it is displayed.
Your saves stay on your computer. Everything runs in your browser: the page never sends a save anywhere.
Coming next
- Editing a save right from the browser
- Auto-fix a corrupted save file both from web UI and CLI
How to merge two saves
Tips: press F1 on the game main screen to open the save folder.
- Find your saves.
- On Windows they sit in
%APPDATA%\..\LocalLow\MijuGames\Planet Crafter\.
- On Linux eh... try something like
~/.steam/steam/steamapps/compatdata/1234567/pfx/drive_c/users/steamuser/AppData/LocalLow/MijuGames/Planet Crafter/
if you installed the game from Steam with Proton.
- In the Save Manager, drop the two files on the merge section,
or pick them, and press Merge. Dropped together, they become save A and save B in the alphabetical order of
their names; the swap button between the two reverses them.
- Download the merged save, copy it next to the others, and pick it in the game.
The original saves are never modified.
Prefer the command line?
The same merge runs from a clone of this repository, on as many pairs of saves as you like in one go. With
Bun installed:
bun install
bun merge
Put each pair in its own folder under input/ — the folder name becomes the name of the merged world — and collect
the results in output/:
input/
└── Toxiprime/ ← name of the merged world
├── Standard-1.json
└── Standard-3.json
Arguments, exit codes and Node.js support are described in Command-line tools.
Going further
| Page | For |
|---|
| Command-line tools | every argument, exit code and output of bun merge and bun validate |
| Save format | the curious: how the game writes a save, section by section |
| Energy levels | how the Save Manager computes the energy balance |
| Architecture | contributors: the packages of the workspace and what each may depend on |
| Development | contributors: tests, type checks, audits, quality gate, UI commands |
| Releases and production | maintainers: versions, cutting a release, publishing the web UI |
Each tool carries its own version, listed in its CHANGELOG.md. Netlify publishes no production deploy by itself:
production is built from a ui-save-manager-v* tag and published by hand, and the deploy previews stay public.
Under the hood: how the merge decides
docs/awawa-project-specification/rules.awawa is the single
source of truth for every merge decision. Each entity states the conflict it settles (CONFLICT), how it settles
it (RESOLUTION), one falsifiable obligation per SPEC, and the test that proves each one (ATTESTED_BY). The
file is plain text and reads as it is; awawa show @RULE.<Name> docs/ prints one entity, awawa context @SECTION.<Name> docs/ every rule that constrains one section. This README deliberately does not restate the
rules: a second copy would drift from the implementation.
The original saves are never modified; the merged result is written to a separate output folder.
| Topic | Rule |
|---|
| Which save is A, which is B | @RULE.TheSaveOnPrimeBecomesSaveA |
| Global metadata | @RULE.GlobalMetadataIsSummedAndUnioned |
| Terraformation levels | @RULE.TerraformationLevelsTakeTheHigherValue |
| Players | @RULE.PlayersAreDeduplicatedByName |
| World objects | @RULE.WorldObjectsAreDeduplicatedByPlanetAndPosition |
| Inventories & equipment | @RULE.InventoriesAreKeptUnlessTheirOwnerIsEjected |
| Statistics | @RULE.StatisticsAreSummed |
| Messages / mailbox | @RULE.MailboxMessagesAreDeduplicatedByStringId |
| Story events | @RULE.StoryEventsAreUnioned |
| Save configuration | @RULE.SaveConfigurationComesFromSaveA |
| World events | @RULE.WorldEventsAreDeduplicatedByPlanetSeedAndPosition |
| Shared id numbering space | @RULE.IdentifiersAreSharedByInventoriesAndWorldObjects |
| Duplicated ids across saves | @RULE.DuplicateIdentifiersAreRemappedOnTheSaveBSide |
| Player identifiers | @RULE.APlayerIdentifierIsCarriedAsExactDecimalText |
