khoeos / Paradox-mod-language-converter

Help players and modders from many Paradox games to manage language and localisation files within mods

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


Logo

A simple app to generate localisation for your language, based on english version for Paradox's Games
Download App »

Explore the docs »

Report Bug · Request Feature

Table of Contents

  1. About The Project
  2. How It Work
  3. Todo
  4. Other Paradox Games
  5. Stacks
  6. Contributing
  7. License
  8. Contact

About The Project

As non english player, one thing that annoys me in paradox game, it's the management of translations inside mods. If a modder take the choice to create localisation files to have translation in multiple languages, if there is no files for your language, inside the game you'll only see translation tag, not even the english (ore any languages) texts.

Even if you're good at english, it's a comfort to play with our native language for most of the content with only some untranslated mods in english.

So to help all the players like me, and the modders who want to be more inclusive easily, i made this app which do the job of generate localisation files for any selected language from english files (from other languages later).

The first version was a simple script not user friendly at all, the second with an interface, but vanilla js and lot of bugs, and not developped for other paradox games, so i decided to upgrade it for the second time.

Only build and tested for windows, due to on the directory system being different from linux and macOs. I'll try to fix that later.

At this time, the app is mainly tested with stellaris, i've use it in eu4 and ck3, but it theorically work with all registered paradox game, see more lower

How it Work

If you know french, everything is commented, the translation will come later. Every variables and functions are in english though

More details soon

Other paradox games

Paradox's game mods use same type of files and folders for the localisation files, the difference is mainly around the name of theses files/folders (localization or localisation). So like I said, this app is mainly tested with stellaris and i've use it in ck3 and eu4, but as the same logic applies, i've done the specificities of the other games. But in some specific cases it may not work.

As the majority of paradox game manage the translation in the same way (CK3, EU4, Hoi4...) it'll normally work with them (hence the choice of the name), simply enter the mod folder path. As the script came with multiple filter to select the good file, and never overwrite existing files(exept with specific options), it'll normally not make problems, and even if it's the case, as everything is locally, you'll juste have to re-install the game.

Stacks

This app was made from the Vite electron starter by Maxstue Using Electron, React and tailwind The script was first pure javascript, and then converted to Typescript, as i'm a beginner with it i may be some bad code currently (we don't talk about :any) The script use Directory-tree.

Installation

Verify you have node and npm installed with the actual LTS release

  1. Clone the repository
  2. Make npm install
  3. Launch with npm start

You need to have yarn installed

How to Build

Soon

TODO

  • Manage incomplete files (missing translation tag for example)

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Don't hesitate to pm me on discord to talk about the app. You can find my tag lower.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Discord : khoeos / Khoéos#9117

Project Link: https://github.com/khoeos/Paradox-mod-language-converter

About

Help players and modders from many Paradox games to manage language and localisation files within mods

License:MIT License


Languages

Language:TypeScript 95.7%Language:CSS 2.3%Language:JavaScript 1.1%Language:HTML 0.9%