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 6 of 7 View original ↗

DK

#101 Mar 7, 2022, 05:53 AM Source
Version 1.4.2:
- Fixed display of flags in the "Window" style.
MGGEDev

#102 Apr 11, 2022, 08:46 AM Source

I'm trying to use this plugin but I only get the message "Attention use Utf-8 format" or something like that. I can't get the CSV to actually have anything exported except this text.
shenyi216

#103 May 9, 2022, 02:43 AM Source
Thanks for the plugin!! It works great for my game's localization!.

One questions is that when I deployed the game to Web version and uploaded it to itch.io, it kept showing an
Code:
Error:Uncaught [object XMLHttpRequest]
. I disabled both the DKTool and the DK Localization plugins, the error went away and the game could run properly online. But when I disabled the Localization plugin only, the error still stayed. Could you look into this??
shenyi216

#104 May 9, 2022, 03:03 AM Source
shenyi216 said:
Thanks for the plugin!! It works great for my game's localization!.

One questions is that when I deployed the game to Web version and uploaded it to itch.io, it kept showing an
Code:
Error:Uncaught [object XMLHttpRequest]
. I disabled both the DKTool and the DK Localization plugins, the error went away and the game could run properly online. But when I disabled the Localization plugin only, the error still stayed. Could you look into this??
In the DKtools plugin, I changed the File system's mode from "Nwjs + Stamps(0)" to "Nwjs(1)", then the web deployment worked on itch. But when I played through the game, all the dialogs showed tags instead of the real strings...
DK

#105 May 9, 2022, 02:52 PM Source

shenyi216 said:
In the DKtools plugin, I changed the File system's mode from "Nwjs + Stamps(0)" to "Nwjs(1)", then the web deployment worked on itch. But when I played through the game, all the dialogs showed tags instead of the real strings...
For the web version and mobile phones, you must select the Nwjs + Stamp file system, and before each build of the project, you must run the plugin command from DKTools to generate a file system stamp (more on this in the help).
Did you update the file system stamp?
shenyi216

#106 May 9, 2022, 10:01 PM Source
DK said:
For the web version and mobile phones, you must select the Nwjs + Stamp file system, and before each build of the project, you must run the plugin command from DKTools to generate a file system stamp (more on this in the help).
Did you update the file system stamp?
Sorry I thought it worked after updated the file system stamp, but I was actually still in the Nwjs mode and no strings shown... I switched to Nwjs + Stamp and updated the stamp. After I uploaded the package to itch, it showed another error
Code:
Error Uncaught Error: Localization directory is empty: locales\
I'm pretty sure I got all translation in the locales\ folder, not sure why it says that.
Utopia

#107 Jun 16, 2022, 09:41 AM Source

Any improvement on changing the main theme image? :)
masterlobo

#108 Jul 15, 2022, 12:33 AM Source

This is an amazing plugin! Thank you so much @DK !

Qq though, the plugin command ExportAllText is super useful if you're knee-deep in a project and have just begun thinking about localization. However, after having all the exported text is there an easy/quick path to localizing it?

Or does one have to manually replace the all text with tags?
zhaoxinak

#109 Aug 1, 2022, 04:22 AM Source

did it solved ？I am an iOS developer

DK said:
Unfortunately I do not have IOS and Mac to check the error, I will try to do something.
DK

#110 Aug 1, 2022, 05:33 AM Source

zhaoxinak said:
did it solved ？I am an iOS developer
Not yet
shenyi216

#111 Aug 4, 2022, 05:45 PM Source

DK said:
Not yet
If you need someone to test it on Mac, feel free to send me the update and I'll test it for you! Really hope this can be solved soon!
DK

#112 Nov 20, 2022, 09:28 AM Source

I recommend updating the DKTools plugin to the minimum version 1.3.3, because it fixes various errors that could occur when porting the project to browsers and mobile devices.
You can download the new version from the website https://dk-plugins.ru/mz/dktools/
shenyi216

#113 Nov 20, 2022, 09:50 PM Source

DK said:
I recommend updating the DKTools plugin to the minimum version 1.3.3, because it fixes various errors that could occur when porting the project to browsers and mobile devices.
You can download the new version from the website https://dk-plugins.ru/mz/dktools/
Thanks for updating the plugin! I downloaded the 1.3.3 version and updated the Stamps before deploying into web version, but it still gave me the same error saying locale/ is empty...
DK

#114 Nov 21, 2022, 03:41 AM Source

shenyi216 said:
Thanks for updating the plugin! I downloaded the 1.3.3 version and updated the Stamps before deploying into web version, but it still gave me the same error saying locale/ is empty...
Do you have enabled Scan subfolders setting in localization plugin?
shenyi216

#115 Nov 21, 2022, 02:19 PM Source

DK said:
Do you have enabled Scan subfolders setting in localization plugin?
I retried and enabled the Scan feature. It game me the same result :(
DK

#116 Nov 21, 2022, 03:01 PM Source

shenyi216 said:
I retried and enabled the Scan feature. It game me the same result :(
Can you send me a demo please ?
shogoth_baozi

#117 Dec 30, 2022, 01:44 AM Source

Hi, thank you for your amazing plugin! @DK

On the other hand, I encountered an issue when I exported new tags using csv format. Although I choose using commas as delimiters as csv values, the exported new tag document is still formatted with semicolons. It's not a big issue but is a bit frustrating.

By the way, a stupid question: how can I start a new paragraph in csv format? I tried "/n" but it doesn't work...
DK

#118 Dec 31, 2022, 04:29 PM Source

hsp20080888 said:
On the other hand, I encountered an issue when I exported new tags using csv format. Although I choose using commas as delimiters as csv values, the exported new tag document is still formatted with semicolons. It's not a big issue but is a bit frustrating.
I'll see what could be the problem

hsp20080888 said:
By the way, a stupid question: how can I start a new paragraph in csv format? I tried "/n" but it doesn't work...
Hmm...that's a good question
Aukan

#119 Mar 8, 2023, 04:23 AM Source

Hi, I have a problem.

Uncaught Error: Can not parse JSON data from file: locales\es\iniciobosque.json. Description: Unexpected token in JSON at position 1173 at processJsonFile (DKTools_Localization.js:3048) at async Promise.all (index 2) at async Function._loadData (DKTools_Localization.js:3117) at async Function.loadData (DKTools_Localization.js:3167) at async Function.initialize (DKTools_Localization.js:2417) at async Function.DKTools.StartupManager.initializeModules (DKTools_Localization.js:3436) at async Function.initialize (DKTools.js:7871) at async Function.SceneManager.initialize (DKTools.js:17422)

This is the line: : "extrmiya15": "Mi mundo corre peligro Miyabi, y eventualmente el tuyo también.",

And the same thing has already happened to me with other lines, I had to modify some dialogs so that the error does not appear, but it continues appearing.
DK

#120 Mar 8, 2023, 04:30 AM Source

Aukan said:
Hi, I have a problem.

This is the line: : "extrmiya15": "Mi mundo corre peligro Miyabi, y eventualmente el tuyo también.",

And the same thing has already happened to me with other lines, I had to modify some dialogs so that the error does not appear, but it continues appearing.
is this the last line in the file?