Automatic Translation

# Course Introduction

MapleStory Worlds provides an automatic translation feature for languages not supported by creators. This feature lessens the translation burden for creators and makes it easier for people of different languages to enjoy the Worlds. In this course, let's explore how the automatic translation feature works and how to configure it.

##### Reference Guide

[WorldConfig](/docs?postId=1101) [Understanding Localization](/docs/?postId=951) [Localizing to Fit Format](/docs/?postId=968)

##### API Reference

[TextComponent](/apiReference/Components/TextComponent) [TextInputComponent](/apiReference/Components/TextInputComponent) [TextRendererComponent](/apiReference/Components/TextRendererComponent%7B%22target%22:%22_blank%22%7D) [ChatBalloonComponent](/apiReference/Components/ChatBalloonComponent)

# About Automatic Translation Concept

Automatic translation is a feature that uses machine translation to provide translations for languages that are not officially supported by the creator.

For example, imagine that a creator whose native language is English, but who is not a bilingual person, has created and released a World. This creator creates the World alone, so it would take too long to provide multilingual translations of every word and sentence used in the World. In this case, the creator can use the automatic translation. The creator releases a World after writing only the original text in their native language, the basis for automatic translation, and setting the supported language to English only.

If a player in this World who only uses Korean changes the World Language setting to Korean, that player can play the World in Korean. Among the languages that appear in the Language (Auto Translation) under the World Settings, select Korean, the source language to translate, to translate the World's language.

> Learn More
> 
>   * The settings information for the automatic translation option is stored on a per-device basis.
>   * Please note that if the content to be translated exceeds 5,000 characters, it will not be translated.
> 


# How to Set Automatic Translation

The creator must activate AllowAutomaticTranslation for the player to use the auto translation function from language settings. This property is located in `TextComponent`, `TextInputComponent`, `TextRendererComponent`, and `ChatBalloonComponent`. Let's look at how to set up the auto translation function using an example.

  1. Activate AllowAutomaticTranslation from the `TextComponent`, `TextInputComponent`, `TextRendererComponent`, and `ChatBalloonComponent` for text entities that will be auto translated. [png](16983007897332bb3b13efdb14c27baa6ce77d2fd6f42)
  2. When you release a World, set the original language set by the creator and the language that you provide translation to Supported Languages. Languages not set as supported languages at release will be automatically translated. In the released World, all entities with AllowAutomaticTranslation enabled will be translated automatically if the player sets the target language for automatic translation from the World Language.



[png](1727252833488d67e8db9410f4f89a1051628519188a2)

> Tip The original language chosen by the creator as the basis for the translation can be set in Workspace - WorldConfig - SourceLanguage. [png](1698826078961925a793678514dc0821fb980cf8072ee)

> Learn More When a creator creates a tempoary input in the world using a language not set as the SourceLanguage, the auto translation may not function. This is because the auto translation is processed assuming the language set as the SourceLanguage regardless of the written language. 

# How Automatic Translation Works

Players who have accessed the released World can choose which language they want to play in from the World Language Settings window. Unsupported languages for that World will appear as targets for automatic translation in the World Language list. All entities with the AllowAutomaticTranslation property enabled will be translated automatically if the player sets the target language for automatic translation from the World Language.

[png](173977520738997b512c5efbc4fb1a2b32d77182fd8ce)