Complete guide · sandustry mods

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 observations
Direct answer

Base 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.

Complex Sandustry world suitable for custom factory layouts
Official Sandustry gameplay screenshot illustrating the scale of custom factory layouts. Source: official Steam media.
Watch the process

Mods & Custom Maps video guide

The page remains the primary answer; this version-sensitive video is included as a visual demonstration.

COMPATIBILITY WORKBENCHDEMO ≠ EARLY ACCESS ≠ WORKSHOP
IDENTIFYREQUIRED

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.
BACK UPSAFE

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.
SEPARATEVERSIONED

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.

ROLL BACKVERSIONED

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.
Verified facts used on this page
  • 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.

Source library

Research behind this guide

This page was written from its own keyword material file. The sources below are not shared filler from another guide.

Questions answered

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.