Skip to content
This repository has been archived by the owner on Feb 15, 2024. It is now read-only.

Extracts geopolitical data from Stellaris save game files

License

Notifications You must be signed in to change notification settings

jakubjafra/stellaris-map-generation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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