Stellaris involves a lot of micromanagement that's pretty mechanical (e.g. remembering to use Festival of Worlds, checking that all your mining/research stations are built). This tool reads your saves to track those details and alert you when something needs fixing.

Turn on monthly autosave and watch your empire while you play!

How do I run it?

Requirements

• Python
• Go

One-off

ed check.py  # Edit the script to point TARGET_COUNTRIES at the player-controlled countries you want to analyze
go build sav2json.go
./sav2json -infile autosave_2241.04.01.sav > gamestate.json
./check.py gamestate.json

sav2json uses an ANTLR-generated parser to convert to a regrettable JSON format. check.py ingests said JSON to analyze the game state for some tedious-to-keep-track-of problems and prints out any that need addressing.

Monitoring while you play

ed check.py  # Edit the script to point TARGET_COUNTRIES at the player-controlled countries you want to analyze
go build sav2json.go
nice -n19 ./autosave_poller.py $STELLARIS_SAVE_FOLDER/mpinterstellarorchorde2_1013776793/

This script watches the savegame directory for new autosaves, and reruns the toolchain when it sees one.

Set Stellaris to autosave monthly. It doesn't matter whether "Save to Cloud" is enabled; this only affects the save game folder path you need to point the poller at.

Known bugs

• When Stellaris loads a save game, it does not load the monthly income numbers recorded in the save file. Instead, it recalculates them from scratch - incorrectly. As a result, using enumerate_trades.py on the save file will not generate trades that actually work in-game until you hit a month rollover, autosave, and run enumerate_trades on THAT.

Feature ideas

✔ = implemented!️

check.py

• Detect research agreement participants researching the same technology simultaneously ✔️
• Agreement checks️
  • Artisan troupe
    • Patron deal ✔
    • Festival of Worlds ✔
    • Monuments
      • All purchased
      • All exhibited
  • Curator order
    • Research agreement ✔️
• Resource deposits without stations ✔️
• Scientist misallocation
• Election influence budget
  • When is your next election?
  • More importantly: are you on track to have enough influence?
  • How much influence can you safely spend?
• Advanced job allocation
  • Detect pointless job usages
  • Resource stockpile full
  • Too many bureaucrats
  • Too few bureaucrats
    • Detect when switching a scientist to a bureaucrat would speed up research
    • Detect when switching a culture worker to a bureaucrat would speed up next tradition adoption
• Corporate empires
  • Branch office candidates
  • Commercial pact prospects
• Can you analyze
  • the market?
    • Overselling from autobuys
    • Autobuys that are NOPping because you're resource-capped
  • Diplomacy
    • prospective commercial pacts?
    • prospective trade deals?
    • prospective research agreements? (mostly care about coarse relative tech and acceptancy)
• Allied economic analysis (by agreement, of course!)
• Leader pool monitoring
  • Spark of Genius
  • Scientist specialties
• Planet administrivia
  • Machine assembly plants not built
  • Available capital upgrade
  • (if enabled) distribute luxury goods reminders?
  • Optimal planet designation
• Colonization targets in your space
• Alert when your neighbor's relative fleet power is "Superior" or higher.
• (if you can figure out how to write the save format) Modify save to have an optimal setup
  • Meticulous scientists
  • Scientists with the optimal specialties for the "make research faster" techs

enumerate_trades.py

• N-hop trades:
  • Sometimes you can trade energy for food, then food for alloys at a better exchange rate than energy directly for alloys.
  • Are there N-hop arbitrages, too?