Sandustry Mod Guide: Install, Manage and Create Mods

Sandustry launches into Early Access on August 13, 2026, and the developer has made one thing crystal clear: the game is built with modding in mind. Unlike many factory-automation titles that treat mods as an afterthought, Sandustry ships with dedicated modding tools, full support for custom maps, and a simulation engine designed to be extended. This Sandustry mod guide walks you through everything from installing your first mod to building entirely new production chains, so you can shape the game around your own vision rather than adapting to someone else's.

The official website confirms that the game supports "custom maps, new buildings, processes and full overhauls," which means the modding ceiling is high. Whether you want to tweak a single recipe or replace the entire tech tree, the tools are already in your hands. Discover how to mod Sandustry effectively, find the best community creations, and start building content that other players will actually want to download.

Understanding Sandustry Mod Support Scope

Sandustry's mod support goes far beyond simple texture swaps or stat tweaks. The developer has positioned modding as a core pillar of the game's long-term design, which is why the simulation rewrite shown in the official Sandustry YouTube channel was such a significant milestone. That rewrite made the underlying systems more modular, allowing mods to hook into production logic without breaking the base game. Here is what the modding framework currently allows you to modify:

• Custom maps — Generate your own terrain layouts, resource distributions, and starting conditions for completely fresh playthroughs

• New buildings — Add machines with unique behaviors, custom animations, and specialized input/output configurations

• Production processes — Define new recipes, alter existing crafting chains, or create entirely new resource conversion loops

• Full overhauls — Replace the tech tree, rebalance the economy, or introduce new win conditions that change how the game plays

The modding tools ship directly with the game, so you do not need to hunt down third-party software just to get started. According to community reports from the official Discord, the developer actively shares new tooling updates and responds to modder feedback, which means the ecosystem is growing even before the Early Access launch.

The Simulation Rewrite and Why It Matters for Modders

The simulation rewrite that the developer showcased on YouTube was not just a performance improvement. It fundamentally changed how the game processes entities, resources, and production chains, making the codebase far more accessible for modders. When you create a custom building, for example, you are now working against a cleaner API that separates simulation logic from rendering, which reduces the risk of mods breaking when the base game updates.

This architectural shift also means mods can add new mechanics rather than just new content. A modder could theoretically introduce fluid simulation, power grids, or logistics networks that behave differently from the base game's systems. The official website's mention of "full overhauls" suggests the developer intends to support this level of modification, though the exact API surface will continue expanding after launch.

For players wondering how to mod Sandustry without prior experience, the key takeaway is that the barrier to entry is lower than most factory games. You do not need to reverse-engineer the game's internals because the tools are designed to be used by players, not just professional developers.

How to Mod Sandustry: Installation and Setup

Getting your first mod running in Sandustry is straightforward, but the exact steps depend on whether you are installing a community mod or creating your own. The game uses a dedicated mod folder structure that keeps custom content separate from your save files, which makes managing multiple mods much easier than older games that dumped everything into one directory.

The mod loader built into Sandustry scans the mod folder at startup and displays all detected mods in a simple toggle list. You can enable or disable mods without deleting files, which is essential when you are testing multiple creations or troubleshooting conflicts. The game also generates a log file that records which mods loaded successfully, helping you identify problems quickly.

Where Are Mods Stored and How to Organize Them

Sandustry stores mods in a dedicated folder that the game creates automatically on first launch. On Windows, this is typically located at Documents/Sandustry/Mods/, while Linux and macOS users will find it in their user data directory. Each mod should be placed in its own subfolder with a clear name, because the game uses folder names to identify mods in the manager.

Organizing your mods properly prevents a lot of headaches down the road. Community data suggests that players who maintain a clean mod folder experience fewer conflicts and can roll back changes more easily when an update breaks something. A simple naming convention like AuthorName_ModName_Version helps you track which mods are installed and when they were last updated. For players who want to dig deeper into the installation process, the mod installation guide covers advanced scenarios like manual dependency management and troubleshooting load failures.

Sandustry Modding Tools: What Ships with the Game

The developer has committed to shipping dedicated modding tools alongside the game, which is a significant advantage over titles that expect the community to build everything from scratch. These tools cover the two most common modding workflows: map creation and content definition.

The map editor is the most accessible entry point for new modders because it works visually rather than requiring code. You can sculpt terrain, paint resource nodes, and define the starting area, then export your creation as a custom map that other players can load. This is an excellent way to learn the modding workflow before tackling more complex content like custom machines.

Creating Custom Maps with the Built-in Editor

Custom maps are one of the most popular mod types in Sandustry because they completely change how the game plays. A well-designed map can force you to rethink your automation strategy, whether that means dealing with scarce resources, awkward terrain, or aggressive enemy placement.

The map editor provides a set of terrain brushes, resource placement tools, and environmental controls that let you shape the world to your specifications. You can adjust the density of ore deposits, control where water appears, and even set the starting technology level for players who want a faster or slower progression curve.

According to the official website, the game supports "custom maps" as a first-class feature, which means maps created in the editor are treated as legitimate content rather than unofficial hacks. This is important because it means custom maps work reliably across different game versions, and the developer is committed to maintaining compatibility as the game evolves.

