Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

HOI4 Modding Studio

HOI4 Modding Studio

A fully-featured IDE for creating Hearts of Iron 4 mods. Works on Windows and Linux.

Features

  • Country builder with tag, politics, flags, portraits
  • Focus tree visual editor with drag-and-drop
  • State management and browser
  • World map viewer with adjacency browser
  • Event builder with effect catalog
  • Ideas / national spirit editor
  • Localization manager
  • Map generator
  • Dark / light theme support

Requirements

  • ImageMagick — required for DDS texture export
  • Python 3.11+ (if running from source)
  • PySide6, Pillow, numpy, scipy (auto-installed via pip if running from source)

Quick Start

Windows

  1. Install ImageMagick (check "Install legacy utilities" during setup)
  2. Download HOI4-Modding-Studio-Windows.zip from Releases
  3. Unzip and run HOI4 Modding Studio.exe

Antivirus note: The .exe is built with PyInstaller. Some antivirus software (Windows Defender, etc.) may flag it as a false positive because PyInstaller's bootloader resembles self-extracting archives. This is a known issue affecting all PyInstaller apps. The source code is fully open — you can build from source or submit a false positive report to Microsoft if you prefer.

Install from source

python -m venv venv
source venv/bin/activate          # Linux
# venv\Scripts\activate           # Windows
pip install -r requirements.txt
python run.py

Development

pip install -r requirements.txt
python -m mypy src/
python -m pytest tests/
python run.py

Building Windows .exe

pip install pyinstaller>=6.0
pyinstaller hoi4_studio.spec
# Output: dist/HOI4 Modding Studio/

CI builds automatically on v* tags via GitHub Actions.

See CONTRIBUTING.md for detailed contribution guidelines.

About

No description, website, or topics provided.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages