Перейти к содержимому

Political World — content, который переживает отсутствующий перевод

✅ Source verified design 🌐 Graceful degradation

Частая проблема addon:

нет locale key → пустое имя / ugly error / unusable UI

Creator layer API 1.9 специально допускает неполную localization.

Комментарии creator API:

localization must be optional
English/default text must remain readable on any game language

Addon definition может иметь сразу:

NameKey
DisplayName
DescriptionKey
Description

То есть creator может сразу выпустить читаемый default text, а полноценные locale packs добавить позже.

Пользователь с переводом получает:

native/current-language translation

При отсутствии перевода:

registered English/default

затем:

literal DisplayName/Description

и в крайнем случае:

stable key

Один missing translation не обязан делать content пустым.

Source добавляет English/default в current locale только если localization manager ещё не имеет значения для key.

Настоящий current-language translation имеет приоритет.

Political World сначала хранит registered translation в собственном registry, а потом пытается интегрироваться с NML localization.

Если NML call падает, ResolveLocalization(...) всё равно может использовать собственные registered values API.

Это graceful degradation между integration layers.

Он не гарантирует:

  • качество перевода;
  • достаточную ширину UI;
  • plural rules;
  • grammar;
  • right-to-left layout;
  • font coverage.

Он только делает failure mode намного лучше, чем «нет текста».

Нужно документировать оба вопроса:

Как сделать полноценную localization?

и:

Что произойдёт, если localization неполная?

Именно второй вопрос чаще встречает обычный пользователь.