dot-locale

Nothing in the family localised anything before this: no addon or game called TranslationServer, and every string on every screen was an English literal. Meanwhile the website is translated into nine languages and refuses API requests with keys — party.join.deny.full — rather than prose. dot-locale turns one of those keys into a sentence in the player’s language, without a second table.

Requires dot-core. Nothing else.

var loc: DotLocale = DotLocaleConfig.new().make().value   # reads res://locales
label.text = loc.t("party.ready.count", {"count": 3})
status.text = loc.explain(result.error)                    # a website refusal, in the player's language

The website’s layout, read as it is

One folder per language, one JSON file per area, nested objects inside:

locales/
  en/party.json    { "join": { "deny": { "full": "This party is full." } } }
  de/party.json    { "join": { "deny": { "full": "Diese Party ist voll." } } }

A message’s key is the file name plus its path, so party.join.deny.full is the same key on the site’s API, in its locale files and in a game. explain() renders a DotError whose detail carries such a key, and falls back to the error’s own English message where the catalogue lacks it.

The site’s files are not copied into the addon — they change on the site’s schedule. A game ships the ones it uses, or fetches them: dot-cloud delivers a locale pack like any other content.

What it does

Where a game plugs in

DotLocaleConfig

language, default_language, directory, pseudo — layered, so --locale-language de works without a settings screen. make() loads the catalogue and returns the translator.

DotLocale

The translator: t, explain, set_locale, chain, missing_keys, and the locale_changed signal. Not an autoload and not a Node — a server rendering messages for players in four languages needs four translators. register() puts one in DotRegistry for code that wants to find it without naming it.

DotLocaleCatalogue

locale → key → pattern. load_dir reads the site’s layout; one bad file refuses itself only, with file, line and message in the result.

to_translation(tag)

An engine Translation holding only the argument-free messages, so a Control with auto-translate shows static text from the same catalogue. tr() knows nothing of ICU; a plural handed to it would show its braces.