Introduction to Localization
Introduction to Localization
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.
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.
Consider the impact that localizing your game into Spanish or Chinese might have: your player base may double and you’ll see revenue soar.
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, find your game on the Create page and select Configure Localization from the configuration menu.
Once inside the portal, scroll down to the In Game Content Translations section 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
Below the settings is a list of languages (currently, only official Roblox-supported languages are available).
Clicking on a language opens the Manage Translations page where you can manage your translations.
- 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.
- The localized translation which will be used for the selected language.
- List of GUI objects within the game where the string is found.
- Log (history) of the changes made to a specific entry.
When you’re ready to utilize translated content in your game, return to the localization portal’s main page and enable Use Translated Content.
Once enabled, you can test the translations directly within Roblox Studio:
- In the Localization section of the Plugins tab, click the Tools button.
- In the localization tools window, under Test Language → Locale, select the language to test in.
- 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.