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.
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.
ATC Usage Guidelines
For ATC to detect in-game text and add it to the localization portal, note the following:
- The game must be played in the Roblox application, not within Roblox Studio.
- If the game is played from your account, it may take 1–2 minutes for ATC to inject text into the localization portal.
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 their 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.
At this time, automatic machine translation is available for select beta testers and this feature will become available to all developers in time. Based on the Game Source Language that you selected earlier, switches for enabling automatic translations in supported languages will appear:
At this time, the following automatic translations are available:
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 as outlined in
articles/game testing#player-emulator|Game Testing Modes.
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.