ODW - Multi-Language System Plugin

じ☆ve冰风

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:       

1. RMMZ Project Folder
2.    |_ Fonts Folder
3.       |_ Font 0.woff
4.       |_ 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:       

1. RMMZ Project Folder
2.    |_ Root Folder
3.       |_ Language Folder => Language [0]
4.          |_ Language File [0].json
5.          |_ Language File [1].json
6.          |_ ...
7.       |_ Language Folder => Language [1]
8.          |_ Language File [0].json
9.          |_ Language File [1].json
10.          |_ ...

复制代码

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):

1. ${text code}

复制代码

=> In a language file (JSON syntax):

1. "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":

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

复制代码

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

1. "Text1": "an example",

复制代码

1. "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)
​

Spoiler: Screenshots

Spoiler: Update Log

v1.0.0 - 21.10.2021

• Initial release.
  

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.
  

本贴来自国际rpgmaker官方论坛作者:r66r处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/odw-multi-language-system-plugin.141442/