TranslationServer

public static bool PseudolocalizationEnabled { get; set; }

Состояние автоматической псевдолокализации основного домена, не именованных доменов. Setter обновляет remap-ресурсы и отправляет уведомление о смене перевода даже при том же значении. В текущей реализации преобразует Translate, но не TranslatePlural. Прямой Pseudolocalize работает независимо от флага.

public static TranslationServerInstance Singleton { get; }

Заимствованный экземпляр сервиса движка, общий со статическими методами. Обычно используйте статические вызовы TranslationServer. Не создавайте замену, не вызывайте Free/Dispose у этого экземпляра.

public static void AddTranslation(Translation translation);

Добавляет общий ресурс Translation в основной домен сервера. Повтор того же объекта не дублирует его; другой объект той же локали допустим, но порядок равных кандидатов не гарантирован. Не отправляет уведомление об обновлении существующего текста UI и не добавляет ресурс в именованные домены.

public static void Clear();

Очищает только набор каталогов основного домена. Не сбрасывает активную локаль, параметры псевдолокализации или именованные домены и не очищает сами Translation. Это глобальное действие для текущего проекта: для своего дополнения удаляйте только принадлежащие ему ресурсы/домен.

public static int CompareLocales(string localeA, string localeB);

Сравнивает локали: 10 для точного или нормализованного совпадения, положительная оценка для одного языка, 0 для разных языков. Это оценка сходства, а не проверка наличия перевода.

public static Reckfell.Collections.Array<Translation> FindTranslations(string locale, bool exact);

Возвращает отдельный контейнер Array<Translation> совпадающих каталогов основного домена. exact=true сравнивает Locale буквально без нормализации; false выбирает все CompareLocales>0. Не сортирует по точности, не проверяет сообщение и не включает именованные домены. Элементы — общие ресурсы.

public static string FormatNumber(string number, string locale);

Преобразует символы числовой строки для числовой системы locale. Ключ locale ищется буквально; сначала стандартизуйте его сами. Для поддерживаемых систем заменяет цифры, e/E и оба символа точки/запятой на разделитель. Не форматирует числовое значение, не группирует разряды, не проверяет строку и не использует формат C# по культуре. При отсутствии числовой системы возвращает ввод как есть. Например ar: 12.5 → ١٢٫٥.

public static string[] GetAllCountries();

Возвращает новый string[] кодов стран/регионов встроенной таблицы, не текущую страну пользователя. Порядок не гарантирован; названия получайте через GetCountryName.

public static string[] GetAllLanguages();

Возвращает новый string[] кодов из встроенной таблицы языков. Список не зависит от загруженных переводов и не гарантирует сортировку или полный перевод проекта на эти языки. Для интерфейса сопоставляйте код через GetLanguageName и сортируйте отдельно.

public static string[] GetAllScripts();

Возвращает новый string[] кодов письменностей встроенной таблицы, например Latn. Это не языки программирования и не перечень установленных шрифтов; порядок не гарантирован.

public static string GetCountryName(string country);

Находит название страны/региона по точному коду таблицы, например US. Неизвестный код возвращает без изменений; автоматической нормализации регистра или перевода названий по активной локали нет.

public static string GetLanguageName(string language);

Находит имя языка по точному коду таблицы, например en. Неизвестный код возвращается как есть. Названия берутся из встроенной таблицы и не переводятся автоматически при SetLocale; не передавайте полный ru_RU вместо кода ru.

public static string[] GetLoadedLocales();

Возвращает локали ресурсов, зарегистрированных в основном домене переводов. Не возвращает все известные движку языки и не проверяет полноту перевода сообщений.

public static string GetLocale();

Читает активную локаль сервера. Это не обязательно исходная локаль ОС, не список загруженных языков и не Locale отдельного Translation или override домена.

public static string GetLocaleName(string locale);

Стандартизует locale и составляет отображаемое имя из встроенных названий языка, письменности и страны, если компоненты присутствуют. Это подпись для человека, не стабильный идентификатор и не автоматически локализованный текст интерфейса.

public static TranslationDomain GetOrAddDomain(StringName domain);

Возвращает существующий именованный домен или создаёт пустой. Для дополнения используйте уникальное имя, например его путь addons; один домен не должен без согласования удаляться несколькими владельцами.

public static string GetPercentSign(string locale);

Возвращает знак процента числовой системы по точному непустому ключу locale; если записи нет, %. Не умножает значение на 100, не форматирует число и не выбирает расположение знака.

public static string GetPluralRules(string locale);

Ищет строку правил: сначала точный ключ таблицы, затем язык+страна и язык после разбора locale. При отсутствии возвращает пустую строку; английский fallback выбирает Translation, а не этот метод. Не проверяет полноту форм в каталоге и не вставляет число в текст.

public static string GetScriptName(string script);

Находит название письменности по точному коду, например Latn. Неизвестное значение возвращается как есть. Это не название C#-скрипта и не проверка поддержки письменности шрифтом.

public static string GetToolLocale();

