Mods & Custom Maps
Match Sandustry mods to the current game and modding branch before loading a save.
Researched 22 Oct 2026 · Official facts separated from community observationsBase game Update #5 is v0.6.0, but its announcement says the 0.6 modding branch and new API documentation will be released shortly. Do not treat either as available until the developer publishes it; keep v0.5.6 profiles backed up and separate.

Keep the v0.6.0 game and mod branch separate
Update #5 ships the base game at v0.6.0, but the announcement says the 0.6 modding branch will be released shortly. That wording means the base update is live while the matching mod branch is not yet confirmed live by this source.
Keep the working v0.5.6 mod profile and its saves backed up. Verify the branch selector and the mod author's declared target before loading a modded save in a different game version.
- Do not assume the 0.6 mod branch is live.
- Preserve the v0.5.6 profile and save backup.
- Check each mod's declared target version.
- Move one mod at a time after the branch release is confirmed.
Use the official SandKit reference
Sandustry now publishes API documentation at sandustry.com/sandkit.html. Check that reference and the mod author's branch requirement before installing anything.
The announcement reports more than 125 community mods, but the number of available mods does not establish compatibility with a particular save or branch.
- Confirm the target branch.
- Back up saves and the working mod list.
- Install one item at a time.
- Launch and test before adding the next item.
Current SandKit surface
Update #3 added hooks and methods such as building:removing, fire:terrain:burn and meltAtCell for the v0.5.6-era branch. Update #5 says the 0.6 branch has many API additions, but its new documentation is still coming soon.
Use the live SandKit reference only for the version it documents. Do not copy an older signature into a 0.6 port until the new branch and reference are published.
Troubleshooting and rollback
When the game fails after a mod change, remove the newest item first and retest on the version it declares. Confirm a clean profile works before changing several files at once.
The developers still describe the API as work in progress. Recheck official notes and the SandKit reference after every game or mod update.
- Restore the backup if removal is incomplete.
- Record the game branch and mod version.
- Reproduce base-game bugs without custom content before reporting them.
- Base game Update #5 is v0.6.0.
- The official note says the 0.6 modding branch will be released shortly.
- New modding API documentation is also pending.
Version boundary: Base game v0.6.0 is live, but the official Update #5 note says the matching mod branch and new API documentation are still coming shortly. Verify release status before migrating.
Research behind this guide
This page was written from its own keyword material file. The sources below are not shared filler from another guide.
Mods & Custom Maps FAQ
Five practical answers covering setup, troubleshooting and version-sensitive decisions.
Which Sandustry branch supports the current mod framework?
Update #3 says the mods branch is now on v0.5.6, superseding the earlier temporary 0.5.2 and 0.5.5 split. Still check the version declared by each mod author and preserve a backup before changing a working profile.
Where are the official Sandustry mod API docs?
Use the official SandKit reference at sandustry.com/sandkit.html. The developers describe the API as work in progress, so recheck it when a game or mod update changes behavior.
Which SandKit APIs changed in v0.5.6?
Update #3 names new hooks and methods including building:removing, fire:terrain:burn and meltAtCell. Treat that list as a release note, then use the live SandKit documentation for signatures and verify behavior in a disposable test save.
Do older Sandustry mods work on v0.5.6?
Compatibility should not be assumed. Demo, 0.5.2 and 0.5.5 tutorials can document useful history, but their loaders, file paths or APIs are not proof of v0.5.6 compatibility. Follow the mod author's declared target and test one change at a time.
How do I troubleshoot a broken modded save?
Back up the save first, record the branch and mod versions, then remove the newest mod and retest. Reproduce a suspected base-game bug without custom content before reporting it.
Sandustry Wiki