Skip to content

Political World — treating localization keys as owned content

✅ Source verified 🌐 Collision prevention

Localization often looks harmless:

key → translated string

In an addon ecosystem, the key is a global identity.

Two addons using the same generic key can overwrite or confuse each other.

RegisterLocalization(...) requires the key to be owned by the registered addon.

The API also tracks:

localization key → owner addon ID

If a different addon already owns the key, the second registration is rejected and the framework records diagnostic code:

PWDIAG190
government.name
menu.title
description

These are easy to collide with.

YourName.MyAddon.government.technocracy.name
YourName.MyAddon.action.reform.description

Now the key itself communicates ownership.

The same principle applies to:

  • actions;
  • ideologies;
  • governments;
  • rare events;
  • save-data keys;
  • tags;
  • UI routes;
  • settings.

If content is globally addressable, it needs globally safe identity.

Political World’s internal helper can seed English fallback text from DisplayName/Description, but only when:

  • the addon is registered;
  • the localization key exists;
  • the fallback is non-empty;
  • the key belongs to that addon.

Convenience should not disable ownership rules.

Do not treat localization as a special ungoverned side table.

Localization keys are part of the public content namespace and deserve:

  • ownership;
  • collision detection;
  • stable naming;
  • migration discipline;
  • diagnostics.