Repository navigation
HOI4 Mod Setup 0.9.4
Download the installer for your computer:
- Windows: HOI4-Mod-Setup-windows-x64-setup.exe
- Mac (Apple silicon): HOI4-Mod-Setup-macos-arm64.dmg
- Mac (Intel): HOI4-Mod-Setup-macos-x64.dmg
- Linux x64 (AppImage): HOI4-Mod-Setup-linux-x64.AppImage
- Linux x64 (Debian/Ubuntu): HOI4-Mod-Setup-linux-x64.deb
Windows uses the .exe installer. On macOS, open the .dmg and move the app to Applications. On Linux x64, make the .AppImage executable and run it, or install the .deb with your Debian/Ubuntu package manager.
Changes
- Fix the experimental Gemini account sign-in (#94). Setup pre-selected "Sign in with Google" in the CLI's settings, so the CLI tried to sign in before its screen could ask for browser consent and stopped with "Authentication consent could not be obtained" (and kept failing on retry). The sign-in terminal now leaves the method unselected so the CLI asks, as an ordinary first run does; analysis still runs with the method fixed to Google sign-in.
- Download the kit once instead of as about 1,700 single files (#168). Setup now fetches the pinned commit as one archive from
codeload.github.com, checks every manifest-declared file against its size and SHA-256, and installs from that. The download is resumable and retried like other source requests. A file the archive does not hold correctly, and the whole install when the archive cannot be downloaded, falls back to the per-file route. Only the fixed repository's commit archive is approved, and nothing in the archive is trusted or used as a path.
Choose a main image provider and optional alternatives; the ChatGPT sign-in in hoi4-imagegen is the default. Coding clients remain independent of the setup assistant. Change image and live-testing providers later in Update and repair.
Optional live testing offers Clausewitz MCP by smerss, which requires native Linux HOI4 1.19.2 and manual Linux game/server setup. Follow the Linux setup guide; registration alone does not verify gameplay. Experimental HOI4 Live Tools is slower and not fully tested; its current upstream package supports Windows only, and the macOS scaffold is incomplete.
See the README and Quickstart for provider choices and setup steps.
The Windows installer uses the community certificate named ChaosX; Windows may show a publisher or reputation warning.
Community macOS packages use ad-hoc signing and are not Apple-notarized; macOS may block the first launch.
These free builds are not signed with a paid certificate, so Windows and macOS warn about an unknown publisher the first time. On Windows, click More info, then Run anyway. On macOS, open System Settings, then Privacy & Security, and click Open Anyway. The step-by-step guide has the details, and the release signing details explain why.
The source is public under the Apache License 2.0: https://github.com/klimPaskov/HOI4-Mod-Setup.