Translation Engine
SumRndmDde
This plugin provides game developers with tools necessary to easily and effectively translate and localize all the text within their game. This is through both an in-game tool that can be used while playtesting and a powerful notetag system for translating database inputs.
這個(gè)插件提供游戲開(kāi)發(fā)者并提供必要的工具前标，以便輕松有效地翻譯和本地化游戲中的所有文本。這是通過(guò)游戲中可以在測(cè)試時(shí)使用的工具和用于翻譯數(shù)據(jù)庫(kù)輸入的強(qiáng)大的notetag系統(tǒng)。
Installing the Plugin
Here’s a quick overview on how to properly install the plugin:
這里有一個(gè)快速概述如何正確安裝插件：
Place this plugin at the bottom of your plugin list!
1）將此插件放在插件列表的底部！Fill out the [Languages] plugin parameter with all the languages the game will be translated to.
2）用游戲?qū)⒎g成的所有語(yǔ)言填寫(xiě)[語(yǔ)言]插件參數(shù)淡喜。Set the [Source Language Name] plugin parameter to the name of the language used by the text by default.
3）默認(rèn)情況下哼勇，將[源語(yǔ)言名稱]插件參數(shù)設(shè)置為文本使用的語(yǔ)言的名稱Finally, set [Provide Option?] ON or OFF based on whether or not you wish to provide the player with the option to change the language in the options menu.
4）最后契沫，根據(jù)您是否希望向玩家提供在選項(xiàng)菜單中更改語(yǔ)言的選項(xiàng)捧毛，將[提供選項(xiàng)]設(shè)置為開(kāi)或關(guān)。
How to open the Translation App
While playtesting, press [CTRL + T] on Windows or [CMD + T] on Mac in order to open the “Translation App”. This is an app/editor that allows one to set up translations while playing the game.
雖然玩測(cè)試姑丑，在Windows上按[CTRL + T]或在Mac上按[CMD + T] 以打開(kāi)“翻譯應(yīng)用程序”蛤签。這是一款應(yīng)用/編輯器，可讓您在玩游戲時(shí)設(shè)置翻譯栅哀。
Once the app is open, it will act as a separate window from the game window.
一旦應(yīng)用程序打開(kāi)顷啼，它將作為游戲窗口的單獨(dú)窗口。
Here are a few rules that apply:
以下是一些適用的規(guī)則：
While the app is open, the game will only show the default text. You may not view translations unless the tool is closed. This is to help avoid confusion while editing since changes will not be applied until the app window is closed.
1）當(dāng)應(yīng)用程序打開(kāi)時(shí)昌屉，游戲只會(huì)顯示默認(rèn)文本钙蒙。除非工具關(guān)閉，否則您不能查看翻譯间驮。這是為了避免編輯時(shí)出現(xiàn)混淆躬厌，因?yàn)樵趹?yīng)用程序窗口關(guān)閉之前不會(huì)應(yīng)用更改。The game cannot completely shut down unless both the game window and the
editor window are both closed. If, for some reason, you cannot playtest your game, be sure the Translation App is closed!
2）游戲無(wú)法完全關(guān)閉，除非游戲窗口和編輯窗口都關(guān)閉扛施。如果出于某種原因鸿捧，您無(wú)法測(cè)試您的游戲，請(qǐng)確保翻譯應(yīng)用程序已關(guān)閉疙渣！The app will save its position when it is closed. If you open it again, it will appear where it left off! However, once you close or reset the game, its position will also be reset.
3）該應(yīng)用程序?qū)㈥P(guān)閉時(shí)保存其位置匙奴。如果你再次打開(kāi)它，它會(huì)出現(xiàn)在它離開(kāi)的地方妄荔！但是泼菌，一旦你關(guān)閉或重置游戲，它的位置也將被重置啦租。
How to use the Translation App
To start translating, first select the language you wish to translate to in the top-right corner of the app. Next, select what aspect of your game you wish to translate. All four choices appear as tabs you may select from the top of the editor. They are:
開(kāi)始翻譯哗伯，首先在應(yīng)用的右上角選擇你想翻譯的語(yǔ)言。接下來(lái)篷角，選擇您想要翻譯的游戲的哪一方面焊刹。所有四個(gè)選項(xiàng)都顯示為您可以從編輯器頂部選擇的選項(xiàng)卡。他們是：
~ Messages
~ Commands
~ Terms
~ Custom Translations
?消息
?命令
?術(shù)語(yǔ)
?自定義翻譯
Here’s an explanation of each one:
以下是對(duì)每一個(gè)的解釋：
Messages
This allows developers to provide translations for text within “Show Text”
events and “Show Scrolling Text” events. While the “Messages” tab is open,
the Original input will update itself to the current text displayed within
one of the aforementioned events. If neither of those events are active,
the input will remain blank.
這允許開(kāi)發(fā)者在“顯示文本” 事件和“顯示滾動(dòng)文本”事件中為文本提供翻譯恳蹲。當(dāng)“消息”選項(xiàng)卡打開(kāi)時(shí)虐块，原始輸入將自行更新為上述事件之一中顯示的當(dāng)前文本。如果這兩個(gè)事件均未激活嘉蕾，則輸入將保持空白贺奠。
While Original input box has text in it, one may create a translation for
the displayed text in the Translation input box. Simply type the text in
and it will save automatically!
當(dāng)原始輸入框中包含文本時(shí)，可以在翻譯輸入框中為顯示的文本創(chuàng)建翻譯荆针。只需輸入文本敞嗡，它會(huì)自動(dòng)保存颁糟！
Keep in mind the translations should include the desired text codes!
請(qǐng)記住航背，翻譯應(yīng)該包含所需的文本代碼！
Also, this mode works great with the Event “Test” feature!
此外棱貌，這種模式與事件“測(cè)試”功能非常相稱玖媚！
Commands
One may provide translations for any command windows using the “Commands”
tab. While this tab is open, all one must do is have an active cursor on a command window, and the Original input will update itself. Insert a corresponding translation into the Translation input to translate the command!
可以使用“命令” 選項(xiàng)卡為任何命令窗口提供翻譯。當(dāng)這個(gè)選項(xiàng)卡打開(kāi)時(shí)婚脱，所有人必須做的是在命令窗口上有一個(gè)活動(dòng)光標(biāo)今魔，并且原始輸入將自行更新。將相應(yīng)的翻譯插入翻譯輸入以翻譯命令障贸！
Some windows that fall under the category of “command windows” include:
屬于“命令窗口”類(lèi)別的一些窗口包括：
- The title screen command window
- The menu command window
- Command menus in other scenes
- The options window
- The game end window
- Event choice windows
*標(biāo)題畫(huà)面命令窗口
*菜單命令窗口
*其他場(chǎng)景中的命令菜單
*選項(xiàng)窗口
*游戲結(jié)束窗口
*事件選擇窗口
This, of course, will also work with command windows added through
external plugins. Don’t be afraid to experiment!
這當(dāng)然也可以通過(guò)外部插件添加命令窗口错森。不要害怕嘗試！
Terms
This section allows developers to translate the terms and messages from within their project’s Database’s Terms tab. All the Base Statuses,Parameters, and Messages can be translated here. First, select the “Term” from the dropdown list. Next, input a translation based upon the provided Original input that contains the current text for that term.
本部分允許開(kāi)發(fā)人員在其項(xiàng)目的數(shù)據(jù)庫(kù)的術(shù)語(yǔ)標(biāo)簽中翻譯術(shù)語(yǔ)和消息篮洁。所有的基本狀態(tài)涩维，參數(shù)和消息都可以在這里翻譯。首先袁波，從下拉列表中選擇“術(shù)語(yǔ)” 瓦阐。接下來(lái)蜗侈，根據(jù)提供的包含當(dāng)前文本的原始輸入輸入翻譯。
Similar to the previous tabs, once you insert the text into the Translation box, it will immediately be saved!
與以前的選項(xiàng)卡類(lèi)似睡蟋，一旦將文本插入翻譯框踏幻，它將立即被保存！
When one begins his or her translation process, it is recommended he or she starts the process here. This tab provides the capability to make a large number of helpful base translations!
當(dāng)一個(gè)人開(kāi)始他或她的翻譯過(guò)程時(shí)戳杀，建議他或她在這里開(kāi)始這個(gè)過(guò)程该面。此標(biāo)簽提供了大量有用的基礎(chǔ)翻譯的功能！
Custom Translations
Custom translations allow for developers to set a word to phrase to specifically translate into another. This is primarily used to translate text that cannot be translated through any of the other mediums provided through this plugin. Use this as a last resort for anything you cannot
translate normally!
自定義翻譯允許開(kāi)發(fā)人員設(shè)置一個(gè)詞豺瘤，以專門(mén)翻譯成另一個(gè)詞吆倦。這主要用于翻譯
無(wú)法通過(guò)此插件提供的任何其他介質(zhì)翻譯的文本。將此作為通常無(wú)法翻譯的任何內(nèi)容的最后手段坐求！
In order to add a translation, simply fill out both the “Original” and“Translation” inputs, then press the “Add Translation” button. This will add the pair to a list of custom translations displayed on the lower-half of the page.
為了添加翻譯蚕泽，只需填寫(xiě)“原始”和“翻譯”輸入，然后按下“添加翻譯”按鈕桥嗤。這會(huì)將該對(duì)添加到頁(yè)面下半部分顯示的自定義翻譯列表须妻。
In order to delete a translation, fill out the “Original” input with the original text for that translation, then press the “Delete Translation” button. This will remove that translation pair from both the list and the game itself.
為了刪除翻譯，請(qǐng)使用該翻譯的原文填寫(xiě)“原始”輸入泛领，然后按下“刪除翻譯” 按鈕荒吏。這將從列表和游戲本身中移除該翻譯對(duì)。
RegExp Translations
Custom translations can also use Regular Expressions. As opposed to the normal custom translations which require exact matching in order to work, Regular Expressions can allow for more dynamic checks and replacements from within larger bodies of text.
自定義翻譯也可以使用正則表達(dá)式渊鞋。與正常的自定義翻譯相比绰更，需要精確匹配才能正常工作，
正則表達(dá)式可以允許在更大的文本體內(nèi)進(jìn)行更動(dòng)態(tài)的檢查和替換锡宋。
In order to setup a Regular Expression, simply set the Original input to
have a Regular Expression using the typical JavaScript format:
為了設(shè)置正則表達(dá)式儡湾，只需使用典型的JavaScript格式將原始輸入設(shè)置為正則表達(dá)式即可：
/expression/flags
For example:
/Harold/ig
This example will check all texts for this match and apply a replacement in order to replace this with the text defined in the Translation input.
此示例將檢查此匹配的所有文本并應(yīng)用替換，以便將其替換為在翻譯輸入中定義的文本执俩。
Translating the Database
The second part of this plugin revolves around translating Database inputs by using a notetag setup to translate specific fields. This can be done with Actors, Classes, Skills, Items, Weapons, Armors, Enemies, States, and Tilesets.
這是第二部分插件圍繞翻譯數(shù)據(jù)庫(kù)輸入徐钠，通過(guò)使用備注設(shè)置來(lái)轉(zhuǎn)換特定字段。這可以通過(guò)
Actor役首，Classes张足，Skills趋艘，Items烙如，Weapons吕喘，Armors，Enemies矮固，States和Tilesets完成失息。
To do this, use the following notetag structure:
為此，請(qǐng)使用以下notetag結(jié)構(gòu)：
[PROP]:VAL
[PROP]:VAL
</LANGUAGE Translation>
[LANGUAGE] => The name of the language this is a translation for.
[PROP] => A field name for this data object.
[VAL] => The translated value for that data object’s field.
Example
This may appear to be a little confusing, but here is an example that one
may use to translate an Actor’s fields:
這看起來(lái)有點(diǎn)令人困惑，但這里有個(gè)例子可以用來(lái)翻譯Actor的字段：
<Spanish Translation>
[name]:Haroldo
[nickname]:Harldy
[profile]:Este es el héroe del juego.
Le gusta caminar por la playa y jugar juegos.
</Spanish Translation>
This means, when the language is set to Spanish, this Actor will have the
following changes:
這意味著根时，當(dāng)語(yǔ)言設(shè)置為西班牙語(yǔ)時(shí)瘦赫，此演員將進(jìn)行以下更改：
Name will be set to “Haroldo”.
Nickname will be set to “Harldy”.
Profile will be set to “Este es el héroe del juego.
Le gusta caminar por la playa y jugar juegos.”
名稱將被設(shè)置為“Haroldo”。
昵稱將被設(shè)置為“哈爾迪”蛤迎。
配置文件將設(shè)置為“Este es elhéroedel juego确虱。
Le gusta caminar por la playa y jugar juegos√骜桑“
All Common Fields
Here is a list of all the common field names you may wish to use
corresponding to each Database section:
以下是您可能希望使用的與每個(gè)數(shù)據(jù)庫(kù)部分對(duì)應(yīng)的所有常用字段名稱的列表：
[Actors]
<LANGUAGE Translation>
[name]:
[profile]:
[nickname]:
</LANGUAGE Translation>
[Classes]
<LANGUAGE Translation>
[name]:
</LANGUAGE Translation>
[Skills]
<LANGUAGE Translation>
[name]:
[description]:
[message1]:
[message2]:
</LANGUAGE Translation>
[Items, Weapons, Armors]
<LANGUAGE Translation>
[name]:
[description]:
</LANGUAGE Translation>
[Enemies]
<LANGUAGE Translation>
[name]:
</LANGUAGE Translation>
[States]
<LANGUAGE Translation>
[name]:
[message1]:
[message2]:
[message3]:
[message4]:
</LANGUAGE Translation>
[Tilesets]
<LANGUAGE Translation>
[name]:
</LANGUAGE Translation>
Different Images Based on Language
One may load alternative images based on the game’s language. To do this,one must use the following format for the image file name:
可能會(huì)加載基于游戲語(yǔ)言的替代圖像校辩。為此，必須使用以下格式的圖像文件名稱：
IMAGENAME_[LANGUAGE]
To allow the plugin to recognize that an image can be translated, first set the original image’s file name to:
要允許插件識(shí)別圖像可以被翻譯辆童，首先將原始圖像的文件名稱設(shè)置為：
IMAGENAME_[Original]
Then set up names for all your alternative images:
然后為所有替代圖像設(shè)置名稱：
IMAGENAME_[Spanish] IMAGENAME_[Portuguese]
Be sure to set up images for all languages in your game!
一定要為游戲中的所有語(yǔ)言設(shè)置圖像宜咒！
Plugin Commands
In order to force the game to use a specific language, the following plugin command must be invoked in an event. This can be different for every game file.
為了強(qiáng)制游戲要使用特定的語(yǔ)言，必須在事件中調(diào)用以下插件命令把鉴。每個(gè)游戲文件都可能有所不同故黑。
SetTranslation LANGUAGE
For example:
SetTranslation Spanish
Once a language is forced, it cannot be changed in the options menu. In order to remove a forced translation, use the plugin command:
一旦強(qiáng)制使用語(yǔ)言，就不能在選項(xiàng)菜單中進(jìn)行更改庭砍。要?jiǎng)h除強(qiáng)制轉(zhuǎn)換场晶，請(qǐng)使用plugin命令：
RevertTranslation
Checking Current Language
In order to change events based on the current language, the following script condition needs to be used:
為了改變事件基于當(dāng)前語(yǔ)言，需要使用以下腳本條件：
ConfigManager.getLanguage() === “LANGUAGE”
For example:
ConfigManager.getLanguage() === “Spanish”
End of Help Section
幫助部分結(jié)束
