Sandustry Mods Guide: Mod Loader, Workshop, Custom Maps & EA Compatibility
Quick answer
Install Sandustry mods safely in Early Access. Check the mods experimental branch, Modding Framework API, Workshop status, mod loader basics, and compatibility.
Current Early Access modding status
Sandustry has built-in modding ambitions, and the official Steam page says the game is designed for visual tweaks, hand-crafted maps, new buildings, and new production processes. Because the game is now in Early Access, every mod should be checked against the current build before installation. The September 3, 2026 v0.5.6 changelog also notes new mod hooks and that the experimental mods branch is now on 0.5.6.
Demo-era mod posts are useful historical notes, but they should not be treated as current instructions unless the author explicitly marks Early Access compatibility.
Current version and branch checks
Before installing a Sandustry mod, confirm whether it targets the separate mods experimental branch and which game version it supports. The developer has said mods currently require an experimental Steam branch, so do not assume a subscribed Workshop item will run on the default vanilla branch. Some older mod notes mentioned separate 0.5.2 and 0.5.5 compatibility branches; for the current v0.5.6 window, start by checking whether the Workshop item or author page explicitly supports 0.5.6 or the current mods branch.
| Check first | Use this rule |
|---|---|
| Game branch | Use the mods experimental branch only when the mod author or Workshop page requires it; use the default branch for vanilla saves |
| Modding Framework API | Match the API or loader version named in the mod readme, GitHub release, or Discord post |
| Workshop item | Check the latest update date and supported game version before subscribing |
| Manual download | Prefer GitHub releases or official Discord links over file mirrors |
| Existing save | Back up the save before testing branch-specific or API-dependent mods |
If the mod page does not name a supported game version, branch, loader, or API requirement, treat it as unverified. Test it in a new save before adding it to a factory you care about.
Fast safety checklist
| Check | Why it matters |
|---|---|
| Game version | Early Access updates can break loaders and old Demo mods |
| Branch requirement | Mods experimental branch builds may not match the default Early Access branch |
| Mod source | Prefer official Discord, GitHub, or a trusted workshop page |
| Save backup | Experimental mods can corrupt saves |
| Dependencies | Loader, Modding Framework API, core libraries, and map packs may need matching versions |
| Vanilla status | Co-op mods are not the same as official multiplayer support |
Getting Started: Installing the Mod Loader
Before installing Sandustry mods, confirm which loader the mod author recommends for the current Early Access build. Do not reuse a Demo loader just because the folder names look similar.
Step-by-Step Installation Process
| Step | Action | Details |
|---|---|---|
| 1 | Join the Discord | Visit the official Sandustry website and click the Discord button, or use the in-game link |
| 2 | Find the Mod Loader | Scroll to the mod forum section and locate the "mod loader" post |
| 3 | Download from GitHub | Click the provided link to reach the GitHub page, then download mod loader.exe |
| 4 | Place in Game Folder | Paste the file into your Sandustry installation directory |
| 5 | Create a Shortcut | Right-click and send a shortcut to your desktop for easy future access |
| 6 | Run Once | Launch the mod loader — it will briefly open and close, generating a "mods" folder and config file |
For Steam users, the old Demo path was typically:
C:\Program Files\Steam\steamapps\common\Sandustry demo
For Early Access, use the actual Sandustry install directory shown by Steam. Right-click the game in Steam, open Manage, then browse local files. Once the correct loader has been run at least once, the generated "mods" folder becomes your central hub for future modifications.
Tips for a Smooth Setup
- Read the instructions on each mod's Discord post before downloading — some mods have specific dependency requirements
- Back up your save files before installing multiple mods at once
- Create a desktop shortcut for the mod loader so you don't have to navigate through Steam folders every time
- Check for updates periodically, as mod authors frequently push bug fixes and new features
Installing Custom Maps and Gameplay Mods
One of the most popular categories of Sandustry mods is custom maps. These let you play on community-designed terrain with unique challenges and layouts. The process is slightly different from installing standard gameplay mods.
Steam Workshop status
Steam has a Workshop area for Sandustry community content, and the developer has pointed players to active Workshop mods during Early Access. If a mod author gives both a Workshop page and a manual download, prefer the path they mark as current for your game version. Workshop installs are easier to update; manual installs are easier to inspect and back up.
Custom Map Installation
| Component | Action | Location |
|---|---|---|
| Map Loader Mod | Download from Discord mod forum | Paste into the "mods" folder |
| Custom Map File | Download chosen map | Extract and place in mods/Maps/ |
| Map Selection | Launch mod loader, use dropdown menu | Select desired map before starting |
Player experience suggests that the map loader adds a convenient dropdown menu to the mod loader interface, letting you pick from any installed custom maps before launching a new game.
Standard Mod Installation
Regular gameplay mods follow an even simpler process. For example, a popular mod called "New Game+" unlocks all content from the moment you start a new save. To install it:
- Download the latest version from the mod's Discord post
- Copy the downloaded file into your "mods" folder
- Launch the game through the mod loader
- Start a new game — the mod's effects activate automatically
This same workflow applies to most Sandustry mods. As long as the file is placed correctly in the mods directory, the loader handles the rest.
Sandustry Together: Online Co-op Multiplayer
One of the most ambitious Demo-era Sandustry mods is Sandustry Together, an experimental co-op multiplayer modification built on the Fluxloader platform. Treat it separately from vanilla Sandustry. The official Early Access game should still be considered single-player unless the Steam feature list or patch notes add native multiplayer.
How Multiplayer Works
The host creates a world, and a second player joins using a room code. Both players interact with the host's world in real time, sharing the same terrain, buildings, and particle simulations. The mod has gone through several iterations, with version 0.5.0 introducing a public room lobby system.
Version History and Features
| Version | Key Improvements |
|---|---|
| 0.3.0 | Major general improvements |
| 0.3.1 | Performance fixes and stuck particle resolution |
| 0.4.0 | In-game menus, player list with names/colors/ping, background joining |
| 0.5.0 | Public room lobby for easier matchmaking |
What Works and What Doesn't
Community reports indicate that the mod is functional but still considered experimental. Here's a breakdown of the current state:
Working Features:
- All tested buildings sync properly between players
- Particle effects and building placement synchronize correctly
- Terrain modifications are accurately reflected for both players
- The flamethrower weapon syncs as expected
Known Issues:
- Most firearms don't sync bullet visuals (though terrain damage still works)
- Border region chunks may not sync correctly, as only the current player's radius is loaded
- Occasional desyncs and crashes can occur
- Save corruption is possible, so always back up your worlds
Multiplayer Controls and Hotkeys
| Hotkey | Function |
|---|---|
| F10 | Display the room code |
| Shift + F11 | Enter a custom coordination server |
| Shift + F12 | Join via custom server (requires a loaded world) |
The multiplayer menu is accessible from both the main menu and the pause screen. Players can set their display name and color, which are remembered between sessions. If the host disconnects, the client must return to the main menu — there's no host migration yet.
Note: Sandustry Together requires
corelibversion 3.1.0 or higher as a dependency. Make sure this is installed before attempting multiplayer.
Best Practices for Managing Your Mod Library
As you explore more Sandustry mods, organization becomes critical. A cluttered mods folder can lead to conflicts, crashes, and hard-to-diagnose issues.
Recommended Mod Management Strategy
- Test mods individually before combining them — install one, launch, verify, then add the next
- Keep a text file in your mods folder listing each mod, its version, and where you downloaded it
- Remove mods you don't use rather than leaving them inactive in the folder
- Check Discord regularly for update announcements and compatibility notes
- Use the official Sandustry community resources for troubleshooting: the Sandustry Discord, Reddit, and Wiki all offer active support
Common Mod Categories
| Category | Description | Example |
|---|---|---|
| Map Loaders | Enable custom terrain and challenge maps | Custom Map Loader |
| Gameplay Tweaks | Modify game balance, unlock content | New Game+ |
| Multiplayer | Add online co-op functionality | Sandustry Together |
| Quality of Life | UI improvements, performance fixes | Various community mods |
| Total Conversions | Overhaul core gameplay mechanics | In development |
Troubleshooting Common Issues
Even with careful installation, Sandustry mods can occasionally cause problems. Here are the most frequently reported issues and their solutions.
Mod Loader Won't Create the Mods Folder
If running the mod loader doesn't generate the expected folder structure, verify that you've placed the .exe in the correct game directory. The path must match your actual installation location, which may differ if you installed Steam on a non-default drive.
Game Crashes on Launch with Mods Installed
This usually indicates a mod conflict or missing dependency. Remove all mods from the folder, then add them back one at a time, launching after each addition to identify the culprit. Check whether the problematic mod requires a specific version of corelib or another dependency.
Custom Maps Don't Appear in the Dropdown
Ensure the map files are properly extracted and placed in the mods/Maps/ subfolder — not in the root mods directory. Compressed files must be unzipped before the loader can detect them.
Multiplayer Desyncs and Connection Issues
Since Sandustry Together is explicitly labeled as experimental, some desync is expected. Community reports suggest staying within a reasonable distance of each other in-game minimizes chunk synchronization issues. If problems persist, try hosting a new world rather than continuing from an existing save.
Where to Find More Sandustry Mods
The modding ecosystem is still growing, but several reliable sources exist for discovering new content:
- Sandustry Discord — The primary hub for mod releases, updates, and community support
- Sandustry Reddit — Player discussions, mod recommendations, and troubleshooting threads
- Sandustry Wiki — Documentation for both vanilla mechanics and popular mods
- Fluxloader Site — Hosts specific mods like Sandustry Together with detailed readmes
- GitHub — Where the mod loader and many open-source mods are published
- Steam Workshop — Check for current Early Access-compatible maps or mod packages when available
When downloading mods, always prefer official Discord links or GitHub repositories over third-party file-sharing sites. This reduces the risk of outdated or modified files that could cause issues.
Demo mods vs Early Access mods
| Mod page says | Treat as |
|---|---|
| Sandustry demo | Historical unless updated after August 13, 2026 and marked compatible with the relevant EA branch |
| Early Access compatible | Better candidate, still verify exact version or branch |
| 0.5.6 or current mods branch | Best candidate for the September 2026 build, still read dependencies |
| Full release | Future-facing, not a guarantee for the current build |
| Multiplayer or co-op | Experimental mod unless official patch notes say otherwise |
Older Demo notes are preserved in the Demo Mods archive, but they are not the primary install instructions for today's build.
FAQ
Are Sandustry mods safe to install?
Most Sandustry mods distributed through the official Discord and GitHub are community-vetted and safe. However, always back up your save files before installing new mods, especially experimental ones like the multiplayer mod, which the developer notes may cause save corruption.
Can I use multiple Sandustry mods at the same time?
Yes, you can run multiple Sandustry mods simultaneously by placing all mod files in the "mods" folder. However, some mods may conflict with each other. Test each mod individually first, then combine them gradually to identify any compatibility issues.
Do Sandustry mods work in Early Access or only the demo?
Demo compatibility does not guarantee Early Access compatibility. Check the mod's Discord post, GitHub release, or Workshop page for the supported game version before installing.
Is the Sandustry Together multiplayer mod stable enough for regular play?
The mod author explicitly labels it as experimental, with known issues including bullet desync and border chunk problems. That said, many players report satisfactory co-op sessions for building and digging. For the best experience, avoid combat-heavy scenarios and stay relatively close to your co-op partner.
Sources
Modding scope is checked against the official Sandustry Steam page, which describes custom maps and new buildings/processes as part of the game's modding direction, the Sandustry Workshop, and the official v0.5.6 Update #3 Steam changelog. Multiplayer status is separated into the co-op guide so Demo-era modded co-op does not get confused with vanilla Early Access support.
Choose your next move
Related Guides
Once this question is solved, continue to the next decision without returning to search.
Historical Sandustry Demo Modding Guide Archive
Archived Sandustry demo modding notes for old mod loader, custom map, and gameplay mod workflows. Use the current mods guide for Early Access.
Sandustry Demo Mods Archive: Historical Mod Loader, Maps & Co-op Notes
Historical Sandustry demo mods notes for mod loader, custom maps, and experimental co-op. Verify Early Access compatibility before installing anything.