This project provides tools and reusable classes to parse and analyze Hearts of Iron IV™ game data files.
Hearts of Iron IV™ data files' syntax (should) conform to what’s described in the wiki. There are currently some problems I’ve found.
The syntax is a bit similar to JSON, that’s why the tools are implemented using Jackson library.
Currently I have implemented:
-
streaming implementation of
com.fasterxml.jackson.core.JsonParserthat generates JSON-like events when parsing Hearts of Iron IV™ data files. -
dedicated
com.fasterxml.jackson.databind.node.JsonNodeFactorythat allows duplicate fields inside objects (scopes).
Currently everything is still running as JUnit tests. Some tests parse artificial data files and some tests require access to actual Steam library to get real game data files which can’t be (I guess) part of git repository.
To run all non-Steam dependant tests, just execute:
mvn clean test
To run all tests that require game data files, execute (Linux):
mvn clean test -Dsteam.dir=/data/steam/steamapps/common
(Hearts of Iron IV directory is expected to reside in ${steam.dir}.)
To start Spring based standalone web application that provides RESTful API, run:
cd hoi4db-web mvn exec:java -Dsteam.dir=/data/steam/steamapps/common
To start Angular frontend, run:
cd hoi4db-web-ui npm run start
Both streaming parser and dedicated jackson-databind classes support construction of Hearts of Iron IV™ data model which I plan to use for:
-
generation of stats, tables, spreadsheets
-
comparison of different aspects of naval/air/land equipment between countries
-
…
Currently I have (manually crafted) googledoc spreadsheet with all generic ship designs. With the datamodel I want to generate more tables and possibly provide special Angular-based application to browse Hearts of Iron IV™ game data files.