Stardeus Modding Enhancements and Guide

Stardeus has received a major modding upgrade—JSON patching.

This method allows modifications to core JSON files without overwriting them. Mods using this approach will be more reliable and compatible with future updates. Even better, multiple mods can patch the same core file, eliminating override issues.

The rest of this update post is a tutorial on how to create your own mods. If you're interested, keep reading! If not, just know that mods support will be even better going forward!

Stardeus Modding Guide

What is JSON

JSON stands for “JavaScript Object Notation”, a human-readable plain text format. If you want to learn more about JSON, here’s a good resource: https://www.w3schools.com/js/js_json_intro.asp

However, JSON is so simple that you can easily understand it just by looking at a few examples.

How Stardeus uses JSON files

In Stardeus, behaviors are defined in C# code, which you can also mod but it requires programming knowledge and significantly more effort.

Content and various parameters are defined in JSON files that the game loads at runtime. To illustrate this, let’s examine a device.

This is a Charge Station. It has various properties and behaviors. The game recognizes the Charge Station because it loads a JSON file that defines it:

You can find this definition in the Core mod*: Definitions/Objects/Devices/ChargeStation.json

* To open the contents of the Core mod, run Stardeus, then Main Menu > Mods > Core Game > Open Directory

This file specifies various properties of the Charge Station, such as the research required to unlock it and, most importantly, a list of Components.

Each Component block provides a specific function. Many of these components appear in other device definitions, but the ChargeStation component is what makes this device unique. Removing this component block would strip the Charge Station of its ability to recharge robots.

If you wanted the Charge Station to work twice as fast, you could change the ChargePerHour property from 25.0 to 50.0. However, modifying the Core mod directly means your changes would be overwritten when the game updates. In this guide, we’ll learn how to create mods that edit JSON files without altering the Core mod itself.

Beyond object definitions, Stardeus includes many other JSON files for configuring different aspects of the game. Tunable parameters, story events, species configurations, body parts, inventory items, character traits—even UI colors—are all defined in JSON and fully moddable.

Creating a Mod

The easiest way to create a new mod is to grab a copy of the empty mod here: https://github.com/kodolinija/stardeus-mod-empty

Download the project as a zip file, extract it in the user mods folder*, rename the extracted folder to match your mod name (I like using the kebab-case when naming folders).

* User mods folder is located next to the Saves folder. You can open it from Stardeus: Main Menu > Mods > About Mods > Open User Mods Directory

Then open the TODO.md file and go through the checklist:

- [ ] Update ModInfo.json - [ ] Create your own ModCover.jpg - [ ] Delete unnecessary directories

Run Stardeus and check if your empty mod appears in the Main Menu > Mods list. If it does, you're ready to start modding!

Changing Existing Behaviors and Parameters

Previously, modifying a JSON file required copying the entire file into your mod just to change a few lines. The game would then load the modded version instead of the original. The main problem with this method was that when the Core mod updated, the copied JSON file