Instructions in english

1º - Extract the Rpy files from the game:

Requirements:

• unrpyc

Steps to follow:

1. Download the file named "un.rpyc"
2. Copy the file inside the “game” folder, at the directory of the game you want to translate.
3. Execute the game and wait for the opening screen. Once you reach it, open the folder again and you will see newly generated files with the “.rpy” extension. These are the files you will use to translate the game.

2º - Generate the translation files.

Requirements:

• RenPy SDK

Steps to follow:

1. Download the RenPy version corresponding to your operating system, and then extract it.
2. Move the folder from the game into the generated folder after extracting the SDK, and then execute it.

3. Click on the name with the video game folder (in this case, “DDLC-1.1.1-pc”) and then click on “Generate Translations”. 4. Write your preferred language and then click once more on “Generate Translations”. 5. Wait for a bit and, once this window pops up, proceed on to the next step.

3º Use Monika to export and import the files

Requirements:

Monika

Steps to follow:

1. Go to the game/tl/(your language) folder, and you will find a series of folders and/or files with the “.rpy” extension.
2. Copy the program to that folder and create a new file called “Characters.map”.
3. This file will contain every character name, which will help you know who is speaking at any given string. For example, if you open a .rpy file (like “script-ch0.rpy”), you will see these “tags”:
4. The character names are usually located inside the “script.rpy” or the “definitions.rpy” files located within the “game” folder, which is why you will have to go to that folder and open them:
5. At first, you may find some names in “scripts”, but not all of them. If you look for more names in “definitions” by, for example, searching for the “define mc” string, you will find the missing ones:
6. Now that you know who is saying what, write the character names in the “Characters.map” file like this: tag=name

7. Save the file.
8. Now, return to the folder you were at back when you started following these steps. We will be using the “script-ch0.rpy” file as an example, and we will start translating it. Open a command prompt and write the following line: Monika -export "script-ch0.rpy"

9. A file called “script-ch0.po” will be then generated.

10. This file will allow you to translate the game, so you can pick your preferred translation tool at this point (such as PoEdit, Weblate, MemoQ…).
11. After you have finished the translation, write the following line on the same command prompt: Monika -import "script-ch0.rpy"
12. A file called “script-ch0_new.rpy” will have been created, so delete the original file, rename this one with the name the old one had, and proceed on to the next section:

You can now follow two routes: either insert a language selector, or force the game to read your specific language.

4º Route 1 - Force the game to read your specific language

Steps to follow

1. At the "game" folder of the video game, open the "options.rpy" file.

2. Insert at the very top of the file these two lines (change "Spanish" for your preferred language):

• define config.default_language = "Spanish"
  

• define config.language = "Spanish"
  

3. Then, save the file.

4º Route 2 - Insert the language selector into the video game.

Steps to follow

1. While on the “game” folder from the video game, open the file “screens.rpy” with your preferred text editor.

2. Search “screen preferences()” and go to the end of the block.

3. Add the following code to the end of the hbox, then save the file.

• hbox:
  

•     vbox:
  

•         style_prefix "radio"
  

•         label _("Language")
  

•         textbutton _("English") action Language(None)
  

•         textbutton _("Spanish") action Language("Spanish")
  

• (Change “Spanish” to your preferred language).

4. Start the game, go to Settings and select your language.

5º- Checking the edits

Steps to follow

• Start the game and then check if everything is working as it should.