Localization - Translate your project into several languages

DK · 2020-08-29T01:54:45+0900

Author: DKPlugins Version: 1.5.0 Description: Localization of game. Translate your project into several languages. Requirements and dependencies: Availability of working plugin DKTools version 1.3.5 or above Features: Unlimited number of languages Ability to use different audio/image resources for different languages Use the tags {} to localize a text The text localization is stored in the locales folder Unlimited number of localization files Works on all platforms! PC, mobile phones, browsers! You can translate any parameters of other plugins Saving untranslated tags to a separate file using the plugin command will help you not to forget about something important 2 customizable language selection screens Change the language through options, title screen No need to restart the game to change the language. Everything changes instantly Use different fonts for different languages Screenshots: Spoiler: screenshots How to add the option to VisuMZ_1_OptionsCore: Spoiler: VisuMZ_1_OptionsCore 1. Place VisuMZ_1_OptionsCore plugin ABOVE in the plugin list 2. Enable "Show Options Command" parameter in the Localization plugin 3. Configure the new option in VisuMZ_1_OptionsCore.js with following parameters: Symbol: locale JS: Text: return LocalizationParam.get('Options Command Name'); JS: Show/Hide: return Imported['DKTools_Localization'] && LocalizationParam.get('Show Options Command'); JS: Draw Option: const index = arguments[1]; const title = this.commandName(index); const rect = this.itemLineRect(index); const halfWidth = rect.width / 2; this.resetFontSettings(); this.changePaintOpacity(true); this.drawTextEx(title, rect.x, rect.y, halfWidth, 'left'); this.drawText(this.statusText(index), rect.x + halfWidth, rect.y, halfWidth, 'center'); Plugin commands: UpdateLocalizationTags - Checks json files from "data/" except ignored files specified in the plugin parameters and also all the parameters of all plugins. Found tags are saved in new files in the localization folder with the prefix "new". ClearLocalizationCache - Clears the localization cache. Script calls: Spoiler: Script calls DKTools.Localization.locale - Get current locale DKTools.Localization.locales - Get an array of locales DKTools.Localization.language - Get current language DKTools.Localization.languages - Get an array of languages DKTools.Localization.getText(text) - Get localized text DKTools.Localization.getPrevLocale() - Get previous locale DKTools.Localization.getNextLocale() - Get next locale DKTools.Localization.getPrevLanguage() - Get previous language DKTools.Localization.getNextLanguage() - Get next language DKTools.Localization.selectLocale(locale) - Set locale (async, returns Promise) DKTools.Localization.selectPrevLocale() - Select previous locale (async, returns Promise) DKTools.Localization.selectNextLocale() - Select next locale (async, returns Promise) DKTools.Localization.addChangeLocaleListener(function) - Add "change locale listener" DKTools.Localization.getPrimaryLocale() - Get primary locale DKTools.Localization.getPrimaryLanguage() - Get primary language Help: Spoiler: Help ###=========================================================================== ## Special compatibility with other plugins ###=========================================================================== The plugin is compatible with most other plugins, but plugins that do not work with localization can still be included. ## Attention! ## If you think that any plugin is not compatible with localization, let me know. ###=========================================================================== ## Used formats ###=========================================================================== The following formats can be used for translations: 1. JSON (details: https://en.wikipedia.org/wiki/JSON) 2. CSV (details: https://en.wikipedia.org/wiki/Comma-separated_values) You can choose the format in the plugin settings. ### Attention! ### The encoding in the translation files must be UTF-8 without BOM. I recommend using Notepad++ for editing JSON files. I recommend using Google Docs to edit CSV files. Microsoft Office may not support UTF-8! ###=========================================================================== ## Instructions ###=========================================================================== ### 1 ### Installation ### Add at least one language in the "Game languages" parameter. ## Incomplete list of recommended locales ## Russian - ru Ukrainian - uk Belarusian - be English - en Chinese - zh Japanese - ja Korean - ko French - fe German - de Spanish - es Czech - cs Italian - it If you did not find a locale in this list, you can find it on the Internet, for example, here: https://www.science.co.il/language/Locale-codes.php ### 2 ### Usage ### 1. When you first start the game, the plugin will create a folders for translations and json files for each language (or csv file). 2. To localize text use the tags: {}. 3. To use a variable inside text use the tag: \VAR…

