Rpg Maker Developers Group

For the plugin to work, you need to install Phileas's File Manager.
If you need commands to export and import language data to XLSX, then install the XLSX library.
You can delete the library file before deploying the game to save space.

1. Configure the "Languages" parameter. Set the language codes. It is important that they are unique.

2. Create a "languages" folder in the root of the project.

3. In the "languages" folder, create language folders, name each folder must match the language code.

4. Create a "main.json" file in each language folder. It will store the root properties of the language dictionary. There must be an object (curly brackets) at the root of this file.

5. You can add other localization files. It is important that the list of files in each language data folder matches. You can create subfolders of any level.

6. At the root of the file should be either an object (curly brackets) or an array (square brackets).

7. Fill in the localization files with text. The structures of all objects must match, only the final string values can differ.

8. To use localized text in the game, type a line like this in the right place:

${<text code>}

<text code>
The text code should lead to the value in the localization files.

9. The properties specified in "languages/<text code>/main.json", will be at the root of the localization dictionary. For example, if main is set like this:



To use this value, type this:
${yes}

10. If the property is specified in another file, then you need to specify the path to the file before its name. For example, if you have a file with the path "../languages/<text code>/chapter_1/dialogues.json" and such a structure:



To use this value, type this:
${chapter_1.dialogues.point_0}

11. In addition to objects, you can use arrays. Let's change the example from point 9:


To use these values, type this:
${chapter_1.dialogues.point_0[0]}
${chapter_1.dialogues.point_0[1]}

12. The array can be located right at the root of the localization file (except for the "main.json"). Let's change the example from paragraph 10:


To use these values, type this:
${chapter_1.dialogues[0][0]}
${chapter_1.dialogues[0][1]}

13. You can optionally nest objects and arrays into each other. The nesting level is unlimited!

14. You can also use the translated text inside the translated text:



15. To use control symbols to set text, use a variable,
icon, and more, add a second slash:

\C[0] -> \\C[0] OR \V[1] -> \\V[1] OR \. -> \\.

16. The plugin provides the following commands:

• "Set the language" - changes the current language localization.

LOCALIZED RESOURCES (MEDIA)
You can use different files (audio, images, video) for each language.
The function works for all types of images (animations, pictures, tilesets and others), all types of audio (BGM, BGS, ME, SE) and video (movies).

Manual:

1. The language specified first in the "Languages" parameter is considered the default language. For example, the default language may be with the code "en".
2. Place the media file to the directory you need. This should be a file for the default language. For example, you can execute an image in the "img/pictures" directory. Let it be "a.png":
   "img/pictures/a.png"
3. If you want another image for a different language to appear instead of this image, create a folder in the same directory. Its name must match the code of the desired language. Example:
   "img/pictures/ru".
4. In this new directory, create a media file with the same name and relative path:
   "img/pictures/ru/a.png".
5. In the "Show Picture" command, select the file for the default language. If a second language is enabled in the game settings, a picture for this language will appear.
6. You don't have to create a separate file for each language. If a file for any language is not found, the file for the default language will be used.
7. You can use subfolders. Then the relative paths must match. Example:
   "img/pictures/sub_folder/b.png"
   "img/pictures/ru/sub_folder/b.png"

COMPATIBILITY WITH OTHER PLUGINS
The plugin is compatible with "Phileas's Text Wrap".
Place this plugin under "Phileas's Text Wrap" in the Plugin Manager.

The plugin is compatible with "TAA_BookMenu".
Place this plugin under "TAA_BookMenu" in the Plugin Manager.

If you are using "Phileas's Language Localization", "Phileas's Text Wrap" and "TAA_BookMenu" at the same time, arrange them exactly in this order in the Plugin Manager:

1. TAA_BookMenu
2. Phileas_TextWrap
3. Phileas_LanguageLocalisation