Multi-Language System Plugin for RPG Maker MZ

Introduction

This plugin lets you translate game texts to suit your needs. Texts are simply written in JSON files, grouped in language-specific folders. It is also possible to configure fonts specifically for each language. The active language can be selected from the game options window.

NOTE: This plugin is a full rewritten and extended version of the Ignis Text Database plugin by Raizen. Also inspired by some features present in the DKTools Localization plugin by DK.

Features

• Adds an option to choose the game language.
• Adds the possibility of having a specific font per language.
• Translates almost all database and event command texts, including hard-coded texts in RPG Maker MZ code (see comments here).
• Offers ready-to-use patches for Galv and VisuStella plugins.

During a game, go to the options to change the language by pressing or simply clicking on the language option. Texts will be translated instantly.

How to use

1. Install and configure your plugin. Please note that the first language in the "Languages" settings list will be the default language of the game. You can reorder them as you want in the option box.

2. Place the font files for your languages in the "fonts" folder at the root of your game project:

RMMZ Project Folder
   |_ Fonts Folder
      |_ Font 0.woff
      |_ Font 1.woff

3. Create the language folders and files according to your plugin settings, as follows (folder and file names are case sensitive):

RMMZ Project Folder
   |_ Root Folder
      |_ Language Folder => Language [0]
         |_ Language File [0].json
         |_ Language File [1].json
         |_ ...
      |_ Language Folder => Language [1]
         |_ Language File [0].json
         |_ Language File [1].json
         |_ ...

4. Develop your game, and for each text you want to translate, make sure you follow the correct syntax below:

=> In a text field of the RMMZ editor (database, message, plugin settings):

${text code}

=> In a language file (JSON syntax):

"text code": "text to display"

=> To use the the control characters in translated texts (like color, icon, variable, ...), double escape them like this in the "text to display":

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

=> You can also nest translated texts like this in the "text to display":

"Text1": "an example",
"Text2": "My text 1 is ${Text1}
-> Displayed result = My text is an example.

5. During a game play, you can change the current active language in the game option window.

See also README.md for more information about settings, commands, ...

Terms of use

This plugin is published under the MIT License.

Support and feedbacks

For plugin support, please join us here.

Special thanks

Thanks to Raizen for allowing me to extend his plugin and to publish a completely reworked version.