If you are playing Sins of Solar Empire II and are trying to add and use mods, but can't seem to get them working because it keeps showing a JSON read error that looks like this: json read errors in 'C:\Users\Public\mod.io\5762\mods\4501468\gui\hud_ship_window.gui'. [content_window.action_bar] key not found: 'action_stack_panel'. This article will explain what is happening and how you can fix it. Just don't expect to always get a happy ending with this one!
Takeaways:
- Learn How to Fix the “json read errors” Mod Issue in Sins of a Solar Empire II
- Sins of a Solar Empire II mods not working Json error message appears.
Table of Contents
Why the Error Appears
Whenever Sins of a Solar Empire II gets a new patch, its internal data structure usually changes. These updates can alter how user interface files, such as .gui or .json files, are read by the game. And since mods rely on these files to add new HUD elements, ship windows, gameplay menus and just about everything else this is a problem!
When the developers modify or rename a key within these structures, older mods may reference items that no longer exist. In this case, the error mentions the missing key 'action_stack_panel' within the file hud_ship_window.gui. The game is trying to locate this element in the mod’s interface file, but cannot find it because the new version of the game handles that section differently.
How to Fix the “json read errors” Mod Issue in Sins of a Solar Empire II
The most effective and reliable solution is simply to wait for the mod author to release an update. Mod creators are generally quick to respond to game patches, especially when compatibility issues like this arise. Once the mod is updated, it will include the necessary changes to match the game’s new internal structure, resolving the JSON read errors automatically.
Check the mod’s page on Mod.io or any other platform where it is hosted. Most creators post notes or changelogs when updates go live, often mentioning compatibility with specific game versions. Alternatively, you can just try to apply the mod every so often until it works one day. You should also keep an eye out for new mods that essentially do the same thing. More often than not, there are multiple mods that increase fleet capacity, for example.
Avoid Manual Edits Unless Experienced
It might be tempting to try editing the .gui or .json files yourself to remove or rename the missing key. However, this can easily introduce more problems. Unless you have experience working with Sins of a Solar Empire’s data formats, it is best to leave these files unchanged. Incorrect edits may cause crashes or prevent the game from launching altogether.
Disable the Mod
Use the in-game mod manager to uncheck the problematic mod. Alternatively, move its folder out of the Mod.io directory to prevent it from loading when the game starts.
Restart Sins of a Solar Empire II
Once the mod is disabled, restart Sins of a Solar Empire 2. The JSON read errors should no longer appear, and the game will run normally using only active, compatible mods.
Wait for Mod Updates (Might take a while)
Keep an eye on the mod’s official page or community discussions. Other players often share updated news or temporary fixes provided by the mod creator. Once a compatible version is available, reinstall or re-enable the mod through the Mod.io interface. I have been playing with the Star Gate mod since the Star Wars mode broke. It's a nice change.
After the Mod Update
When the mod author releases an updated version, install it through the normal mod platform and launch the game again. The missing key error should no longer appear, and all GUI elements should function as expected. You can then safely re-enable any other mods you had disabled during troubleshooting.
