roblox-localization
Use when implementing Roblox multi-language support, translation tables, auto-translation, locale-specific content, or region detection.
Install
npx skills add https://github.com/TabooHarmony/roblox-brain/tree/main/skills/gameplay/roblox-localization
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tabooharmony-roblox-brain@llmmart
git clone https://github.com/TabooHarmony/roblox-brain.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole tabooharmony/roblox-brain collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Roblox Localization
When to Load
Load when implementing multi-language support, translation systems, locale-specific content, or region detection. Covers LocalizationService, LocalizationTable, auto-translation, and country/region detection.
Quick Reference
Locale Detection
player.LocaleId: locale the player set for their Roblox account (e.g.en-us,pt-br,ja-jp)LocalizationService.RobloxLocaleId: locale for core/internal featuresLocalizationService.SystemLocaleId: player's OS localeLocalizationService:GetCountryRegionForPlayerAsync(player): country code from IP geolocation (e.g.US,BR,JP)
Translation Tables
LocalizationTable: stores translation entries (key → translations per locale)- Parent
LocalizationTableunderLocalizationServicefor auto-translation - Set
GuiBase2d.RootLocalizationTableon GUI objects for per-element tables - Studio can auto-extract strings into a table via the Localization Tools plugin
Auto-Translation
- Auto-translation requires
AutoLocalize = trueon the GUI and its ancestors, plus a matching table entry - Set
TextLabel.Textnormally; the engine replaces it with the translated string for the player's locale - Missing translations fall back to the source text
Manual Translation
local translator = LocalizationService:GetTranslatorForPlayerAsync(player)
local translated = translator:Translate(game, "Welcome!")
local formatted = translator:FormatByKey("coins_count", {count})
Country/Region Detection
local country = LocalizationService:GetCountryRegionForPlayerAsync(player)
if country == "US" then -- USD pricing
-- US offer
elseif country == "GB" then
-- UK offer
end
Key Rules
GetCountryRegionForPlayerAsyncis async; wrap in pcall, may failGetTranslatorForPlayerAsyncis async; cache the translator- Set
RootLocalizationTableto choose a table; keepAutoLocalizetrue through the ancestor chain - Translation entries:
SourceText,SourceLocaleId, thenen-us,pt-br, etc. columns - Export/import tables as CSV from Studio for bulk editing
- Test with different locales using Studio's locale simulator
Pitfalls
- Not all locales supported; check
player.LocaleId - Auto-translation does NOT work on non-GUI text; use manual
Translator:Translate GetCountryRegionForPlayerAsyncuses IP geolocation, so VPNs give wrong results- Missing entries fall back to source text silently
Need more detail? Load references/full.md.
Files (roblox-brain)
-
references
-
full.md 6.8 KB
Loading…
-
-
SKILL.md 3 KB
--- name: roblox-localization description: "Use when adding or fixing Roblox translation: localization tables, auto-translation, locale-specific content, or region detection." when_to_use: "Also when text isn't translated, translated text overflows UI, or when auditing strings before supporting more languages." last_reviewed: 2026-07-26 sources: - https://create.roblox.com/docs/reference/engine/classes/LocalizationService - https://create.roblox.com/docs/reference/engine/classes/LocalizationTable - https://create.roblox.com/docs/reference/engine/classes/Player --- # Roblox Localization ## When to Load Load when implementing multi-language support, translation systems, locale-specific content, or region detection. Covers LocalizationService, LocalizationTable, auto-translation, and country/region detection. ## Quick Reference ### Locale Detection - `player.LocaleId`: locale the player set for their Roblox account (e.g. `en-us`, `pt-br`, `ja-jp`) - `LocalizationService.RobloxLocaleId`: locale for core/internal features - `LocalizationService.SystemLocaleId`: player's OS locale - `LocalizationService:GetCountryRegionForPlayerAsync(player)`: country code from IP geolocation (e.g. `US`, `BR`, `JP`) ### Translation Tables - `LocalizationTable`: stores translation entries (key → translations per locale) - Parent `LocalizationTable` under `LocalizationService` for auto-translation - Set `GuiBase2d.RootLocalizationTable` on GUI objects for per-element tables - Studio can auto-extract strings into a table via the Localization Tools plugin ### Auto-Translation - Auto-translation requires `AutoLocalize = true` on the GUI and its ancestors, plus a matching table entry - Set `TextLabel.Text` normally; the engine replaces it with the translated string for the player's locale - Missing translations fall back to the source text ### Manual Translation ```luau local translator = LocalizationService:GetTranslatorForPlayerAsync(player) local translated = translator:Translate(game, "Welcome!") local formatted = translator:FormatByKey("coins_count", {count}) ``` ### Country/Region Detection ```luau local country = LocalizationService:GetCountryRegionForPlayerAsync(player) if country == "US" then -- USD pricing -- US offer elseif country == "GB" then -- UK offer end ``` ### Key Rules - `GetCountryRegionForPlayerAsync` is async; wrap in pcall, may fail - `GetTranslatorForPlayerAsync` is async; cache the translator - Set `RootLocalizationTable` to choose a table; keep `AutoLocalize` true through the ancestor chain - Translation entries: `SourceText`, `SourceLocaleId`, then `en-us`, `pt-br`, etc. columns - Export/import tables as CSV from Studio for bulk editing - Test with different locales using Studio's locale simulator ### Pitfalls - Not all locales supported; check `player.LocaleId` - Auto-translation does NOT work on non-GUI text; use manual `Translator:Translate` - `GetCountryRegionForPlayerAsync` uses IP geolocation, so VPNs give wrong results - Missing entries fall back to source text silently **Need more detail?** Load `references/full.md`.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.