Multi-Language System Plugin v1.1.0 by Open Digital World​ 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.
Multi-Language System Plugin v1.1.0
by Open Digital World
​
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:
Code:
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):
Code:
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.
Special thanks
Thanks to
@Raizen for allowing me to extend his plugin and to publish a completely reworked version.
Download Link
ODW_MultiLanguageSystem.js (itch.io)
​
v1.0.0 - 21.10.2021
v1.0.1 - 19.09.2022
- Fixed a processing bug when the text has the ${} pattern twice or more.
v1.0.2 - 03.08.2023
- Fixed a syntax error in the $.updateIndex() function.
v1.0.3 - 07.09.2023
- Rewrite the text database load process.
v1.0.4 - 19.11.2023
- Revert the changes made in v1.0.3, to load the text database later in the game boot process.
v1.1.0 - 25.05.2024
- Improved the documentation.
- Improved the code for parsing language settings.
- Added new font settings per language.
- Added a new global parameter to display/hide the error log in the console.
- Removed the $.getCodes() and $.getLabels() functions.
- Removed the $._isDatabaseLoaded property and $.isDatabaseLoaded() function.
- Removed the compatibility code for VisuStellaMZ plugins (replaced by a patch).
- Created patch for Galv MZ plugins.
- Created patch for VisuStella MZ plugins.
Terms of use This plugin is published under the MIT License. Special thanks Thanks to @Raizen for allowing me to extend his plugin and to publish a completely reworked version.