Page cover image

How to translate a Mod

[Knowledge of WolvenKit at BASIC level is required] Below we will explain how to translate any mod


This guide will teach you how to translate a mod. It will cover the following processes:

There are mainly two ways to translate a mod. One is to use WolvenKit, GIT and GitHub. On the other hand, the author of the mod provides the files (an Excel sheet for example) where the sentences to be translated are written.


You need a Wolvenkit Project with the relevant files from the original mod:

  • .wem for audio translations

  • .json for text translations

For how to get there, see Analysing other mods

Translating audio files

Most mods will be using in-game files for this. You'll run into one of two cases:

The files are linked

The mod is only "pointing" at the original game files, and they're loaded from the player's local copy and will be in whatever language they're running.

TODO: Which file(s) defines those? If there is no original mod author and the mod links to in-game files, how can we custompath them?

If you want to translate them anyway, you need to add the audio files from your translated version to your Wolvenkit project and send them to the original mod's author.

The files are included

Assuming that the original mod author did not rename the files, this makes it easier for you.

  1. Add the file to your Wolvenkit project

  2. Overwrite the original file

When you pack your mod now, it will use the translated files. If it doesn't, make sure to check your load order.

The files were all re-named, how do I find them?

To filter the files by quest, use Reference: Quest Ids and filter the folder names by quest ID. If you don't know which quest a line belongs to, you might be lucky and find it per search (Hotkey: Ctrl+F) on the Cyberpunk Transcript.

Translating in-game texts

If you are lucky, you are translating this for someone else, and the person has given you an excel sheet. Otherwise, you need to edit the mod's .json files (see Prerequisites).

Publishing your changes

When you are done translating you can contact the original mod author to see if they want to include your changes into the main mod.

If not, then you can pack your mod as a standalone addition and upload it independently. In this case, it is important to consider the Load Order: your mod has to load first.

Last updated