/stellaris-map-generation

Extracts geopolitical data from Stellaris save game files

Primary LanguageJavaScriptMIT LicenseMIT

Stellaris map generation

Simple set of scripts bundled together with bash that:

  • reads Paradox save game files for Stellaris
  • parses them into JSON files via jomini parser
  • creates lightweight JSON data file containing basic information about empires, star systems etc.
  • passes this "geo" data into GraphViz to create regions:
    • star systems
    • empires
    • sectors
    • "independencies" - alliances and independent empires
  • those files can be used combined with data from save game to generate nice graphs with detailed information about game
  • take a look at basic usage repository for more details

Usage

  1. Locate Stellaris save game folder of your system.
  • On my Mac it's: /Users/<username>/Documents/Paradox Interactive/Stellaris/save games
  1. Locate ".sav" files. Copy them somewhere, and unzip it (they are really just zip archives)
  2. Inside there are 2 files. We're interesed in gamestate file
  3. Run:
sh generate.sh <your-gamestate-file-location> <output-directory>
  1. Enjoy the data!
  2. Pull request and forks are welcome. This game really needs better reporting!

Requirements

To run scripts you need an Unix system with:

  • bash
  • graphviz and neato execs on the system
  • node.js (tested on v6.9.4)
  • python (it's using 2.7.13 for some reason... not sure if the libs are working with Python 3)
  • installed dependencies (npm i, pip install -r utils/star-graph/requirments.txt)
  • feel free to update this if I forgot about some lib