В editor/project-manager режиме TOOLS_ENABLED использует локаль каталога редактора с точным совпадением либо en. При обычном запуске выбирает подходящую локаль основного домена, иначе fallback сервера. Это не универсальный способ прочитать настройку языка UI редактора из любой игры; поведение редактора проверено только по исходникам.

public static Translation GetTranslationObject(string locale);

Устаревший SDK-метод: возвращает один лучше совпавший общий ресурс основного домена либо null. Не гарантирует выбор при равных оценках и наличие нужного сообщения. Для списка используйте FindTranslations с явным exact; для текста — Translate/TranslatePlural.

public static Reckfell.Collections.Array<Translation> GetTranslations();

Возвращает отдельный Array<Translation> всех каталогов основного домена без гарантии порядка. Изменение контейнера не меняет регистрацию; редактирование элемента меняет общий ресурс. Не освобождайте элементы как новые ресурсы.

public static bool HasDomain(StringName domain);

Проверяет запись домена в реестре, не наличие конкретного языка или переведённого ключа. В проверке частный домен исчез после отключения плагина.

public static bool HasTranslation(Translation translation);

Проверяет регистрацию того же объекта Translation в основном домене. Совпадение Locale или содержимого недостаточно; содержимое каталога может быть пустым.

public static bool HasTranslationForLocale(string locale, bool exact);

Проверяет локаль каталогов основного домена: exact=true — буквальное равенство, false — CompareLocales>0. Не проверяет наличие конкретного ключа, fallback и именованные домены.

public static bool IsPseudolocalizationEnabled();

Читает флаг автоматического преобразования основного домена. Это не проверка всех именованных доменов и не подтверждение визуально обновлённого интерфейса.

public static string ParseNumber(string number, string locale);

Преобразует известные цифры, разделитель и экспоненту выбранной числовой системы обратно в строку с ASCII-цифрами. Не возвращает число и не проверяет синтаксис: несколько разделителей могут остаться. Для неподдерживаемого ключа locale ввод не меняется. Не гарантирует точный обратный ход FormatNumber: регистр экспоненты и исходная запятая могут потеряться.

public static StringName Pseudolocalize(StringName message);

Явно преобразует переданную строку по настройкам псевдолокализации основного домена. Работает даже при выключенном PseudolocalizationEnabled. Не выполняет поиск перевода; защита заполнителей не распознаёт составной формат C# {0}.

public static void ReloadPseudolocalization();

Перечитывает параметры преобразования из internationalization/pseudolocalization/ для основного домена и отправляет уведомление о смене перевода. Не переключает активное состояние по use_pseudolocalization: задайте PseudolocalizationEnabled отдельно. Не сохраняет ProjectSettings на диск.

public static void RemoveDomain(StringName domain);

Удаляет именованный домен из реестра. Делайте это после удаления его UI и только при владении доменом. Уже полученные ссылки могут оставаться живыми; повторный GetOrAddDomain создаст новую регистрацию.

public static void RemoveTranslation(Translation translation);

Удаляет конкретный ресурс из основного домена по объекту, не все переводы той же локали. Повторное удаление — бездействие. Не меняет регистрацию этого ресурса в других доменах и не отправляет уведомление о смене перевода.

public static void SetLocale(string locale);

Устанавливает непустую активную локаль с нормализацией. Если нормализованное значение изменилось, инициирует перезагрузку remap-ресурсов и отправляет MainLoop.NotificationTranslationChanged в главный цикл. Повтор того же значения — бездействие. Не загружает произвольные каталоги и не сохраняет предпочтение игрока на диск. Самостоятельно вычисленный текст пересчитывайте в обработчике уведомления.

public static void SetPseudolocalizationEnabled(bool enabled);

Назначает PseudolocalizationEnabled основного домена и инициирует обновление remap-ресурсов и уведомление главного цикла. Даже повтор того же bool отправляет уведомление. Не сохраняет ProjectSettings и не включает преобразование TranslatePlural.

public static string StandardizeLocale(string locale);

Нормализует обозначение локали, например ru-RU в ru_RU. Не служит проверкой наличия каталога или универсальным исправлением регистра и некорректного ввода. Эта перегрузка не добавляет значения по умолчанию.

public static string StandardizeLocale(string locale, bool addDefaults = false);

Нормализует обозначение локали, например ru-RU в ru_RU. Не служит проверкой наличия каталога или универсальным исправлением регистра и некорректного ввода. При addDefaults=true может добавить письменность или страну для некоторых неоднозначных локалей.

public static StringName Translate(StringName message, StringName context = null);

Выполняет поиск основного домена по активной и резервной локали. Пустой результат считается отсутствующим; при необходимости возвращает исходный ключ и применяет включённую псевдолокализацию. Не ищет произвольно во всех именованных доменах.

public static StringName TranslatePlural(StringName message, StringName pluralMessage, int n, StringName context = null);

Ищет форму в основном домене по активной, затем резервной локали. Правила определяет выбранный Translation. При отсутствии возвращает message только при n==1, иначе pluralMessage. Не подставляет число и в SDK 1.0.0 не применяет автоматическую псевдолокализацию; при необходимости явно обработайте результат через Pseudolocalize.