Building Your First Mod: A Step-by-Step Tutorial

Creating a simple mod in Sandustry does not require programming experience, but understanding the basics of how mods are structured will save you time and frustration. The game uses a declarative format for defining content, which means you describe what you want rather than writing imperative code that tells the game how to do it. Here is a practical workflow for creating a custom recipe mod:

• Plan your content — Decide what you want to add or change, whether that is a new recipe, a building, or a map

• Set up your workspace — Create a folder in the mod directory with a unique name and a mod.json manifest file

• Define your content — Use the JSON schema to describe your building, recipe, or map properties

• Test in-game — Launch Sandustry and load your mod to verify it works as intended

• Iterate — Use the debug console to inspect issues and refine your content

The mod manifest file is the backbone of any Sandustry mod. It tells the game what your mod contains, which game version it targets, and how to load the content. The documentation browser included with the game provides examples and schema references, so you do not need to memorize the format.

Creating Custom Recipes and Buildings

Custom recipes are the simplest mods to create because they only require modifying existing data structures. You can add a new crafting recipe that converts one resource into another, adjust the output quantities of existing recipes, or create entirely new resource chains that connect previously unrelated materials.

Custom buildings require a bit more work because you need to define not just the recipe but also the building's visual appearance, input/output slots, and processing behavior. The content packager tool handles asset bundling, so you can include custom textures and models without manually managing file references. For a deeper dive into the technical side of mod development, the modding tutorial covers the JSON schema in detail and walks through creating a custom machine from scratch.

Finding the Best Sandustry Mods and Community Creations

Once you understand how to mod Sandustry, the next step is finding quality content created by other players. The community is already active despite the game not launching until August 13, 2026, with the developer sharing tools and mods through the official Sandustry Discord. The best Sandustry mods currently fall into several categories, based on what community members are requesting and creating:

• Quality-of-life improvements — UI tweaks, better resource tracking, and automation helpers

• Content expansions — New buildings, recipes, and resource types that extend the base game

• Challenge mods — Increased difficulty, resource scarcity, or new failure conditions

• Visual overhauls — Custom textures, lighting changes, and environmental effects

Evaluating Mod Quality and Compatibility

Not all mods are created equal, and the Sandustry community has developed informal standards for what makes a good mod. According to player reports, the most reliable mods share several characteristics: they are tested against the current game version, they include clear documentation, and they avoid modifying core systems unless absolutely necessary.

The community mod scene is still young, but the foundation is solid. Players who want to stay on top of new releases should join the Discord server, where the developer and community members share their latest creations. For a curated list of popular mods and what they do, check out the community mods guide.

Sandustry Mod Troubleshooting and Best Practices

Even well-made mods can cause problems, especially when the game updates or when multiple mods interact in unexpected ways. Understanding common failure modes and how to diagnose them will save you hours of frustration. The most common issues players encounter include:

• Mod fails to load — Usually caused by version mismatch or a missing dependency

• Game crashes on startup — Often related to conflicting mods or corrupted mod files

• Mods work but behave incorrectly — Typically a logic error in the mod itself

• Save file compatibility — Some mods cannot be removed from an existing save without breaking it

Preventing Conflicts and Keeping Saves Safe

The golden rule of Sandustry modding is to back up your save files before installing new mods. While the game is designed to handle mods gracefully, removing a mod that added new buildings or resources can corrupt a save that depends on that content.

Players who follow these practices report significantly fewer issues, and the community is generally helpful when problems do arise. The mod loader guide covers advanced troubleshooting scenarios and explains how to diagnose load failures using the game's log files.

Frequently Asked Questions

What is the easiest way to start modding Sandustry?

The easiest entry point is the built-in map editor, which requires no programming knowledge. You can create custom maps visually, export them, and share them with other players. Once you are comfortable with that workflow, move on to simple recipe mods using the JSON format and the documentation browser.

Do Sandustry mods work in multiplayer?

Sandustry mods work in multiplayer as long as all players have the same mods installed with matching versions. The game verifies mod lists when joining a session and will warn you if there are discrepancies. Full overhaul mods are more likely to cause desync issues, so test thoroughly before hosting a large group.

Will mods break when the game updates?

Mods can break when the game updates, especially if the update changes the simulation engine or content API. The developer has stated that modding is a priority, so major breaking changes should be rare, but always check mod compatibility after updating. The official Discord is the best place to get updates on which mods need fixes.

Can I create custom buildings without learning to code?

Yes, Sandustry's modding tools are designed to be accessible without programming experience. The content packager and JSON schema let you define buildings and recipes declaratively, and the documentation browser provides examples you can adapt. For more complex behaviors, you can learn the scripting API gradually as your skills improve.

Where can I share my Sandustry mods with other players?

The official Discord server is the primary hub for sharing and discovering mods, with dedicated channels for showcases and downloads. You can also share your creations on the Steam Workshop once the game launches into Early Access. The community is actively looking for quality content, so do not be shy about sharing your work.