Note: Mods are reloaded each time a map is restarted, allowing for quick testing of changes.
There are multiple ways to engage in modding Surviving Mars.
- Assets may be imported as .blend files, created within Blender.
- LUA scripting is supported and documentation is included within the Mod Editor in-game
- The Mod Editor itself is a proprietary system, accessed from the main menu
Above and beyond the in-game modding system, the HTML document that is automatically opened when you click on the Mod Editor is not the only source of documentation. The documentation that accompanies Surviving Mars is extensive. It can be found in the following folder: "...\steamapps\common\Surviving Mars\ModTools". Within this folder you will find two folders of interest: Docs, and Samples.
- Inside Docs is a series of HTML documents that spells out most functions and classes in the game, with verbose descriptions of how to utilize each and what they affect.
- Inside the Samples folder you'll encounter two more folders entitled "Assets," and "Mods".
Surviving Mars Reference LUA: https://github.com/surviving-mars/SurvivingMars
Pre-Made Mod Samples
Each of the mods that are present there were created by Haemimont and are also available to download from Steam. What you find in each sample's folder is each of the assets and all of the code that went into their creation, including notation about each function and method.
- Cemetary: an example of the OnMsg functions, and object interaction.
- TimeCapsule: an example of reading previous saves, building states, and map manipulation.
- ShadowedSolarPanels: an example of overriding an existing method to alter logic.
- SyntheticMeat: an example of adding a new crop.
- MedicalResearcher: an example of adding a new commander.
- The Mod Editor can be launched from the Main Menu and will load a small but completely self-sufficient colony.
- The Mod Editor allows for relatively easy creation of new mods. It also includes a cheat menu that can be used on new maps or existing saves.
The Mod Editor is not available on the Linux and Mac versions of the game.
List of Messages
DISCLAIMER: This section should be its own page. These names are the ones I've got from contacting the support.
See Technology IDs
The following is not a complete list, as more information is available it will be updated/corrected.
Locator Spots (Empties)
|Item||Meta Data Name|
|Item||Meta Data Name|
|Grid Spot Reserve Mesh||hex_shape|
Textures and UV Maps
> BaseColor (RGB) > Normal (RGB) > RoughnessMetallic (RGB) RG channels for Roughness ( 0 = Polished Surface | 1 = Rough Surface) B channel for Metalness (0 = Dielectric | 1 = Metal ) > Ambient Occlusion or AO (Grayscale) > Dust (Grayscale) 1 = Full dust 0 = No Dust > Emissive (Grayscale) 1.0 = Full Illumination 0 = No illumination
|Color Space||Texture Map||Texture Name|
|Grayscale||Ambient Occlusion Map||AO|
BaseColor Normal RoughnessMetallic AO