Skymods

Victoria 3 Mods Catalogue

AI-Powered MOD Translator – One-Click Support for 10 Languages!

Uploaded ·

If you liked this item, please rate it up on Steam Workshop page.

Author: Longling

Last revision: 31 Jul, 2025 at 11:55 UTC

File size: 294.56 KB

On Steam Workshop

Description:

AI-Powered MOD Translator – One-Click Support for 10 Languages!
Now support stellaris mod

Important: This is not a content MOD! Loading it in the launcher will have no effect.
This is a standalone Python-based translation tool for MOD developers and localizers. Please read the instructions carefully.

What is this?

Ever wanted to translate your favourite large-scale MOD, but felt overwhelmed by tens of thousands of text entries?
Ever wished to make your own MOD multilingual, but lacked the time or manpower?

Victoria 3 MOD Localization Factory was born to solve exactly those problems.

It is a modular automation workflow built with Python and Google Gemini API, designed to fully automate the initial translation phase of MOD localization.
What used to take hours of manual labour can now be done in minutes, letting you focus on polishing and quality improvement.

This project is open-source on GitHub – contributions welcome:
https://github.com/Drlinglong/V3_Mod_Localization_Factory
Released under the CC BY-NC-SA 4.0 License[creativecommons.org].

From a humble village on the Seven Hills,
I now offer it to all pioneers who seek to bridge the boundaries of language.
Perhaps, if others join me,
it may one day thrive like Rome.

Vision: Translation should never be a barrier

Not everyone speaks eight languages fluently.
Even if you do, you probably don’t want to manually decipher MOD flavour texts after a long day.

This project aims to simplify the process — so that:

When you see a MOD you love, a few clicks are all you need to enjoy it in your native language.

It’s not about perfect translation —
It’s about making translation no longer a barrier to sharing creativity.

We hope:

  • Players can localize excellent MODs from the Workshop with a single click — even if just roughly — and enjoy them right away;
  • Multilingual creators can generate rough drafts quickly, then polish them later instead of being trapped in repetitive work;
  • Local communities can participate more easily in building the global MOD ecosystem.

This is a tool for creative freedom —
A project in service of expression, comprehension, and co-creation.

Using AI, it aims to dissolve language boundaries, one line at a time.

In the age of AI and large language models, language should no longer divide players and communities.

What can it do? (Core Features)
  • Multilingual translation: Supports translation between any of the 11 official Victoria 3 languages;
  • One-click multilingual mode: Translates one source language into the other 10 with a single command;
  • Full MOD package handling: Automatically processes .yml files (including subfolders), translates metadata.json, and copies thumbnail.png;
  • Robust parser: Specially designed to handle PDX-style .yml syntax and extract all valid text;
  • Smart batch processing: Splits large files into chunks to ensure higher API success rates;
  • Internationalized CLI: Command-line interface supports both English and Simplified Chinese;
  • Safe fallback system: Auto-generates English originals as backups when translation fails.

Who is this for?
    [] MOD localizers passionate about translation but limited on time or resources;[] MOD creators wanting to build multilingual drafts quickly;

  • DIY MOD players who know basic Python and how to configure API keys.

How to Use

This tool is run independently on your PC. It is not part of the game launcher.

Step 1: Preparation

  • Download the project: GitHub Link[github.com]
  • Install Python: Python 3.8 or higher is recommended
  • Get an API key: Go to Google AI Studio[aistudio.google.com] and create your own Gemini API key

Step 2: Installation & Setup

  • Install dependencies: pip install –upgrade google-genai
  • Set your API key: Add a system environment variable named GEMINI_API_KEY
  • Place your MOD files: Put the MOD folder to be translated into the source_mod directory

Step 3: Run the Script

  • Open terminal (CMD or PowerShell) in the project root
  • Run: python scripts/main.py
  • Follow the prompts. Your translated MOD will be output in the my_translation folder

How to Use the Translated MOD In-Game

After translation, locate your output folder in my_translation. It may be named e.g. ZH-, FR-, or Multilanguage-, depending on your selection

Copy this folder into Documents/Paradox Interactive/Victoria 3/mod. (Create the mod folder if it doesn’t exist)

Restart Victoria 3 and open the launcher. Edit the playset you want to use

Add the translation MOD below the original MOD in load order

Launch the game from this playset

🎉 Enjoy the game in your language!

Project Status

This is an open-source project. The core functionality is complete. Future roadmap includes:

  • Custom terminology dictionaries
  • Incremental translation updates
  • Support for MODs from other Paradox titles

Feedback and PRs are welcome!
All code is generated with LLMs. Debugging and testing is human-assisted.

Showcase

Chinese Translation – #MODJAM2025
https://steamcommunity.com/sharedfiles/filedetails/?id=3539371366

Project Utopia – Multilingual Patch
https://steamcommunity.com/sharedfiles/filedetails/?id=3538713092

Project Utopia – Extended Timeline (Simplified Chinese)
https://steamcommunity.com/sharedfiles/filedetails/?id=3537967277

Australia & New Zealand Flavor Pack (Simplified Chinese)
https://steamcommunity.com/sharedfiles/filedetails/?id=3441144175

Download