GSmGpE6CwX2y9JjB25B8
We use cookies on this site to enhance your user experience

Introduction to Localization

Introduction to Localization

Oct 21 2019, 10:04 AM PST 10 min

Roblox is dedicated to growing our audience of players and developers. As the number of international players grows, localization will help those players understand and enjoy your games.

Why Localize?

At its core, localization is about making a game more meaningful and engaging to a particular player base. Every region of the world has its own culture, language, and customs, so your game should ideally display region-specific language in its buttons, instructions, character dialogue, etc.

Getting Started

In Roblox, localizing a game involves three primary stages:

Text Collection and Storage Adding and Managing Translations Utilizing Translations

If you’re new to localization, read on to explore the cloud-based localization portal, the recommended method of storing, managing, and utilizing translations.

Text Collection and Storage

To access the localization portal, navigate to your game’s main page, click the button, and select Configure Localization from the context menu.

Once inside the portal, click the Settings tab and turn on Automatic Text Capture (ATC). This enables capture and storage of in-game strings when your game is played by anyone on Roblox.

Disabling ATC Per-Object

For some in-game content, you should disable automatic text capture. For example, ATC doesn’t need to track a TextLabel on a BillboardGui above an NPC which reads “Diva Dragonslayer” (the character’s name) because her name won’t change across languages.

To disable automatic text capture on a specific GuiBase2d|GUI object, un-check its GuiBase2d/AutoLocalize|AutoLocalize property in Studio or set it to false within a script.


Adding and Managing Translations

In the Languages section, you should first set the Game Source Language to one of the fully-supported languages on Roblox.

Next, in the Translated Languages section which follows, click the Add Language field and select a language from the menu. Once added to the list, clicking on a language opens the Manage Translations page where you can manage your translations.

A
List of in-game source text strings gathered by automatic text capture or manual entry. A green indicator means that a translation has been added for the selected language, while gray indicates no translation exists.
B
The localized translation which will be used for the selected language.
C
List of GUI objects within the game where the string is found.
D
Log (history) of the changes made to a specific entry.

Utilizing Translations

When you’re ready to utilize translated content in your game, return to the portal’s Settings section and enable Use Translated Content.

Once enabled, you can test the translations directly within Roblox Studio:

  1. In the Localization section of the Plugins tab, click the Tools button.
  1. In the localization tools window, under Test LanguageLocale, select the language to test in.
  2. Start playtesting and confirm that translations from the localization portal are being used on the configured in-game instances.

From here, it’s recommended that you explore articles/localization portal additional features|Localization Portal – Additional Features for details on setting translated game titles/descriptions, assigning other translators to assist you, and more.