● ARCHIVED · READ-ONLY

Started by DK Aug 28, 2020, 04:54 PM 139 posts Page 5 of 7 View original ↗

Tuomo L

#81 Oct 21, 2021, 05:16 PM Source

@DK I have found the reason, encrypting the files causes this issue.

If you use RPG Maker MZ's image/audio encryption it causes these issues.
DK

#82 Oct 21, 2021, 05:18 PM Source

Tuomo L said:
@DK I have found the reason, encrypting the files causes this issue.

If you use RPG Maker MZ's image/audio encryption it causes these issues.
Oh, I'll watch it, thanks
DK

#83 Oct 27, 2021, 06:55 AM Source
Version 1.4.0:
- A new setting "Languages source" has been added, which will allow setting the game languages to a separate JSON file in the data folder. This can come in handy to easily add new languages after the game is released.
- Added settings that allow you to rename the text of the options ON and OFF.
- Help updated.
Version 1.3.3:
- Added new setting "Scan subfolders". If you enable this setting, the localization plugin will additionally scan the subfolders in the translation folder, thus allowing you to more conveniently organize the storage of files. For example, before you could only use one folder for the language locales/en/. Now inside this folder you can create subfolders, for example, locales/en/menus/, locales/en/messages.
MGGEDev

#84 Dec 21, 2021, 11:34 AM Source

I'll be using this to localise my game and I couldn't find the answer to one of the questions I had.
What are the pros and cons between json and CSV?
So far all I can see is CSV seems like so much less of a headache.
DK

#85 Dec 22, 2021, 12:51 PM Source

orcywoo6 said:
I'll be using this to localise my game and I couldn't find the answer to one of the questions I had.
What are the pros and cons between json and CSV?
So far all I can see is CSV seems like so much less of a headache.
Csv is easier to figure out, but json has more advanced features.
I would suggest getting to grips with json.
DK

#86 Dec 30, 2021, 01:47 PM Source
Version 1.4.1
- A new setting has been added that allows a common event to be triggered when changing the language.
- The minimum version of DKTools has been increased to version 1.2.0, in which the error in determining the extension of encrypted files has been fixed.
@Tuomo L
Kaimi

#87 Jan 13, 2022, 10:48 PM Source

I'm having a problem: I have the latest versions of both DKTools and DKTools_Localization and whenever I try to run the game I get the following message:

TypeError
Cannot read property 'children' of undefined

DevTools show following information:

rmmz_managers.js:2030 TypeError: Cannot read property 'children' of undefined
at Scene_Boot.Scene_Base.checkGlobalCursor (SoR_GlobalWindowItemCursor_MZ.js:217)
at Scene_Boot.Scene_Base.update (SoR_GlobalWindowItemCursor_MZ.js:193)
at Function.SceneManager.updateScene (DKTools.js:17319)
at Function.SceneManager.updateMain (rmmz_managers.js:2057)
at Function.SceneManager.update (rmmz_managers.js:1938)
at Function.Graphics._onTick (rmmz_core.js:811)
at TickerListener.emit (pixi.js:9474)
at Ticker.update (pixi.js:9928)
at Ticker._tick (pixi.js:9679)
SceneManager.catchNormalError @ rmmz_managers.js:2030

DevTools failed to load SourceMap: Could not load content for chrome-extension://njgcanhfjdabfmnlmpmdedalocpafnhl/js/libs/pixi.js.map: System error: net::ERR_FILE_NOT_FOUND

I haven't really started localizing; merely created new file, notice.json, and been trying to get any data put there loaded in a debug map, but as stated above I can't even get to the title screen.
Please help.
DK

#88 Jan 18, 2022, 06:11 AM Source

Kaimi said:
I'm having a problem: I have the latest versions of both DKTools and DKTools_Localization and whenever I try to run the game I get the following message:

TypeError
Cannot read property 'children' of undefined

DevTools show following information:

