The easiest way to manage your missing translation files for Paradox games (and more).
Download App »
Explore the docs »
Report Bug
·
Request Feature
- Generate missing localisation files for any language
- Generate files directly in the mod folder or in a custom folder
- View all the missing files, and acess it directly
- Working with multiple paradox games
- Opt-in each file to generate
- Deep check in the files for missing keys
- Extract automatically the missing files into a new custom mod
- Manage translation files (missing keys, side by side view, etc)
1. Download and install the app from the release page
You can use the standalone version, or the installer version. The installer version will create a shortcut on your desktop and in your start menu.
The tool will check all the mods in the selected folder, and generate the missing localisation files for the selected languages, based on the source language (english by default).
With the default options, no files will be overwritten, and the tool will only generate missing files.
The tool is mainly tested with Stellaris, but it should work with all Paradox games. But some parameters may be different from one game to another. If you have any issue, please report it.
Only tested on windows. It may work on other plaforms you can build it yourself, but i can't guarantee it will work.
I've tried to comment every function I've used and/or use explicit naming so you can easily check the code.
In brief, using the default functions and options, I have a script that parses all the files in all folders within a directory and filters out only the translation files: specifically, the .yml files located in the localization directory of the selected game.
For each file, it extracts the file paths from the source language and compares them to the file paths of the output language.
If the file doesn't exist, the script will copy the source file, replace the language keys in both the file content and the filename with the targeted language, and create the new file in the corresponding location.
For the "deep check" option I have planned: if the file exists in the targeted language, the script will read it and check for any missing keys that are present in the source file but not in the target file. However, this will require more parsing, so it's not for today.
As a non-English player, one thing that frustrates me in Paradox games is the way translations are handled in mods. When a modder chooses to create localization files for multiple languages, if there isn't a file for your language, the game only displays the translation tags, not even the English (or any other language) text.
Even if you're proficient in English, it's more comfortable to play in your native language, especially when most of the content is translated, with only a few mods remaining in English.
To help players like me, and modders who want to be more inclusive with minimal effort, I created this app. It generates localization files for any selected language using English files (and eventually other languages in future versions).
There have been several versions leading up to the current one, and I expect to keep improving it (I’ll try not to let another two years pass before the next update!).
Contributions are what make the open source community. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Don't hesitate to pm me on discord to talk about the app. You can find my tag lower.
As a translation tool, it need to be translated ! you can find the translation files in src/i18n
folder. Feel free to add your own language !
- Manage incomplete files (missing translation tag for example)
- Manage files with replace (don't remember why i've excluded these files)
See the open issues for a list of proposed features (and known issues).
This project is licensed under the Creative Commons Attribution - NonCommercial - ShareAlike 4.0 International license. You are free to share and adapt the content as long as proper attribution is given, it is not used for commercial purposes, and any derivative works are shared under the same license.
Project Link: https://github.com/khoeos/Paradox-mod-language-converter
$ npm run install
$ npm run dev
# For windows
$ npm run build:win
# For macOS
$ npm run build:mac
# For Linux
$ npm run build:linux
This project, Paradox Translation Toolkit, is an open-source tool developed by the community and is not affiliated with, endorsed by, or associated with Paradox Interactive in any way. All trademarks and copyrights related to Paradox Interactive and their games are the property of their respective owners. This tool is provided as-is for the purpose of modding and translation, with no guarantees or warranties.