Sandustry mod installation is easier than most factory games, and that is exactly why the community has grown so fast around custom content. The official website confirms the game is built with modding in mind, shipping dedicated modding tools alongside custom maps, new buildings, and full gameplay overhauls. If you want to extend your factory beyond the vanilla campaign, this Sandustry modding guide walks you through the entire process, from locating files to loading community creations. Because the game launches into Early Access on August 13, 2026, knowing how to install mods from day one gives you a head start over players who wait for tutorials later. Get the latest workflow below, including the map editor, mod tools, and troubleshooting tips that community members report as the most common roadblocks.
Mod Installation Steps
The Sandustry mod installation process follows a simple pattern: download, extract, place, and activate. Unlike some titles that require third-party loaders or manual DLL injection, Sandustry ships with native mod support that the developer actively maintains. According to the official website, the game includes dedicated modding tools right in the installation folder, which means you do not need to hunt for external utilities or patch the executable.
The core workflow breaks down into four stages that most community mods follow:
-
Download the mod archive from the official Discord, Steam Workshop, or community repositories — most creators package their work as
.zipfiles. -
Extract the contents to a temporary folder so you can inspect the file structure before moving anything into the game directory.
-
Place the mod folder into the
Sandustry/Modsdirectory, which the game creates automatically on first launch. -
Activate the mod through the in-game mod manager, then restart the client to load the custom content.
Because the game is still in Early Access, the exact folder path may shift slightly between updates. Community reports suggest checking the mods.json manifest file inside each mod folder, since that file tells the game which assets to load and in what order. If you are moving between versions, always verify that the mod was built for your current game build, since a mismatch is the leading cause of silent load failures.
The developer also shares modding tools directly in the official Discord, which is where most early-access creators publish their first experiments. That channel remains the fastest way to find fresh Sandustry mod installation guides and version-specific patches, especially during the first few weeks after launch.
Preparing Your Game for Custom Content
Before you attempt any Sandustry mod installation, you need to prepare the base game so it recognizes external files. This preparation step takes about two minutes and prevents 90 percent of the common errors that players report on the Discord server. The game does not require any special flags or developer mode toggles, but it does need a clean directory structure.
Verifying the Mods Folder
The game creates a Mods folder in its root directory on the first launch, but some players report that the folder does not appear if they skipped the tutorial. If you do not see it, create a new folder named Mods in the same directory as the executable. The game scans this folder at startup, so any subfolder placed inside it becomes a candidate for loading.
| Check | What to Look For | Action If Missing |
|---|---|---|
| Game version | Latest Early Access build | Update through Steam |
| Mods folder | Sandustry/Mods exists | Create it manually |
| Mod manifest | mods.json inside each mod | Re-download the mod |
| Backup saves | Saves folder copied | Copy to a safe location |
Backing Up Your Saves
Custom content can alter world generation, building behavior, and production chains, so a backup is non-negotiable before you start. Copy the entire Saves folder to a separate location on your drive. Community reports indicate that some early mods changed block IDs, which caused existing worlds to load with missing textures or broken machines. A backup lets you roll back instantly if a mod corrupts your primary save.
Checking Disk Space and Permissions
Mods that add custom buildings and new textures can consume several hundred megabytes, especially if they include high-resolution sprites or custom audio. Verify that your game drive has at least 2 GB of free space before installing multiple mods. If you installed the game through Steam, also confirm that the folder is not marked as read-only, since that blocks the game from writing configuration files during mod activation.
Using the Built-in Mod Tools and Map Editor
Sandustry mod installation becomes far more interesting once you realize the game includes a full map editor and mod tools out of the box. The official website highlights that the game supports custom maps, new buildings, processes, and full overhauls, all through tools that ship with the client. That means you are not limited to consuming other people's work — you can create your own Sandustry custom content with the same utilities the developer uses.
The Map Editor Basics
The map editor opens from the main menu and lets you design custom worlds with specific resource distributions, terrain shapes, and starting conditions. You can place ore veins, water sources, and ruins manually, then save the result as a .sandmap file. That file goes into the Maps folder, which sits alongside the Mods folder in the game directory. When you start a new game, your custom map appears in the world selection list.
| Editor Feature | What It Does | Best Use Case |
|---|---|---|
| Terrain brush | Paint elevation and ground types | Creating natural barriers |
| Resource painter | Place ore and material nodes | Balancing early-game access |
| Ruin placer | Add ancient structures | Designing exploration zones |
| Spawn marker | Set player start location | Controlling the opening minutes |
Creating Custom Buildings for Install
The mod tools go beyond maps and let you define Sandustry custom buildings with unique behaviors. Each building is defined by a JSON file that specifies its sprite, crafting recipes, input and output slots, and processing time. The game reads these definitions at startup, so you can iterate quickly by editing the JSON and restarting the client. Community creators recommend starting with a simple furnace variant before attempting complex machines, since the logic for multi-step processes requires more careful configuration.
Testing Your Creations
After you finish building a mod, create a new test world rather than loading your main save. This isolates any bugs and prevents a broken building from crashing your primary factory. The official Discord has a dedicated modding channel where creators share test results and troubleshooting advice, and the developer occasionally posts updated mod tools there as well.
Installing Community Mods Step by Step
Now that your game is prepared and you understand the tools, the actual Sandustry mod installation process takes only a few minutes. The steps below reflect the workflow that community members report as the most reliable across different Windows and Steam Deck configurations.
Step-by-Step Installation
-
Download the mod from the official Discord or a community repository. Look for a
.ziparchive that contains a folder with amods.jsonfile inside. -
Extract the archive to your desktop or Downloads folder. Do not extract directly into the game directory, since that can create nested folder structures the game does not recognize.
-
Open the extracted folder and confirm the
mods.jsonmanifest is present. If you see multiple files but no manifest, the mod may require a specific installation method described in its readme. -
Copy the entire mod folder into
Sandustry/Mods. The folder name does not matter, but avoid spaces and special characters to prevent path issues. -
Launch the game and open the mod manager from the main menu. Your mod should appear in the list with a toggle switch.
-
Enable the mod and restart the game. Some mods load instantly, while others require a full restart to register new building definitions.
Verifying a Successful Load
After restarting, check the mod manager to confirm the mod shows as active. Then start a new world or load a test save to verify the custom content appears. If you installed a mod that adds Sandustry custom buildings, open the build menu and look for the new category. If the buildings do not appear, the mod may have failed to load due to a version mismatch or a missing dependency.
| Symptom | Likely Cause | Fix |
|---|---|---|
| Mod not listed | Wrong folder path | Move mod into Mods |
| Game crashes on load | Version mismatch | Update game or mod |
| Buildings missing | Missing dependency | Install required base mod |
| Textures glitch | Corrupted download | Re-download and re-extract |
Managing Multiple Mods
When you run several mods at once, load order matters. The game processes mods alphabetically by folder name, so prefix your mods with numbers if you need a specific order. Community reports suggest keeping a 00_ prefix for core framework mods and zz_ for optional content packs. This convention prevents conflicts when two mods try to modify the same building definition.
Creating Your Own Sandustry Mod
If the existing library does not cover what you need, learning how to create a mod for Sandustry is a rewarding process that the built-in tools make surprisingly approachable. You do not need to be a programmer to start, although basic JSON knowledge helps significantly when you move beyond simple reskins.
Starting with a Simple Building
The easiest entry point is cloning an existing building definition and modifying its values. Open the game's base content folder, find a simple machine like the furnace, and copy its JSON file into your mod folder. Change the id field to a unique value, adjust the sprite reference, and modify the processing time or output amounts. Save the file, load the game, and your custom building appears in the build menu.
Understanding the Manifest Structure
Every Sandustry mod needs a mods.json manifest that tells the game what to load. The manifest includes the mod name, version, author, and a list of content files. The game validates this file at startup, so a malformed manifest prevents the entire mod from loading. Community creators recommend validating your JSON with an online parser before testing, since a single missing comma can break the whole mod.
Publishing Your Creation
Once your mod works locally, share it on the official Discord or the Steam Workshop. The developer actively monitors the modding channel and occasionally features community creations in announcements. When you publish, include a clear description of what your mod adds, which game version it targets, and any dependencies it requires. This information helps other players avoid the installation errors that come from version mismatches.
Troubleshooting Common Mod Installation Issues
Even with a clear Sandustry modding guide, problems can arise. The community has documented several recurring issues, and knowing how to diagnose them saves you from reinstalling the game repeatedly. Most issues fall into one of three categories: file structure problems, version conflicts, or dependency errors.
File Structure Problems
The most common issue is placing the mod folder incorrectly. The game expects each mod to be a subfolder inside Mods, not a loose collection of files. If you extract a mod directly into the Mods folder, the game may not detect it because the manifest is not at the expected depth. Always maintain the folder structure from the original archive.
Version Conflicts
Because Sandustry is in Early Access, updates can break mods that were built for older versions. The developer posts patch notes on the official Steam announcements page, and mod creators typically update their work within a few days of a major release. If a mod stops working after an update, check the Discord for a patched version before troubleshooting your installation.
Dependency Errors
Some mods require other mods to function. A custom building might reference a framework mod that provides shared utilities or sprite atlases. If the dependency is missing, the game silently skips the dependent mod, which is why your custom buildings may not appear even though the mod shows as active. Always read the mod description carefully and install required dependencies first.
For players who want to dig deeper into the technical side, the Sandustry modding tutorial covers advanced topics like custom machines and process chains. If you are more interested in expanding your factory with new production options, the custom recipes mod guide explains how to add new crafting combinations. And for a broader look at the machines that form the backbone of your factory, the utility buildings guide breaks down the grabber, smelter, and furnace mechanics that most mods build upon.
Frequently Asked Questions
Where do I download Sandustry mods?
The official Discord server is the primary hub for community mods, since the developer shares modding tools and featured creations there. The Steam Workshop also hosts a growing collection of mods, and some creators publish on external repositories. Always download from trusted sources to avoid corrupted files or outdated versions that may not match your game build.
Do I need to create a mod to use custom content?
No, you can install and play mods created by other players without any programming knowledge. The Sandustry mod installation process only requires copying folders and enabling mods through the in-game manager. Creating your own mods is optional and uses the same built-in mod tools that ship with the game, but consuming community content requires no technical skills.
Can mods break my existing save files?
Some mods can affect existing saves, especially those that change block IDs or world generation parameters. The safest approach is to back up your Saves folder before installing any mod. If a mod causes issues, remove it and restore your backup. Community reports indicate that most building-adding mods are safe for existing worlds, but overhaul mods carry higher risk.
How do I update a mod after a game patch?
Check the mod's download page or the Discord for an updated version that matches your current game build. Replace the old mod folder with the new one, then restart the game. Some mods preserve their configuration files across updates, while others reset to defaults, so review the changelog before updating if you customized any settings.
What is the difference between the map editor and mod tools?
The map editor builds custom worlds—terrain, resources, starting conditions—saved as .sandmap files. Mod tools go further, letting you define new buildings, processes, or full gameplay overhauls. Both ship together, so you can pair a custom map with fresh building definitions in one mod.