Troubleshooting

HomeModdingTroubleshooting

Various troubleshooting tips for modding.

Crashes or errors

Whenever the game crashes it will log an exception in this format in the SE log:

<date&time> - Thread:   <thread#> ->  Exception occurred: <ExceptionType>: <ExceptionMessage>
   at Some.NameSpace.SomeMethod(...)
   at SomeOther.Name.Space.RunThat(...)
   at DeeperStuff.DoThing(...)
   etc.

This is often hard to decipher especially if you are not familiar with the game's insides.
Regardless, these errors are very important to figuring out why it crashed, if not by you then by the people you ask to look into them, so please report the whole chunk or preferably send the whole log file when reporting crashes anywhere.

Path to troubleshooting errors/crashes:

1. Check the list of Known solutions to crashes or errors, if it's not there then proceed to the next steps.
2. If you're not using any mods, report it on Keen's support site.
3. If you're using mods but not making a mod, then look at the error's "at ..." parts to see if there's a hint of a mod name or author name there.
   1. If you identified the mod then report it on the mod's workshop page.
   2. If you can't identify it, ask in Keen's Discord server at #modding-programming and mention that you are not making a mod.
4. If you are making the mod that is crashing, then ask in Keen's Discord server:
   1. C# mod at #modding-programming channel.
   2. SBC mod at #modding-art-sbc channel.

Changes don't apply

In general you need a world reload to see your various modding changes.
However some things require something more.

Changes requiring a full game restart

• Empties/dummies, colliders and animations in models (.mwm files)
• <EmissiveColorStatePreset> and <EmissiveColor> (EmissiveColors.sbc)
• Errors during loading - this usually causes more strange issues with script mods because it does not notify them that the world exited, leaving events, file hooks, etc alive

Changes requiring something special

• Inventory stats - Requires placing a new block because inventory volume and constraints are saved in the save file
• Planet gravity - Requires re-spawning the planet because it saves gravity to save file
• Textures linked by SBC (TransparentMaterial, Icon, Camera OverlayTexture, etc) - Use F11 menu's Reload Textures (can do without world reload)