|
|
|
|
| Method | Instructions |
|---|---|
| 💾 Installer (Recommended) | Download TranslatorHoi4_Setup_*.exe → Run → Launch from Start Menu |
| 📦 Portable | Download TranslatorHoi4_Windows_*.zip → Extract → Run .exe |
| Method | Command |
|---|---|
| 📦 DEB (Debian/Ubuntu) | sudo dpkg -i translatorhoi4_*.deb && sudo apt-get install -f |
| 📦 RPM (Fedora/openSUSE) | sudo rpm -i translatorhoi4-*.rpm |
| 📦 AppImage | chmod +x TranslatorHoi4-*.AppImage && ./TranslatorHoi4-*.AppImage |
| 📦 Portable | tar -xzf TranslatorHoi4_Linux_*.tar.gz && ./TranslatorHoi4/TranslatorHoi4 |
Dependencies (if not using packages or when running the unpacked portable build):
# Debian/Ubuntu
sudo apt-get install libegl1 libopengl0 libgl1 libwayland-client0 \
libwayland-cursor0 libwayland-egl1 libxkbcommon0 libxkbcommon-x11-0 \
libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 \
libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-xinerama0 \
libdbus-1-3 libpulse0 libxrender1 libxi6 libxrandr2
# Fedora
sudo dnf install libglvnd-glx libwayland-client libwayland-cursor \
libwayland-egl libxkbcommon libxkbcommon-x11 libXcursor libXrandr \
libXi libXrender libxcb dbus-libs pulseaudio-libsWayland/X11 note: on Linux the app now prefers Wayland when launched inside a Wayland session and falls back to X11/XCB automatically. On X11 sessions it does the reverse, so the same build works on both stacks.
- Download
TranslatorHoi4_macOS_*.dmg - Open DMG file
- Drag
TranslatorHoi4.appto Applications - First launch: Right-click → Open (bypass Gatekeeper)
git clone https://github.com/Locon213/TranslatorHoi4.git
cd TranslatorHoi4
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python -m translatorhoi4TranslatorHoi4 now uses game-specific translation profiles to deliver higher quality localization:
| Game | Genre | Key Terminology |
|---|---|---|
| Hearts of Iron IV | WW2 Grand Strategy | Military, political, historical |
| Crusader Kings III | Medieval Dynasty Simulator | Feudal, dynastic, religious |
| Europa Universalis IV | Early Modern Strategy | Colonial, diplomatic, trade |
| Stellaris | Sci-Fi Grand Strategy | Space exploration, futuristic |
| Victoria 3 | Industrial Era Strategy | Economic, social, industrial |
| Imperator: Rome | Ancient Strategy | Classical, Hellenistic, Roman |
Translating a My Little Pony mod for HoI4? A Cold War Modern total conversion? No problem!
Just enter your mod's theme in the Mod Theme field and AI will adapt its vocabulary accordingly:
Game: Hearts of Iron IV
Mod Theme: My Little Pony, Friendship is Magic
AI will use appropriate MLP terminology while preserving game mechanics tokens like $VARS$ and [macros].
- ✅ 8 critical rules instead of 2 — better protection against AI hallucinations
- ✅ Game-specific terminology — military terms for HoI4, medieval for CK3, sci-fi for Stellaris
- ✅ Token preservation —
$VARS$,[Scripted.Macros],\nkept intact - ✅ Context-aware translation — AI understands the game's genre, style, and period
- ✅ Mod theme override — custom themes override default game vocabulary when needed
| Feature | Benefit |
|---|---|
| 💰 Completely Free | No paid tiers, no credit card required |
| ⚡ Ultra Fast | Optimized inference infrastructure |
| 🏆 Quality Models | Llama 4, Mixtral, and more |
| 🔒 Official API | Stable, reliable, enterprise-grade |
Setup in 60 seconds:
- Go to build.nvidia.com
- Sign in with NVIDIA account
- Generate API key
- Paste key in TranslatorHoi4 settings → Start translating!
- Launch TranslatorHoi4
- Configure AI provider in Settings (⚙️)
- Select source mod folder
- Choose target language
- Translate!
Click to expand full provider list
| Provider | Best For | Free Tier | Speed |
|---|---|---|---|
| NVIDIA NIM | Testing & development | ✅ Unlimited | ⚡⚡⚡ |
| Groq | Production translation | ✅ Generous | ⚡⚡⚡ |
| Google Gemini | General purpose | ✅ Limited | ⚡⚡ |
| Mistral AI | European languages | ✅ Limited | ⚡⚡ |
| Together.ai | Open-source models | ✅ Limited | ⚡⚡ |
| OpenAI | Premium quality | ❌ | ⚡⚡ |
| Anthropic | Complex context | ❌ | ⚡⚡ |
| DeepL | Professional quality | ❌ | ⚡⚡ |
| Ollama | Privacy-focused (local) | ✅ Unlimited | ⚡ |
| G4F | Community alternative | ✅ Unlimited | ⚡ |
translatorhoi4/
├── translator/ # Translation engines & backends
├── parsers/ # Paradox file parsers
├── ui/ # Modern Fluent UI components
├── utils/ # Utilities & helpers
└── app.py # Application entry point
pip install -r requirements.txt
python build.py # Output: dist/TranslatorHoi4/
Made with ❤️ for Paradox Modding Community