rmmz_managers.js:2030 TypeError: Cannot read property 'children' of undefined
at Scene_Boot.Scene_Base.checkGlobalCursor (SoR_GlobalWindowItemCursor_MZ.js:217)
at Scene_Boot.Scene_Base.update (SoR_GlobalWindowItemCursor_MZ.js:193)
at Function.SceneManager.updateScene (DKTools.js:17319)
at Function.SceneManager.updateMain (rmmz_managers.js:2057)
at Function.SceneManager.update (rmmz_managers.js:1938)
at Function.Graphics._onTick (rmmz_core.js:811)
at TickerListener.emit (pixi.js:9474)
at Ticker.update (pixi.js:9928)
at Ticker._tick (pixi.js:9679)
SceneManager.catchNormalError @ rmmz_managers.js:2030

DevTools failed to load SourceMap: Could not load content for chrome-extension://njgcanhfjdabfmnlmpmdedalocpafnhl/js/libs/pixi.js.map: System error: net::ERR_FILE_NOT_FOUND

I haven't really started localizing; merely created new file, notice.json, and been trying to get any data put there loaded in a debug map, but as stated above I can't even get to the title screen.
Please help.
I'll see what could be the problem
DK

#89 Jan 23, 2022, 07:31 AM Source

Take the survey about new file format. Thank you!
SonaGate

#90 Jan 24, 2022, 02:11 PM Source

DK said:
Take the survey about new file format. Thank you!
.pot, powerpoint? idk how that would work
Roninator2

#91 Jan 24, 2022, 02:27 PM Source

SonaGate said:
.pot, powerpoint? idk how that would work
ppt is powerpoint
gettext template POT files
SonaGate

#92 Jan 24, 2022, 04:54 PM Source

Roninator2 said:
ppt is powerpoint
gettext template POT files
I kinda want to delete my comment now hehe
Thanks
LastPaladinX

#93 Feb 10, 2022, 06:13 AM Source

Hi, I'm kind of new to this.

I'm trying to use the plugin but I can't get it to work

Is there a guide or tutorial for those of us who are just starting out in this?
Some examples?
DK

#94 Feb 10, 2022, 11:46 AM Source

LastPaladinX said:
Hi, I'm kind of new to this.

I'm trying to use the plugin but I can't get it to work

Is there a guide or tutorial for those of us who are just starting out in this?
Some examples?
Have you watched the demo?
jackassets

#95 Feb 10, 2022, 04:40 PM Source

I have a problem using the plugin with ALPHA ABS MZ

TypeError: Cannot set property frame of #<Sprite> which has only a getter
DK

#96 Feb 10, 2022, 04:42 PM Source

cropots said:
I have a problem using the plugin with ALPHA ABS MZ

TypeError: Cannot set property frame of #<Sprite> which has only a getter
This is a known issue. The author of Alpha ABS promised to fix it for his part.
jackassets

#97 Feb 10, 2022, 06:08 PM Source

DK said:
This is a known issue. The author of Alpha ABS promised to fix it for his part.
Too bad, I really liked this translation plugin. But my game is totally based on ALPHA ABS, I won't be able to risk creating the translation and the fix not being released. Thank you anyway.
DK

#98 Feb 10, 2022, 06:10 PM Source

cropots said:
Too bad, I really liked this translation plugin. But my game is totally based on ALPHA ABS, I won't be able to risk creating the translation and the fix not being released. Thank you anyway.
I think the bug will be fixed in one of the next updates.
LastPaladinX

#99 Feb 11, 2022, 02:25 AM Source

DK said:
Have you watched the demo?
Yesterday I saw the "online demo" and it didn't help me, today I downloaded and analyzed the downloadable version, I haven't tried it but I think I already understood the basics.
Even so, I believe that a detailed manual is required for those who do not have the basic knowledge to understand it. (like me XD)
I will try to experiment with the tool, I hope to be able to use it to its full potential since it seems to be one of the best (maybe the best)
DK

#100 Feb 11, 2022, 04:29 PM Source

LastPaladinX said:
Yesterday I saw the "online demo" and it didn't help me, today I downloaded and analyzed the downloadable version, I haven't tried it but I think I already understood the basics.
Even so, I believe that a detailed manual is required for those who do not have the basic knowledge to understand it. (like me XD)
I will try to experiment with the tool, I hope to be able to use it to its full potential since it seems to be one of the best (maybe the best)
The online demo is not intended to teach you how to use the plugin, because all the translation magic is contained within the events and the system.

P.S. I'll try to improve the help to make it more clear, but in the meantime, feel free to ask questions if something doesn't work out.