Victoria 3 Analysis

This repository contains code for analyzing Victoria 3 game data. A pinned submodule provides the separately licensed generated datasets and analytical artifacts used by the documentation and examples.

Features

Data Parsing

Supports

• building
• pop_need
• goods
• production_method(_group)
• technology

information parsing from the game files and exporting into structured formats for analysis.

Data Analysis

Supports

• Modelling and optimization of production chains based on the parsed data, allowing players to optimize their in-game production strategies.

Installation

pip install "https://github.com/ShabbyGayBar/victoria3-analysis/releases/download/v0.1.0/vic3_analysis-0.1.0-py3-none-any.whl"

For development purposes, you can clone the repository and install the package in editable mode:

git clone --recurse-submodules https://github.com/ShabbyGayBar/victoria3-analysis.git
cd victoria3-analysis
uv sync

For an existing checkout, initialize the pinned artifact repository with:

git submodule update --init --recursive

License

The original code, tests, examples, documentation, configuration, and analytical methods in this repository are licensed under the GNU General Public License, version 3 or (at your option) any later version, except where stated otherwise.

Generated data and analytical artifacts under artifacts/datasets/ and artifacts/analyses/ are derived from Victoria 3 game content and are excluded from the GPL license grant. The separate artifact repository's LICENSE describes their provenance, applicable terms, and affiliation disclaimer.

Revisions published before the commit that introduced GPL-3.0-or-later remain available under the MIT License terms that accompanied those revisions. This license change does not revoke those existing grants.