Claude Skill

roblox-localization

Use when implementing Roblox multi-language support, translation tables, auto-translation, locale-specific content, or region detection.

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download TabooHarmony-roblox-brain-skills_gameplay_roblox-localization-ceee4aa.zip · 4 KB

Install

skills CLI npx skills add https://github.com/TabooHarmony/roblox-brain/tree/main/skills/gameplay/roblox-localization
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tabooharmony-roblox-brain@llmmart
Git 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 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

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

  • 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.

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.

No comments yet.

Reviews (0)

No reviews yet.