Merge branch 'encounter-journal'

CUSTOMIZATION_PLAN.md

@@ -0,0 +1,788 @@
+# План расширенной кастомизации персонажей MoonWell
+
+## 1. Цель
+
+Создать для клиента WoW 3.3.5a (build 12340) расширенную систему внешности, визуально и по удобству близкую к retail, сохранив оригинальный `Wow.exe` и используя WarcraftXL для всех клиентских расширений.
+
+Система должна:
+
+- поддерживать стандартные параметры 3.3.5a и дополнительные параметры MoonWell;
+- показывать одинаковую внешность при создании, выборе персонажа, входе в мир и другим игрокам;
+- хранить дополнительные параметры на сервере и считать сервер источником истины;
+- поддерживать текстурные слои, geoset базовой модели и отдельные прикрепляемые M2-модели;
+- работать без Eluna/AIO в качестве постоянного транспорта состояния;
+- позволять добавлять новые варианты преимущественно данными и ассетами;
+- иметь версионирование формата и безопасный откат.
+
+## 2. Не входит в первую версию
+
+- полное копирование внутренних `ChrCustomization*` DB2 и протокола актуального retail-клиента;
+- поддержка всех retail-рас, которых нет в MoonWell;
+- динамическое изменение скелета или пропорций тела;
+- автоматический импорт всех retail-ассетов без ручной проверки;
+- публикация полного дампа современных файлов Blizzard;
+- изменение бинарника `Wow.exe` на диске.
+
+## 3. Базовые ограничения
+
+### Клиент
+
+- WoW 3.3.5a, build 12340, Lua 5.1, `## Interface: 30300`.
+- `Wow.exe` должен оставаться оригинальным с контролируемым SHA-256.
+- Новое нативное поведение реализуется модулем MoonWell внутри WarcraftXL.
+- GlueXML и FrameXML не используют retail API (`C_Timer`, `CreateFramePool`, `PixelUtil` и т. п.).
+- Для анимаций интерфейса используется `OnUpdate`.
+- UI-текстуры: `.blp`/`.tga`, размеры по степеням двойки, не более 512×512 на отдельный UI-тайл.
+- В Lua/XML использовать `SetWidth`/`SetHeight`, а не `SetSize`.
+
+### Ассеты и рендер
+
+- Исходные современные M2/MD21 обрабатываются `wxl-modern-assets`.
+- Каждая модель проверяется на поддерживаемую версию формата, лимит костей, материалы, анимации и attachment points.
+- Не использовать OBJ/FBX/glTF как вход для игрового клиента: нужны исходные `.m2`, `.skin`, `.skel`, `.anim` и `.blp`.
+- UI-превью и модель в мире должны использовать один каталог вариантов и одинаковые идентификаторы.
+
+### Сервер
+
+- Сервер валидирует расу, пол, доступность и совместимость каждого выбора.
+- Клиент не может назначить себе недоступный вариант внешности.
+- Дополнительные параметры хранятся отдельно от стандартных байтов внешности 3.3.5a.
+- Изменения схемы БД поставляются миграциями и имеют обратимый путь.
+
+## 4. Целевая архитектура
+
+```text
+Retail CDN (выбранные FileDataID)
+        │
+        ▼
+Asset manifest + downloader + validation
+        │
+        ▼
+Patch*.MPQ / loose Patch-WXL assets
+        │
+        ├── wxl-modern-assets
+        ├── адаптированный wxl-equip-extension
+        └── MoonWell customization runtime
+                    │
+             Lua API / GlueXML UI
+                    │
+                    ▼
+          MoonWell customization protocol
+                    │
+                    ▼
+        AzerothCore storage + validation + broadcast
+```
+
+### Компоненты
+
+1. **Asset pipeline** — получает только перечисленные зависимости по `FileDataID`, сохраняет манифест и проверяет комплектность.
+2. **`wxl-modern-assets`** — загружает и приводит современные M2/MD21 и текстуры к контракту клиента 3.3.5a.
+3. **Адаптированный `wxl-equip-extension`** — прикрепляет M2, поддерживает collection M2, два модельных канала, attachment points и фильтрацию geoset.
+4. **MoonWell customization runtime** — управляет независимыми косметическими каналами, текстурными слоями, geoset базовой модели и Lua API.
+5. **GlueXML UI** — категории, список вариантов, камера, случайный выбор, сброс и предварительный просмотр.
+6. **Серверный модуль** — хранение, валидация, загрузка, изменение и распространение внешности.
+
+## 5. Типы параметров внешности
+
+### Стандартные параметры 3.3.5a
+
+- пол;
+- цвет кожи;
+- лицо;
+- причёска;
+- цвет волос;
+- стандартная особенность лица/борода.
+
+Они продолжают использовать штатные поля персонажа и стандартный пакет создания.
+
+### Дополнительные текстурные параметры
+
+- шрамы;
+- татуировки тела;
+- татуировки лица;
+- макияж;
+- рисунок/отметины;
+- дополнительные оттенки кожи;
+- дополнительные слои лица.
+
+Реализация: расширение `CharSections`, каталог слоёв и модификация/перехват клиентского композитора текстуры персонажа.
+
+### Geoset базовой модели
+
+- дополнительные причёски;
+- части бороды и усов;
+- форма ушей/бровей;
+- варианты клыков;
+- встроенные рога;
+- скрытие частей базовой модели.
+
+Реализация: таблица выбора geoset по расе, полу, категории и варианту.
+
+### Прикрепляемые M2-элементы
+
+- серьги и пирсинг;
+- украшения для волос;
+- объёмные бороды;
+- рога и дополнительные клыки;
+- протезы;
+- венцы, диадемы и прочие аксессуары;
+- независимые объёмные элементы тела.
+
+Реализация: косметические каналы поверх механизма `wxl-equip-extension`.
+
+## 6. Косметические каналы
+
+Кастомизация не должна занимать реальные слоты экипировки. Нужен отдельный реестр каналов:
+
+```text
+hair_extra
+beard_extra
+horns
+ears
+tusks
+piercing_1
+piercing_2
+accessory_head
+accessory_face
+accessory_body_1
+accessory_body_2
+```
+
+Для каждого канала задаются:
+
+- стабильный числовой `option_id`;
+- допустимые расы и пол;
+- `display_id` или прямое описание M2;
+- Model1/Model2;
+- Texture1/Texture2;
+- attachment point для каждого модельного канала;
+- список разрешённых geoset collection M2;
+- флаги суффиксов расы/пола и структуры каталогов;
+- правила конфликта со шлемом и настоящей экипировкой;
+- приоритет и взаимоисключающие каналы;
+- значение сброса (`choice_id = 0`).
+
+## 7. Адаптация `wxl-equip-extension`
+
+### Обязательные работы
+
+- закрепить точную ревизию репозитория как submodule;
+- адаптировать сборочную структуру к текущему WarcraftXL MoonWell;
+- проверить пересечение хуков с `wxl-modern-assets` и существующими `OnItemSlotChange`, `OnItemSlotClear`, `OnM2PerFrameUpdate`;
+- вынести разбор Model1/Model2, `Icon2`, attachment points и collection geoset в переиспользуемый слой;
+- добавить API независимых косметических каналов, не привязанных к надетому предмету;
+- устранить утечку/остаток collection M2 после снятия или смены варианта;
+- обеспечить корректное уничтожение дочерних моделей при смене персонажа, карты, формы и пола;
+- исключить двойное прикрепление модели при повторной синхронизации;
+- очистить мусорные Model1/Model2 в старых строках `ItemDisplayInfo.dbc`;
+- добавить диагностический лог разрешения пути, модели, текстуры, attachment point и geoset;
+- реализовать безопасный fallback при отсутствии ассета.
+
+### Проверки совместимости
+
+- персонаж игрока;
+- другие игроки;
+- NPC с тем же `display_id`;
+- экран создания;
+- экран выбора;
+- парикмахерская;
+- смена экипировки;
+- превращения и shapeshift;
+- транспорт;
+- телепорт и смена карты;
+- повторный вход и `/reload`.
+
+## 8. Каталог данных кастомизации
+
+Нужен единый, версионируемый источник данных, из которого генерируются клиентское и серверное представления.
+
+Предлагаемая запись:
+
+```text
+option_id
+choice_id
+race_mask
+gender_mask
+category
+label_key
+render_type
+char_section_id
+geoset_ids
+model_1
+model_2
+texture_1
+texture_2
+attachment_1
+attachment_2
+flags
+conflict_group
+unlock_condition
+asset_manifest_id
+enabled
+```
+
+Требования:
+
+- `(option_id, choice_id)` никогда не переиспользуется с другим смыслом;
+- удалённый вариант остаётся распознаваемым для миграции старых персонажей;
+- порядок отображения UI хранится отдельно от стабильного идентификатора;
+- клиент и сервер собираются из одной версии каталога;
+- версия каталога входит в сетевое рукопожатие.
+
+## 9. Серверное хранение
+
+### Предлагаемая таблица
+
+```sql
+character_customization (
+    guid        INT UNSIGNED NOT NULL,
+    option_id   SMALLINT UNSIGNED NOT NULL,
+    choice_id   INT UNSIGNED NOT NULL,
+    updated_at  TIMESTAMP NOT NULL,
+    PRIMARY KEY (guid, option_id)
+)
+```
+
+Дополнительно:
+
+- индекс по `guid`;
+- внешний ключ или очистка записей при удалении персонажа;
+- миграция с начальными значениями для существующих персонажей;
+- сервис сброса неизвестных/отключённых вариантов;
+- аудит изменения внешности при необходимости.
+
+### Серверная логика
+
+- загрузить набор при `Character::LoadFromDB` или эквивалентном этапе;
+- валидировать выбор по расе, полу, режиму игры и доступности;
+- сохранять транзакционно;
+- включать состояние в данные экрана выбора персонажа;
+- отправлять полный snapshot при входе в мир;
+- отправлять delta при изменении;
+- рассылать актуальное состояние игрокам в зоне видимости;
+- отправлять snapshot при появлении объекта в зоне видимости нового клиента;
+- ограничить частоту изменений;
+- запретить недоступные комбинации независимо от клиентского UI.
+
+## 10. Сетевой протокол MoonWell
+
+### Общие требования
+
+- собственный namespace/opcode или надёжный WarcraftXL transport;
+- версия протокола и версия каталога;
+- явная длина сообщения и лимит числа записей;
+- little-endian поля с фиксированной шириной;
+- сервер является источником истины;
+- неизвестные поля пропускаются или отклоняются согласно версии;
+- отсутствие расширения не ломает стандартный вход в игру.
+
+### Сообщения
+
+```text
+CMSG_MOONWELL_CUSTOMIZATION_CREATE
+  protocol_version
+  catalog_version
+  option_count
+  repeated(option_id, choice_id)
+
+SMSG_MOONWELL_CUSTOMIZATION_RESULT
+  result_code
+  normalized choices
+
+SMSG_MOONWELL_CUSTOMIZATION_SNAPSHOT
+  player_guid
+  catalog_version
+  option_count
+  repeated(option_id, choice_id)
+
+CMSG_MOONWELL_CUSTOMIZATION_UPDATE
+  option_count
+  repeated(option_id, choice_id)
+
+SMSG_MOONWELL_CUSTOMIZATION_DELTA
+  player_guid
+  option_count
+  repeated(option_id, choice_id)
+```
+
+### Экран выбора персонажа
+
+Предпочтительный вариант — отдельный snapshot после получения списка персонажей. Не расширять штатный пакет без строгой проверки длины и совместимости.
+
+Клиент должен:
+
+- сопоставить snapshot с GUID персонажа;
+- применить его к модели выбранного персонажа;
+- хранить данные только до обновления от сервера;
+- показывать стандартную внешность, если snapshot отсутствует или версия несовместима.
+
+## 11. Клиентский runtime API
+
+Планируемый API WarcraftXL:
+
+```text
+MoonWellCustomizationGetCatalogVersion()
+MoonWellCustomizationGetOptions(race, gender)
+MoonWellCustomizationGetChoices(optionId)
+MoonWellCustomizationGetCurrent(optionId)
+MoonWellCustomizationPreview(optionId, choiceId)
+MoonWellCustomizationResetPreview()
+MoonWellCustomizationCommitPreview()
+MoonWellCustomizationRandomize()
+MoonWellCustomizationApplySnapshot(guid, data)
+MoonWellCustomizationClear(guid)
+```
+
+Требования:
+
+- Lua получает только безопасные операции высокого уровня;
+- нативный слой владеет указателями моделей и их жизненным циклом;
+- повторное применение snapshot идемпотентно;
+- preview не меняет серверное состояние;
+- при ошибке модель возвращается к последнему подтверждённому snapshot;
+- смена расы или пола пересчитывает допустимость всех параметров;
+- отсутствие M2/текстуры отключает только конкретный вариант, а не весь экран.
+
+## 12. Применение внешности
+
+Порядок применения должен быть фиксированным:
+
+1. базовая раса и пол;
+2. стандартные параметры 3.3.5a;
+3. `CharSections` и текстурные слои;
+4. geoset базовой модели;
+5. скрытие/конфликты с экипировкой;
+6. независимые косметические M2-каналы;
+7. обновление материалов и композитной текстуры;
+8. окончательное обновление позы и камеры превью.
+
+При смене одного параметра обновляется только затронутый слой, если это безопасно. Полная пересборка модели используется как fallback.
+
+## 13. Интерфейс создания персонажа
+
+### Структура
+
+- категории слева или справа от модели;
+- прокручиваемая сетка вариантов;
+- текстовое название активной категории;
+- состояние выбранного варианта;
+- кнопки случайного выбора и сброса;
+- возврат к выбору расы/класса без потери валидных параметров;
+- подтверждение создания только после серверной валидации;
+- плавное приближение камеры к зоне редактирования.
+
+### Категории первой версии
+
+- кожа;
+- лицо;
+- причёска;
+- цвет волос;
+- борода/особенность лица;
+- шрамы;
+- татуировки;
+- серьги/пирсинг;
+- расовый аксессуар.
+
+Категории скрываются, если для текущей расы/пола нет вариантов.
+
+### Камера
+
+- профиль камеры задаётся по расе, полу и категории;
+- отдельно настраиваются distance, вертикальная цель, горизонтальный сдвиг и FOV;
+- переход использует easing через `OnUpdate`;
+- короткие и средние расы имеют отдельные профили;
+- при выходе из кастомизации камера плавно возвращается к полному росту;
+- вращение персонажа доступно во всех режимах;
+- UI не перекрывает лицо и активный аксессуар на 4:3, 16:9 и 16:10.
+
+### Ограничения UI 3.3.5a
+
+- XML загружается раньше Lua;
+- именованные Button и ScrollFrame;
+- `relativeTo`, а не `relativeKey`;
+- `$parentX`, а не `$parent.X`;
+- `SetWidth`/`SetHeight` вместо `SetSize`;
+- таймеры и анимации через `OnUpdate`;
+- UI-атласы режутся на тайлы не более 512×512.
+
+## 14. Парикмахерская и изменение существующего персонажа
+
+- использовать тот же каталог и preview API;
+- получать текущий серверный snapshot при открытии;
+- считать стоимость на сервере;
+- подтверждать изменение одним атомарным запросом;
+- откатывать preview при закрытии или отказе сервера;
+- блокировать недоступные варианты;
+- поддерживать бесплатные/платные категории отдельными правилами;
+- обновлять внешность окружающим только после подтверждения.
+
+## 15. Получение retail-ассетов без установки клиента
+
+### Инструменты
+
+- `wow.export` в online-режиме — поиск и предварительный просмотр;
+- Wago Tools/wow-listfile — поиск пути и `FileDataID`;
+- TACTSharp/TACTTool — точечная загрузка исходных файлов с CDN Blizzard.
+
+### Манифест ассета
+
+```text
+asset_id
+source_product
+source_build
+file_data_id
+original_path
+target_path
+sha256
+kind
+parent_asset_id
+license_note
+```
+
+### Пайплайн
+
+1. Выбрать модель и исходный retail build.
+2. Зафиксировать корневой `FileDataID`.
+3. Выгрузить M2 и определить зависимости.
+4. Загрузить `.skin`, `.skel`, `.anim` и текстуры.
+5. Проверить хэши и комплектность.
+6. Проверить модель в изолированном preview.
+7. Проверить downport через `wxl-modern-assets`.
+8. Добавить запись в каталог кастомизации.
+9. Упаковать только выбранные файлы.
+10. Не помещать массовый дамп retail-клиента в Git.
+
+### Автоматические проверки ассета
+
+- поддерживаемая версия M2/MD21;
+- наличие всех skin-профилей;
+- разрешимые FileDataID и пути текстур;
+- наличие внешнего скелета/анимаций;
+- attachment points для целевой расы;
+- лимит костей на draw после разбиения;
+- валидные материалы и blend modes;
+- отсутствие коллизий целевых путей;
+- размер итогового MPQ и память после загрузки;
+- корректное освобождение ресурсов.
+
+## 16. Этапы реализации
+
+### Этап 0. Исследование и фиксация контрактов
+
+- [ ] Зафиксировать ревизии WarcraftXL и всех модулей.
+- [ ] Зафиксировать исходный retail build для ассетов.
+- [ ] Составить карту существующих хуков персонажа и DBC.
+- [ ] Проверить структуру штатных пакетов создания/выбора персонажа.
+- [ ] Зафиксировать каталог option/choice ID.
+- [ ] Утвердить правила доступности и монетизации.
+- [ ] Выбрать первую расу для вертикального среза: человек.
+
+**Результат:** техническая спецификация без конфликтующих точек расширения.
+
+### Этап 1. Интеграция equip-extension
+
+- [ ] Добавить репозиторий как закреплённый submodule.
+- [ ] Адаптировать CMake/module layout.
+- [ ] Собрать Win32 runtime и x64 host.
+- [ ] Устранить конфликт хуков с текущим WarcraftXL.
+- [ ] Исправить снятие collection M2.
+- [ ] Очистить мусорные поля `ItemDisplayInfo.dbc`.
+- [ ] Добавить smoke-тест Model1/Model2 на каждом поддержанном слоте.
+- [ ] Добавить диагностическое логирование.
+
+**Результат:** современная объёмная экипировка работает и корректно снимается.
+
+### Этап 2. Независимые косметические каналы
+
+- [ ] Отделить attachment runtime от реальных слотов экипировки.
+- [ ] Реализовать реестр косметических каналов.
+- [ ] Реализовать add/replace/remove/clear.
+- [ ] Реализовать conflict groups и приоритеты.
+- [ ] Реализовать скрытие под шлемом.
+- [ ] Добавить API preview.
+- [ ] Проверить смену карты, формы и пола.
+
+**Результат:** аксессуар можно показать без создания фиктивного предмета.
+
+### Этап 3. Asset pipeline
+
+- [ ] Добавить входной manifest с FileDataID.
+- [ ] Реализовать пакетную загрузку через CDN.
+- [ ] Добавить локальный кэш по хэшу.
+- [ ] Автоматически проверять зависимости.
+- [ ] Формировать отчёт о пропущенных файлах.
+- [ ] Интегрировать выбранные ассеты в MPQ build.
+- [ ] Добавить контроль размера и дубликатов.
+
+**Результат:** воспроизводимая сборка выбранных retail-ассетов без полного клиента.
+
+### Этап 4. Серверное хранение и протокол
+
+- [ ] Добавить миграцию `character_customization`.
+- [ ] Реализовать серверный каталог допустимых вариантов.
+- [ ] Реализовать create/update validation.
+- [ ] Реализовать snapshot и delta.
+- [ ] Подключить данные к character enum/select flow.
+- [ ] Рассылать состояние в visibility range.
+- [ ] Добавить rate limit и журнал ошибок.
+- [ ] Добавить fallback для клиента без совместимой версии.
+
+**Результат:** параметры сохраняются и одинаково видны всем клиентам.
+
+### Этап 5. Текстурные слои и geoset
+
+- [ ] Расширить/переопределить `CharSections` данными MoonWell.
+- [ ] Реализовать слои шрамов, татуировок и макияжа.
+- [ ] Реализовать таблицу geoset базовой модели.
+- [ ] Синхронизировать цветовые зависимости.
+- [ ] Обеспечить совместимость с надетой бронёй.
+- [ ] Добавить полную пересборку как fallback.
+
+**Результат:** работают не только прикрепляемые M2, но и полноценные параметры тела/лица.
+
+### Этап 6. Новый UI создания персонажа
+
+- [ ] Создать адаптивную панель категорий.
+- [ ] Создать прокручиваемую сетку choices.
+- [ ] Подключить preview API.
+- [ ] Добавить race/gender/category camera profiles.
+- [ ] Добавить randomize и reset.
+- [ ] Добавить обработку недоступного ассета.
+- [ ] Добавить серверное подтверждение создания.
+- [ ] Проверить 4:3, 16:9, 16:10 и UI scale.
+
+**Результат:** законченный retail-подобный пользовательский сценарий.
+
+### Этап 7. Вертикальный срез — человек
+
+- [ ] Мужская и женская модели.
+- [ ] Стандартные категории.
+- [ ] Минимум одна новая текстурная категория.
+- [ ] Минимум два M2-косметических канала.
+- [ ] Сохранение, выбор персонажа и отображение в мире.
+- [ ] Видимость другим игрокам.
+- [ ] Парикмахерская/изменение существующего персонажа.
+- [ ] Полный regression-тест экипировки.
+
+**Результат:** одна раса полностью проходит production-сценарий.
+
+### Этап 8. Масштабирование на все расы WotLK
+
+- [ ] Дворфы.
+- [ ] Ночные эльфы.
+- [ ] Гномы.
+- [ ] Дренеи.
+- [ ] Орки.
+- [ ] Нежить.
+- [ ] Таурены.
+- [ ] Тролли.
+- [ ] Эльфы крови.
+- [ ] Отдельная настройка камер для каждого пола.
+- [ ] Матрица конфликтов расовых элементов с экипировкой.
+
+**Результат:** единый уровень качества для всех доступных рас.
+
+### Этап 9. Стабилизация и выпуск
+
+- [ ] Нагрузочный тест большого скопления игроков.
+- [ ] Проверка утечек модели/текстур при многократной смене вариантов.
+- [ ] Проверка холодного кэша WarcraftXLHost.
+- [ ] Проверка отсутствующих/повреждённых ассетов.
+- [ ] Версионирование manifest, каталога и протокола.
+- [ ] Миграция существующих персонажей.
+- [ ] Rollback-пакет.
+- [ ] Документация для добавления новой категории/расы.
+- [ ] Обновление deploy-скрипта и launcher manifest.
+
+**Результат:** воспроизводимый production-релиз.
+
+## 17. Матрица тестирования
+
+### Персонажи
+
+- каждая раса × каждый пол;
+- стандартный режим × предатель;
+- новый персонаж × существующий персонаж;
+- минимальное × максимальное число выбранных параметров;
+- случайная комбинация × преднамеренно конфликтная комбинация.
+
+### Состояния клиента
+
+- создание;
+- выбор;
+- загрузочный экран;
+- вход в мир;
+- появление другого игрока;
+- телепорт;
+- смерть/дух;
+- транспорт;
+- shapeshift/превращение;
+- парикмахерская;
+- смена экипировки;
+- скрытие шлема/плаща;
+- `/reload`;
+- переподключение;
+- выход и повторный вход.
+
+### Графика
+
+- native renderer и основной D3D9On12 путь;
+- разные уровни component texture quality;
+- включённые/выключенные SSAA, SSAO и AA;
+- дальние LOD;
+- тени;
+- прозрачные и emissive материалы;
+- несколько одинаковых моделей одновременно;
+- 4:3, 16:9, 16:10 и разные UI scale.
+
+### Сеть и сервер
+
+- потеря/повтор snapshot;
+- snapshot до появления модели и после неё;
+- неизвестная версия каталога;
+- неизвестный option/choice;
+- запрещённый выбор;
+- слишком большое сообщение;
+- быстрое повторное изменение;
+- одновременное изменение и телепорт;
+- сохранение при logout/crash;
+- удаление и восстановление персонажа.
+
+## 18. Производительность
+
+Целевые ограничения:
+
+- не выполнять разбор каталога каждый кадр;
+- не пересобирать всю модель при изменении независимого аксессуара;
+- кэшировать разрешённые пути и обработанные modern assets;
+- не создавать дубликаты одной и той же дочерней M2-модели;
+- освобождать attachment при удалении/скрытии объекта;
+- ограничить число одновременных косметических M2 на персонажа;
+- иметь настройку отключения дальних косметических attachment;
+- измерять время первой загрузки, потребление RAM/VRAM и frame time;
+- логирование hot path отключено в release-сборке.
+
+Предварительный бюджет первой версии:
+
+- до 6 независимых M2-каналов на персонажа;
+- не более двух моделей на канал;
+- отсутствие постоянной работы Lua `OnUpdate`, кроме активной UI-анимации;
+- пересборка полной внешности только при snapshot, смене расы/пола или восстановлении после ошибки.
+
+## 19. Безопасность и целостность
+
+- сервер проверяет все ID и комбинации;
+- клиент не передаёт пути файлов серверу;
+- протокол содержит только числовые option/choice ID;
+- сообщения имеют максимальный размер и максимальное число записей;
+- сервер нормализует дубликаты option ID;
+- неизвестные значения не записываются в БД;
+- стоимость изменения рассчитывается сервером;
+- unlock condition проверяется сервером;
+- клиентский каталог не считается доказательством доступности;
+- журналировать несовпадение версии и попытки недопустимых изменений.
+
+## 20. Сборка, доставка и откат
+
+### Сборка
+
+- закреплённые submodule revisions;
+- asset manifest с SHA-256;
+- генерация клиентского и серверного каталога из одного источника;
+- сборка WarcraftXL Win32 и Host x64;
+- сборка MPQ;
+- автоматическая проверка оригинального `Wow.exe`;
+- формирование launcher manifest.
+
+### Версионирование
+
+- `customization_protocol_version`;
+- `customization_catalog_version`;
+- `customization_asset_version`;
+- совместимая версия WarcraftXL runtime.
+
+### Откат
+
+- сервер умеет не отправлять расширенные сообщения;
+- клиент при отсутствии данных показывает стандартную внешность;
+- отключение модуля не блокирует вход персонажа;
+- миграция БД не удаляет стандартные параметры;
+- предыдущие MPQ/runtime хранятся как отдельный release artifact;
+- неизвестные сохранённые choices не удаляются автоматически без миграции.
+
+## 21. Оценка трудоёмкости
+
+Для одного разработчика при наличии подготовленных ассетов:
+
+| Работа | Оценка |
+|---|---:|
+| Адаптация и исправление equip-extension | 4–7 дней |
+| Независимые косметические каналы | 4–7 дней |
+| Asset pipeline | 3–5 дней |
+| Серверное хранение и протокол | 4–7 дней |
+| Текстурные слои и geoset | 5–10 дней |
+| Новый UI создания/изменения | 5–8 дней |
+| Полный вертикальный срез одной расы | 5–10 дней |
+| Каждая следующая раса | 2–5 дней |
+| Стабилизация и regression | 7–12 дней |
+
+Ориентиры:
+
+- технический прототип одной расы: 1–2 недели;
+- production-вертикаль людей: 3–5 недель;
+- все десять рас WotLK: 2–3 месяца;
+- насыщенность категориями, близкая к retail: 3–6 месяцев.
+
+Главный переменный фактор — подготовка и проверка ассетов, а не серверная схема.
+
+## 22. Рекомендуемый первый milestone
+
+Вертикальный срез для людей обоих полов:
+
+- штатные пять категорий;
+- одна текстурная категория: шрамы;
+- два независимых M2-канала: серьги и аксессуар для волос;
+- серверное сохранение;
+- snapshot на экране выбора;
+- видимость другим игрокам;
+- изменение через парикмахерскую;
+- камера по категориям;
+- корректная работа со шлемом;
+- один полный набор automated/manual acceptance checks.
+
+Этот milestone должен подтвердить всю архитектуру до масштабирования на остальные расы.
+
+## 23. Критерии готовности production-версии
+
+- [ ] `Wow.exe` идентичен оригиналу по SHA-256.
+- [ ] Все расширения поставляются через WarcraftXL и MPQ.
+- [ ] Клиент и сервер используют одинаковую версию каталога.
+- [ ] Внешность сохраняется после выхода и перезапуска клиента.
+- [ ] Экран создания, экран выбора и модель в мире совпадают.
+- [ ] Другие игроки видят подтверждённую сервером внешность.
+- [ ] Недоступные варианты невозможно применить изменённым клиентом.
+- [ ] Смена/снятие варианта не оставляет collection M2.
+- [ ] Нет placeholder-моделей из мусорных строк `ItemDisplayInfo.dbc`.
+- [ ] Нет заметных утечек памяти при многократном preview.
+- [ ] Отсутствующий ассет не приводит к падению клиента.
+- [ ] Все расы и оба пола проходят тестовую матрицу.
+- [ ] Камера корректно кадрирует низких, средних и высоких персонажей.
+- [ ] UI работает на 4:3, 16:9, 16:10 и разных UI scale.
+- [ ] Реализован и проверен rollback.
+- [ ] Описан процесс добавления новой категории, choice и ассета.
+
+## 24. Открытые решения перед началом реализации
+
+- точная ревизия `wxl-equip-extension` для закрепления;
+- список категорий первого релиза;
+- исходный retail build для моделей;
+- набор моделей для вертикального среза людей;
+- формат единого каталога: JSON, CSV или генератор из SQL/YAML;
+- транспорт custom packets между WarcraftXL и AzerothCore;
+- способ передачи snapshots на экране выбора;
+- политика скрытия аксессуаров под шлемом;
+- правила доступности и разблокировки вариантов;
+- использование парикмахерской или отдельного UI изменения внешности;
+- лимит косметических M2 на одного персонажа;
+- политика хранения выбранных Blizzard-ассетов и доступа к ним;
+- минимальная поддерживаемая версия launcher/runtime.

modules/moonwell/src/MoonWell.cpp

@@ -23,6 +23,9 @@ namespace moonwell
 {
     namespace
     {
+        constexpr uint32_t kTraitorFlag = 0x40000000u;
+        bool g_loginCharacterIsTraitor = false;
+
         using GxSetProjectionFn = wxl::offsets::engine::gx::GxSetProjectionFn;
         GxSetProjectionFn g_nextSetProjection = nullptr;
 
@@ -216,6 +219,23 @@ namespace moonwell
             WLOG_INFO("moonwell: smooth character-create camera installed");
         }
 
+        int __cdecl SetLoginCharacterFlags(void* state)
+        {
+            uint32_t flags = 0;
+            if (state && wxl::runtime::lua::IsNumber(state, 1))
+                flags = static_cast<uint32_t>(wxl::runtime::lua::ToNumber(state, 1));
+
+            g_loginCharacterIsTraitor = (flags & kTraitorFlag) != 0;
+            wxl::runtime::lua::PushBoolean(state, g_loginCharacterIsTraitor ? 1 : 0);
+            return 1;
+        }
+
+        int __cdecl IsTraitor(void* state)
+        {
+            wxl::runtime::lua::PushBoolean(state, g_loginCharacterIsTraitor ? 1 : 0);
+            return 1;
+        }
+
         struct Patch
         {
             const char* name;
@@ -392,13 +412,14 @@ namespace moonwell
         {
             Registration()
             {
+                wxl::runtime::lua::RegisterFunction(
+                    "MoonWellSetLoginCharacterFlags", &SetLoginCharacterFlags);
+                wxl::runtime::lua::RegisterFunction("MoonWellIsTraitor", &IsTraitor);
                 wxl::runtime::lua::RegisterFunction(
                     "MoonWellSetCharacterCreateCamera", &SetCharacterCreateCamera);
                 wxl::runtime::modules::RegisterBoot("moonwell", &InstallBoot);
                 wxl::runtime::modules::Register(
                     "moonwell-character-create-camera", &InstallCharacterCreateCamera);
-                wxl::runtime::modules::Register(
-                    "moonwell-encounter-journal-models", &InstallEncounterJournalModelPreview);
                 wxl::runtime::modules::Register("moonwell-log-flush", &InstallRuntimeLogFlush);
             }
         } g_registration;

src/Data/ruRU/patch-ruRU-4/Interface/GlueXML/CharacterCreate.lua

@@ -23,7 +23,7 @@ FACTION_BACKDROP_COLOR_TABLE = {
 	["Alliance"] = {0.5, 0.5, 0.5, 0.09, 0.09, 0.19},
 	["Horde"] = {0.5, 0.2, 0.2, 0.19, 0.05, 0.05},
 };
-FRAMES_TO_BACKDROP_COLOR = { 
+FRAMES_TO_BACKDROP_COLOR = {
 	"CharacterCreateCharacterRace",
 	"CharacterCreateCharacterClass",
 --	"CharacterCreateCharacterFaction",
@@ -36,11 +36,11 @@ RACE_ICON_TCOORDS = {
     ["NIGHTELF_MALE"]    = {0.126953125, 0.189453125, 0.000000000, 0.125953125},
     ["DRAENEI_MALE"]     = {0.255859375, 0.318359375, 0.000000000, 0.125953125},
 
-    ["HUMAN_FEMALE"]     = {0.000000000, 0.062500000, 0.128906250, 0.253906250},  
-    ["DWARF_FEMALE"]     = {0.063476563, 0.125976563, 0.128906250, 0.253906250}, 
-    ["GNOME_FEMALE"]     = {0.192382813, 0.254882813, 0.128906250, 0.253906250}, 
-    ["NIGHTELF_FEMALE"]  = {0.127441406, 0.189941406, 0.128906250, 0.253906250}, 
-    ["DRAENEI_FEMALE"]   = {0.256347656, 0.318359375, 0.128906250, 0.253906250}, 
+    ["HUMAN_FEMALE"]     = {0.000000000, 0.062500000, 0.128906250, 0.253906250},
+    ["DWARF_FEMALE"]     = {0.063476563, 0.125976563, 0.128906250, 0.253906250},
+    ["GNOME_FEMALE"]     = {0.192382813, 0.254882813, 0.128906250, 0.253906250},
+    ["NIGHTELF_FEMALE"]  = {0.127441406, 0.189941406, 0.128906250, 0.253906250},
+    ["DRAENEI_FEMALE"]   = {0.256347656, 0.318359375, 0.128906250, 0.253906250},
 
     ["ORC_MALE"]         = {0.062011719, 0.000000000, 0.262695313, 0.384765625},
     ["SCOURGE_MALE"]     = {0.125976563, 0.063964844, 0.262695313, 0.384765625},
@@ -48,10 +48,10 @@ RACE_ICON_TCOORDS = {
     ["TROLL_MALE"]       = {0.253906250, 0.192382813, 0.262695313, 0.384765625},
     ["BLOODELF_MALE"]    = {0.317871094, 0.256835938, 0.262695313, 0.384765625},
 
-    ["ORC_FEMALE"]       = {0.060546875, 0.000000000, 0.391601563, 0.512695313},   
-    ["SCOURGE_FEMALE"]   = {0.124023438, 0.063476563, 0.391601563, 0.512695313},   
-    ["TAUREN_FEMALE"]    = {0.187988281, 0.127441406, 0.391601563, 0.512695313},  
-    ["TROLL_FEMALE"]     = {0.252441406, 0.191894531, 0.391601563, 0.512695313},  
+    ["ORC_FEMALE"]       = {0.060546875, 0.000000000, 0.391601563, 0.512695313},
+    ["SCOURGE_FEMALE"]   = {0.124023438, 0.063476563, 0.391601563, 0.512695313},
+    ["TAUREN_FEMALE"]    = {0.187988281, 0.127441406, 0.391601563, 0.512695313},
+    ["TROLL_FEMALE"]     = {0.252441406, 0.191894531, 0.391601563, 0.512695313},
     ["BLOODELF_FEMALE"]  = {0.316894531, 0.256835938, 0.391601563, 0.512695313},
 };
 CLASS_ICON_TCOORDS = {
@@ -137,23 +137,23 @@ local function HideAllTooltips()
     if AllianceTooltip then
         AllianceTooltip:Hide()
     end
-    
+
     if HordeTooltip then
         HordeTooltip:Hide()
     end
 end
 
 local backdrop = {
-    bgFile = "Interface\\Tooltips\\UI-Tooltip-Background", 
-    edgeFile = "Interface\\Tooltips\\UI-Tooltip-Border", 
-    tile = true, tileSize = 16, edgeSize = 16, 
+    bgFile = "Interface\\Tooltips\\UI-Tooltip-Background",
+    edgeFile = "Interface\\Tooltips\\UI-Tooltip-Border",
+    tile = true, tileSize = 16, edgeSize = 16,
     insets = { left = 4, right = 4, top = 4, bottom = 4 }
 };
 
 local Backdrop2 = {
-    bgFile = "Interface\\Tooltips\\UI-Tooltip-Background", 
-    edgeFile = "Interface\\Tooltips\\ui-tooltip-border-maw", 
-    tile = true, tileSize = 16, edgeSize = 16, 
+    bgFile = "Interface\\Tooltips\\UI-Tooltip-Background",
+    edgeFile = "Interface\\Tooltips\\ui-tooltip-border-maw",
+    tile = true, tileSize = 16, edgeSize = 16,
     insets = { left = 4, right = 4, top = 4, bottom = 4 }
 };
 
@@ -164,10 +164,10 @@ local function GetOrCreateRaceTooltip(button)
         tooltip:SetSize(280, 150)
         tooltip:SetFrameStrata("TOOLTIP")
         tooltip:SetBackdropColor(0, 0, 0, 1)
-        
+
         local raceID = button:GetID()
         local faction = _G.GetFactionForRaceID(raceID)
-        
+
         if faction == "Alliance" then
             tooltip:SetPoint("LEFT", CharacterCreateFrame, "LEFT", 160, 50)
         elseif faction == "Horde" then
@@ -194,7 +194,7 @@ local function GetOrCreateRaceTooltip(button)
         tooltip.rightClickText:SetPoint("TOP", tooltip.detailsText, "BOTTOM", 0, -10)
         tooltip.rightClickText:SetTextColor(0.8, 0.8, 0.8)
         tooltip.rightClickText:SetJustifyH("CENTER")
-        
+
         raceTooltips[button] = tooltip
     end
     return raceTooltips[button]
@@ -217,7 +217,7 @@ local function UpdateRaceTooltip(button, toggleDetails)
 
     tooltip.text:ClearAllPoints()
     tooltip.text:SetPoint("TOPLEFT", tooltip, "TOPLEFT", 10, -5)
-    
+
     tooltip.detailsText:ClearAllPoints()
     tooltip.detailsText:SetPoint("TOPLEFT", tooltip.text, "BOTTOMLEFT", 0, -5)
 
@@ -271,7 +271,7 @@ local function UpdateRaceTooltip(button, toggleDetails)
 
                 local containerHeight = tooltip["spellIcon"..i]:GetHeight() + tooltip["spellDesc"..i]:GetHeight() + 3
                 tooltip["spellContainer"..i]:SetHeight(containerHeight)
-                
+
                 lastElement = tooltip["spellContainer"..i]
             end
         end
@@ -308,10 +308,10 @@ local function UpdateRaceTooltip(button, toggleDetails)
         end
     end
 
-    local baseHeight = tooltip.text:GetHeight() + 
-                      tooltip.detailsText:GetHeight() + 
+    local baseHeight = tooltip.text:GetHeight() +
+                      tooltip.detailsText:GetHeight() +
                       tooltip.rightClickText:GetHeight() + 25
-    
+
     tooltip:SetHeight(baseHeight + heightToAdd)
     detailedRaceTooltips[button] = toggleDetails
     tooltip:ClearAllPoints()
@@ -346,7 +346,7 @@ local function GetOrCreateClassTooltip(button)
         tooltip.Roles:SetWidth(284)
         tooltip.Roles:SetWordWrap(true)
         tooltip.Roles:SetJustifyH("LEFT")
-        
+
         classTooltips[button] = tooltip
     end
 
@@ -370,7 +370,7 @@ local function GetValidRacesForClass(classID)
             table.insert(hordeRaces, raceName)
         end
     end
-    
+
     return allianceRaces, hordeRaces
 end
 local function UpdateClassTooltip(button)
@@ -382,7 +382,7 @@ local function UpdateClassTooltip(button)
 
     local buttonX, buttonY = button:GetCenter()
     local parentX, parentY = CharacterCreateFrame:GetCenter()
-    
+
     if buttonX > parentX then
         tooltip:SetPoint("BOTTOMRIGHT", button, "TOPRIGHT", 0, 10)
     else
@@ -394,7 +394,7 @@ local function UpdateClassTooltip(button)
 
     tooltip.text:ClearAllPoints()
     tooltip.text:SetPoint("TOPLEFT", tooltip, "TOPLEFT", 8, -8)
-    
+
     tooltip.detailsText:ClearAllPoints()
     tooltip.detailsText:SetPoint("TOPLEFT", tooltip.text, "BOTTOMLEFT", 0, -5)
 
@@ -405,7 +405,7 @@ local function UpdateClassTooltip(button)
     tooltip.RestrictionText = tooltip.RestrictionText or tooltip:CreateFontString(nil, "OVERLAY")
     tooltip.RestrictionText:SetFont("Fonts\\FRIZQT__.TTF", 12, "OUTLINE")
     tooltip.RestrictionText:SetJustifyH("LEFT")
-    
+
     tooltip.FactionText = tooltip.FactionText or tooltip:CreateFontString(nil, "OVERLAY")
     tooltip.FactionText:SetFont("Fonts\\FRIZQT__.TTF", 11)
     tooltip.FactionText:SetWordWrap(true)
@@ -416,12 +416,12 @@ local function UpdateClassTooltip(button)
     coloredRoles = string.gsub(coloredRoles, "Дальний бой", "|cffff2020Дальний бой|r")
     coloredRoles = string.gsub(coloredRoles, "Танк", "|cff0070ddТанк|r")
     coloredRoles = string.gsub(coloredRoles, "Лекарь", "|cff20c000Лекарь|r")
-    
+
     if not tooltip.Roles then
         tooltip.Roles = tooltip:CreateFontString(nil, "OVERLAY")
         tooltip.Roles:SetFont("Fonts\\FRIZQT__.TTF", 11)
     end
-    
+
     tooltip.Roles:SetText("|cFFFFFFFF"..FUNTION_INF.."|r\n\n "..coloredRoles)
 
     if showRestriction then
@@ -435,20 +435,20 @@ local function UpdateClassTooltip(button)
         tooltip.RestrictionText:Show()
 
         local allianceRaces, hordeRaces = GetValidRacesForClass(classID)
-        
+
         local factionText = ""
-        
+
         if #allianceRaces > 0 then
             factionText = ALLIANCE_RACE .. " |cFFFFFFFF" .. table.concat(allianceRaces, ", ") .. "|r"
         end
-        
+
         if #hordeRaces > 0 then
             if factionText ~= "" then
                 factionText = factionText .. "\n\n"
             end
             factionText = factionText .. "\n" .. HORDE_RACE .. " |cFFFFFFFF" .. table.concat(hordeRaces, ", ") .. "|r"
         end
-        
+
         tooltip.FactionText:SetPoint("TOPLEFT", tooltip.RestrictionText, "BOTTOMLEFT", 0, -15)
         tooltip.FactionText:SetTextColor(1, 0.82, 0)
         tooltip.FactionText:SetText(factionText)
@@ -459,18 +459,18 @@ local function UpdateClassTooltip(button)
         maxWidth = math.max(maxWidth, tooltip.RestrictionText:GetWidth())
         maxWidth = math.max(maxWidth, tooltip.FactionText:GetWidth())
         maxWidth = math.max(280, math.min(maxWidth + 16, 400))
-        
+
         tooltip:SetWidth(maxWidth)
         tooltip.FactionText:SetWidth(maxWidth - 16)
-        
-        local restrictionHeight = tooltip.text:GetHeight() + 
-                                tooltip.detailsText:GetHeight() + 
+
+        local restrictionHeight = tooltip.text:GetHeight() +
+                                tooltip.detailsText:GetHeight() +
                                 tooltip.Roles:GetHeight() +
-                                tooltip.RestrictionText:GetHeight() + 
+                                tooltip.RestrictionText:GetHeight() +
                                 tooltip.FactionText:GetHeight() + 80
-        
+
         tooltip:SetHeight(restrictionHeight)
-        
+
     else
         tooltip.RestrictionText:Hide()
         tooltip.FactionText:Hide()
@@ -484,10 +484,10 @@ local function UpdateClassTooltip(button)
         maxWidth = math.max(280, math.min(maxWidth + 16, 400))
         tooltip:SetWidth(maxWidth)
 
-        local baseHeight = tooltip.text:GetHeight() + 
-                          tooltip.detailsText:GetHeight() + 
+        local baseHeight = tooltip.text:GetHeight() +
+                          tooltip.detailsText:GetHeight() +
                           tooltip.Roles:GetHeight() + 30
-        
+
         tooltip:SetHeight(baseHeight)
     end
 end
@@ -498,7 +498,7 @@ function CharacterCreate_MoveTexturesToBackground()
         if button then
             local normalTex = _G[button:GetName().."NormalTexture"]
             local pushedTex = _G[button:GetName().."PushedTexture"]
-            
+
             if normalTex then
                 normalTex:SetDrawLayer("BACKGROUND")
             end
@@ -513,7 +513,7 @@ function CharacterCreate_MoveTexturesToBackground()
         if button then
             local normalTex = _G[button:GetName().."NormalTexture"]
             local pushedTex = _G[button:GetName().."PushedTexture"]
-            
+
             if normalTex then
                 normalTex:SetDrawLayer("BACKGROUND")
             end
@@ -525,12 +525,12 @@ function CharacterCreate_MoveTexturesToBackground()
 
     local maleButton = CharacterCreateGenderButtonMale
     local femaleButton = CharacterCreateGenderButtonFemale
-    
+
     if maleButton then
         _G[maleButton:GetName().."NormalTexture"]:SetDrawLayer("BACKGROUND")
         _G[maleButton:GetName().."PushedTexture"]:SetDrawLayer("BACKGROUND")
     end
-    
+
     if femaleButton then
         _G[femaleButton:GetName().."NormalTexture"]:SetDrawLayer("BACKGROUND")
         _G[femaleButton:GetName().."PushedTexture"]:SetDrawLayer("BACKGROUND")
@@ -558,7 +558,7 @@ local function CreateFactionTooltip(parent, factionName)
     tooltip.description:SetWordWrap(true)
     tooltip.description:SetJustifyH("LEFT")
     tooltip.description:SetTextColor(0.9, 0.9, 0.9)
-    
+
     return tooltip
 end
 
@@ -566,7 +566,7 @@ local function UpdateTooltipSize(tooltip)
     local titleHeight = tooltip.title:GetHeight()
     local descHeight = tooltip.description:GetHeight()
     local totalHeight = titleHeight + descHeight + 30
-    
+
     tooltip:SetHeight(totalHeight)
     tooltip:SetWidth(300)
 end
@@ -580,7 +580,7 @@ function CharacterCreate_PositionRaceButtons()
         local button = _G["CharacterCreateRaceButton"..i]
         if button then
             button:ClearAllPoints()
-            
+
             if i == 1 then
                 button:SetPoint("TOP", AllianceLogoFrame, "BOTTOM", -horizontalOffset, verticalStart)
             else
@@ -594,7 +594,7 @@ function CharacterCreate_PositionRaceButtons()
         local button = _G["CharacterCreateRaceButton"..i]
         if button then
             button:ClearAllPoints()
-            
+
             if i == 6 then
                 button:SetPoint("TOP", HordeLogoFrame, "BOTTOM", horizontalOffset, verticalStart)
             else
@@ -607,12 +607,12 @@ end
 
 function CharacterCreate_PositionClassButtons()
     local buttonSpacing = 80
-    
+
     for i = 1, MAX_CLASSES_PER_RACE do
         local button = _G["CharacterCreateClassButton"..i]
         if button then
             button:ClearAllPoints()
-            
+
             if i == 1 then
                 button:SetPoint("CENTER", CharacterCreateFrame, "BOTTOM", -360, 80)
             else
@@ -624,16 +624,16 @@ function CharacterCreate_PositionClassButtons()
 end
 
 function CharacterCreate_PositionGenderButtons()
-    local genderSpacing = 310 
-    
+    local genderSpacing = 310
+
     local maleButton = CharacterCreateGenderButtonMale
     local femaleButton = CharacterCreateGenderButtonFemale
-    
+
     if maleButton then
         maleButton:ClearAllPoints()
         maleButton:SetPoint("CENTER", CharacterCreateFrame, "CENTER", -(genderSpacing/2), -250)
     end
-    
+
     if femaleButton then
         femaleButton:ClearAllPoints()
         femaleButton:SetPoint("CENTER", CharacterCreateFrame, "CENTER", (genderSpacing/2), -250)
@@ -676,6 +676,44 @@ function CharacterCreate_UpdateGameModeVisibility()
     end
 end
 
+-- The stock creation scene frames each race at a different height.  Projection
+-- zoom therefore needs a per-race vertical target to keep the face in the same
+-- part of the screen. Values are indexed by GetSelectedSex(): 2 male, 3 female.
+local CHARACTER_CREATE_CAMERA_PROFILES = {
+    HUMAN    = { [2] = -0.28, [3] = -0.20 },
+    ORC      = { [2] = -0.50, [3] = -0.30 },
+    DWARF    = { [2] =  0.30, [3] =  0.38 },
+    NIGHTELF = { [2] = -0.65, [3] = -0.65 },
+    SCOURGE  = { [2] =  0.18, [3] =  0.27 },
+    TAUREN   = { [2] = -0.78, [3] = -0.62 },
+    GNOME    = { [2] =  0.64, [3] =  0.72 },
+    TROLL    = { [2] = -0.70, [3] = -0.55 },
+    BLOODELF = { [2] = -0.30, [3] = -0.22 },
+    DRAENEI  = { [2] = -0.62, [3] = -0.55 },
+};
+
+local function CharacterCreate_GetCameraProfile()
+    local _, raceFile = GetNameForRace();
+    local raceProfile = raceFile and CHARACTER_CREATE_CAMERA_PROFILES[strupper(raceFile)];
+    local sex = GetSelectedSex();
+    return 2.0, raceProfile and raceProfile[sex] or -0.20;
+end
+
+local function CharacterCreate_UpdateCamera(immediate)
+    local showFace = CharacterCreate.personalizationMode and not CharacterCreate.gameModeSelectionMode;
+    local mode = showFace and 1 or 0;
+    if CharacterCreate.cameraMode == mode and not immediate then
+        return;
+    end
+
+    CharacterCreate.cameraMode = mode;
+    CharacterCreate:SetCamera(0);
+    if MoonWellSetCharacterCreateCamera then
+        local zoom, verticalOffset = CharacterCreate_GetCameraProfile();
+        MoonWellSetCharacterCreateCamera(mode, zoom, verticalOffset, immediate and 0 or 500);
+    end
+end
+
 -- The stock creation scene frames each race at a different height. Projection
 -- zoom therefore needs a per-race vertical target to keep the face in frame.
 -- Values are indexed by GetSelectedSex(): 2 male, 3 female.
@@ -818,7 +856,7 @@ function CharacterCreate_OnLoad(self)
 	self:SetSequence(0)
 	self:SetCamera(0)
     SetCharCustomizeFrame("CharacterCreate")
-	
+
 	CharacterCreate.numRaces = 0
 	CharacterCreate.selectedRace = 0
 	CharacterCreate.numClasses = 0
@@ -860,7 +898,7 @@ function CharacterCreate_OnLoad(self)
 	AllianceLogoFrame:SetSize(100, 100)
 	AllianceLogoFrame:SetPoint("TOPLEFT", -16, 16)
 	AllianceLogoFrame:EnableMouse(true)
-	
+
 	AllianceLogoFrame:SetScript("OnEnter", function(self)
 		AllianceTooltip.title:SetText(ALLIANCE)
 		AllianceTooltip.description:SetText(FACTION_ALLIANCE_DESCRIPTION)
@@ -869,7 +907,7 @@ function CharacterCreate_OnLoad(self)
 		AllianceTooltip:SetPoint("TOPLEFT", self, "BOTTOMLEFT", 90, 60)
 		AllianceTooltip:Show()
 	end)
-	
+
 	AllianceLogoFrame:SetScript("OnLeave", function(self)
 		AllianceTooltip:Hide()
 	end)
@@ -890,7 +928,7 @@ function CharacterCreate_OnLoad(self)
 	HordeLogoFrame:SetSize(100, 100)
 	HordeLogoFrame:SetPoint("TOPRIGHT", 16, 16)
 	HordeLogoFrame:EnableMouse(true)
-	
+
 	HordeLogoFrame:SetScript("OnEnter", function(self)
 		HordeTooltip.title:SetText(HORDE)
 		HordeTooltip.description:SetText(FACTION_HORDE_DESCRIPTION)
@@ -899,7 +937,7 @@ function CharacterCreate_OnLoad(self)
 		HordeTooltip:SetPoint("TOPRIGHT", self, "BOTTOMRIGHT", -90, 60)
 		HordeTooltip:Show()
 	end)
-	
+
 	HordeLogoFrame:SetScript("OnLeave", function(self)
 		HordeTooltip:Hide()
 	end)
@@ -913,7 +951,7 @@ function CharacterCreate_SetupCustomButtons()
         {button = CharCreateRandomizeButton, width = 36, height = 36},
         {button = CharacterCreateRandomName, width = 30, height = 30}
     }
-    
+
     local texturePath = "Interface\\Glues\\CharacterCreate\\charactercreate"
 
     for _, btnInfo in ipairs(buttons) do
@@ -1002,7 +1040,7 @@ end)
 
 function CharacterCreate_OnShow()
     CharacterCreate.personalizationMode = false;
-    
+
     for i=1, MAX_CLASSES_PER_RACE, 1 do
         local button = _G["CharacterCreateClassButton"..i];
         button:Enable();
@@ -1026,7 +1064,7 @@ function CharacterCreate_OnShow()
     CharacterCreate.personalizationMode = false;
     CharacterCreate.gameModeSelectionMode = false;
     CharCreateOkayButton:Hide();
-    
+
     for i=1, NUM_CHAR_CUSTOMIZATIONS do
         _G["CharacterCustomizationButtonFrame"..i]:Hide();
     end
@@ -1113,11 +1151,11 @@ function CharacterCreateEnumerateRaces(...)
         local raceID = index
         local faction = _G.GetFactionForRaceID(raceID)
         local borderColor
-        
+
         if faction == "Alliance" then
             borderColor = {0.0, 0.4, 1.0}
         else
-            borderColor = {1.0, 0.0, 0.0} 
+            borderColor = {1.0, 0.0, 0.0}
         end
 
         if not button.staticTexture then
@@ -1155,10 +1193,10 @@ function CharacterCreateEnumerateRaces(...)
 		if not button.texturesMoved then
 			button:SetScript("OnMouseDown", nil);
 			button:SetScript("OnMouseUp", nil);
-			
+
 			button.texturesMoved = true;
 		end
-		
+
 		button:Show();
 		if ( select(i+2, ...) == 1 ) then
     		button.enable = true;
@@ -1180,7 +1218,7 @@ function CharacterCreateEnumerateRaces(...)
             		tooltip:Hide()
         		end
     		end)
-    
+
     		button:SetScript("OnMouseDown", function(self, clickedButton)
         		if self:IsEnabled() and clickedButton == "RightButton" then
             		local tooltip = GetOrCreateRaceTooltip(self)
@@ -1246,7 +1284,7 @@ function CharacterCreateEnumerateClasses(...)
 			button.nameFrame = CreateFrame("Frame", nil, button);
 			button.nameFrame:SetSize(112, 40);
 			button.nameFrame:SetPoint("TOP", button, "BOTTOM", 0, -5);
-			
+
 			button.nameFrame.text = button.nameFrame:CreateFontString(nil, "OVERLAY");
 			button.nameFrame.text:SetFont("Fonts\\FRIZQT__.TTF", 10, "OUTLINE");
 			button.nameFrame.text:SetPoint("CENTER", 0, 0);
@@ -1261,10 +1299,10 @@ function CharacterCreateEnumerateClasses(...)
 		if not button.texturesMoved then
 			button:SetScript("OnMouseDown", nil);
 			button:SetScript("OnMouseUp", nil);
-			
+
 			button.texturesMoved = true;
 		end
-		
+
 		button:Show();
 
 		local className = select(i, ...);
@@ -1311,7 +1349,7 @@ function CharacterCreateEnumerateClasses(...)
 					tooltip:Hide()
 				end
 			end)
-			
+
 			button:SetScript("OnMouseDown", function(self, clickedButton)
 				if self:IsEnabled() and clickedButton == "RightButton" then
 					local tooltip = GetOrCreateClassTooltip(self)
@@ -1356,14 +1394,14 @@ function CharacterCreate_CreateGenderButtonTextures()
         maleButton.staticTexture:SetTexture("Interface\\Glues\\CharacterCreate\\IconBorder_F1");
         maleButton.staticTexture:SetSize(86, 86);
         maleButton.staticTexture:SetPoint("CENTER", 0, 0);
-        
+
         maleButton.highlightTexture = maleButton:CreateTexture(maleButton:GetName().."HighlightTexture", "HIGHLIGHT");
         maleButton.highlightTexture:SetTexture("Interface\\Glues\\CharacterCreate\\IconBorder_F1");
         maleButton.highlightTexture:SetAlpha(0.5);
         maleButton.highlightTexture:SetBlendMode("ADD");
         maleButton.highlightTexture:SetSize(86, 86);
         maleButton.highlightTexture:SetPoint("CENTER", 0, 0);
-        
+
         maleButton.checkedTexture = maleButton:CreateTexture(maleButton:GetName().."CheckedTexture", "OVERLAY");
         maleButton.checkedTexture:SetDrawLayer("OVERLAY", 7);
         maleButton.checkedTexture:SetTexture("Interface\\Glues\\CharacterCreate\\IconBorderRace_H");
@@ -1382,14 +1420,14 @@ function CharacterCreate_CreateGenderButtonTextures()
         femaleButton.staticTexture:SetTexture("Interface\\Glues\\CharacterCreate\\IconBorder_F1");
         femaleButton.staticTexture:SetSize(86, 86);
         femaleButton.staticTexture:SetPoint("CENTER", 0, 0);
-        
+
         femaleButton.highlightTexture = femaleButton:CreateTexture(femaleButton:GetName().."HighlightTexture", "HIGHLIGHT");
         femaleButton.highlightTexture:SetTexture("Interface\\Glues\\CharacterCreate\\IconBorder_F1");
         femaleButton.highlightTexture:SetAlpha(0.5);
         femaleButton.highlightTexture:SetBlendMode("ADD");
         femaleButton.highlightTexture:SetSize(86, 86);
         femaleButton.highlightTexture:SetPoint("CENTER", 0, 0);
-        
+
         femaleButton.checkedTexture = femaleButton:CreateTexture(femaleButton:GetName().."CheckedTexture", "OVERLAY");
         femaleButton.checkedTexture:SetDrawLayer("OVERLAY", 7);
         femaleButton.checkedTexture:SetTexture("Interface\\Glues\\CharacterCreate\\IconBorderRace_H");
@@ -1480,7 +1518,7 @@ function SetCharacterClass(id)
 	end
 
 	CharacterCreate_UpdateButtonCheckedStates();
-	
+
 	local className, classFileName, _, tank, healer, damage = GetSelectedClass();
 	local abilityIndex = 0;
 	local tempText = _G["CLASS_INFO_"..classFileName..abilityIndex];
@@ -1493,7 +1531,7 @@ function SetCharacterClass(id)
 	local coords = CLASS_ICON_TCOORDS[classFileName];
 	CharacterCreateClassIcon:SetTexCoord(coords[1], coords[2], coords[3], coords[4]);
 	CharacterCreateClassLabel:SetText(className);
-	CharacterCreateClassRolesText:SetText(abilityText);	
+	CharacterCreateClassRolesText:SetText(abilityText);
 	CharacterCreateClassText:SetText(GetFlavorText("CLASS_"..strupper(classFileName), GetSelectedSex()).."|n|n");
 	CharacterCreateClassScrollFrameScrollBar:SetValue(0);
 end
@@ -1529,7 +1567,7 @@ function CharacterCreate_UpdateButtonCheckedStates()
 
     local maleButton = CharacterCreateGenderButtonMale;
     local femaleButton = CharacterCreateGenderButtonFemale;
-    
+
     if maleButton and maleButton.checkedTexture then
         if maleButton:GetChecked() then
             maleButton.checkedTexture:Show();
@@ -1537,7 +1575,7 @@ function CharacterCreate_UpdateButtonCheckedStates()
             maleButton.checkedTexture:Hide();
         end
     end
-    
+
     if femaleButton and femaleButton.checkedTexture then
         if femaleButton:GetChecked() then
             femaleButton.checkedTexture:Show();
@@ -1641,7 +1679,7 @@ function CharacterRace_OnClick(self, id)
         SetCharacterClass(classIndex);
 
         CharacterCreate_UpdateHairCustomization();
-            
+
         CharacterChangeFixup();
 
         CharacterCreate_UpdateButtonCheckedStates();
@@ -1666,7 +1704,7 @@ function SetCharacterGender(sex)
 	CharacterCreateEnumerateRaces(GetAvailableRaces());
 	CharacterCreateEnumerateClasses(GetAvailableClasses());
  	SetCharacterRace(GetSelectedRace());
-	
+
 	local _,_,classIndex = GetSelectedClass();
 	if ( PAID_SERVICE_TYPE ) then
 		classIndex = PaidChange_GetCurrentClassIndex();
@@ -1680,7 +1718,7 @@ function SetCharacterGender(sex)
 	fileString = strupper(fileString);
 	local coords = RACE_ICON_TCOORDS[fileString.."_"..gender];
 	CharacterCreateRaceIcon:SetTexCoord(coords[1], coords[2], coords[3], coords[4]);
-	
+
 	CharacterChangeFixup();
 
 	CharacterCreate_UpdateButtonCheckedStates();
@@ -1707,7 +1745,7 @@ function CharacterCreate_ResetState(immediate)
     CharCreatePersonalizeButton:Show();
     CharCreateOkayButton:Hide();
     CharacterCreate_UpdateGameModeVisibility();
-    
+
     for i=1, NUM_CHAR_CUSTOMIZATIONS do
         _G["CharacterCustomizationButtonFrame"..i]:Hide();
     end
@@ -1753,7 +1791,7 @@ end
 function CharacterCreate_UpdateHairCustomization()
 	CharacterCustomizationButtonFrame3Text:SetText(_G["HAIR_"..GetHairCustomization().."_STYLE"]);
 	CharacterCustomizationButtonFrame4Text:SetText(_G["HAIR_"..GetHairCustomization().."_COLOR"]);
-	CharacterCustomizationButtonFrame5Text:SetText(_G["FACIAL_HAIR_"..GetFacialHairCustomization()]);		
+	CharacterCustomizationButtonFrame5Text:SetText(_G["FACIAL_HAIR_"..GetFacialHairCustomization()]);
 end
 
 function SetButtonDesaturated(button, desaturated, r, g, b)
@@ -1775,7 +1813,7 @@ function SetButtonDesaturated(button, desaturated, r, g, b)
 		g = 0.5;
 		b = 0.5;
 	end
-	
+
 	icon:SetVertexColor(r, g, b);
 end
 

src/Data/ruRU/patch-ruRU-4/Interface/GlueXML/CharacterSelect.lua

@@ -1139,6 +1139,12 @@ end
 function CharacterSelect_EnterWorld()
 	PlaySound("gsCharacterSelectionEnterWorld");
 	StopGlueAmbience();
+	-- Persist the server-provided game-mode bit across the GlueXML -> FrameXML
+	-- Lua-state transition. WarcraftXL owns the value for this Wow.exe process.
+	if ( type(MoonWellSetLoginCharacterFlags) == "function" ) then
+		local info = { GetCharacterInfo(CharacterSelect.selectedIndex) };
+		MoonWellSetLoginCharacterFlags(info[11] or 0);
+	end
 	EnterWorld();
 end
 

src/Data/ruRU/patch-ruRU-5/Interface/AddOns/MoonWellClient/AchievementFactions.lua

@@ -0,0 +1,202 @@
+-- The MoonWell Achievement.dbc intentionally exposes both faction variants.
+-- Restore the 3.3.5a client-side faction filter and make traitors use the
+-- opposite faction. IDs come from the stock ruRU build 12340 DBC.
+
+local achievementFaction = {}
+
+local function AddFaction(ids, faction)
+    for id in string.gmatch(ids, "%d+") do
+        achievementFaction[tonumber(id)] = faction
+    end
+end
+
+AddFaction([[
+33 34 35 37 41 58 202 203 206 220 225 230 246 388 433 434 435 436 437 438
+439 440 441 442 470 471 472 473 604 610 611 612 613 614 701 707 709 711 713
+764 899 907 908 942 948 963 966 969 970 1012 1022 1023 1024 1028 1029 1030
+1034 1035 1038 1040 1151 1167 1169 1172 1184 1189 1191 1192 1255 1262 1279
+1466 1563 1656 1676 1678 1681 1684 1686 1692 1697 1707 1737 1752 1757 1762
+1782 2016 2144 2194 2419 2421 2536 2760 2761 2762 2763 2764 2770 2777 2778
+2779 2780 2781 2782 2797 2817 3356 3478 3556 3576 3580 3596 3676 3846 3851
+3856 3857 4156 4296 4298 4436 4784 4786
+]], "Alliance")
+
+AddFaction([[
+224 259 443 444 445 446 447 448 449 450 451 452 453 454 468 469 593 603 615
+616 617 618 619 700 706 708 710 712 714 762 763 873 901 909 926 943 965 967
+968 971 1005 1006 1011 1025 1026 1027 1031 1032 1033 1036 1037 1039 1041
+1164 1168 1170 1173 1175 1203 1251 1252 1271 1272 1273 1274 1280 1356 1357
+1358 1359 1360 1502 1657 1677 1680 1682 1683 1685 1691 1693 1698 1783 1784
+2017 2145 2192 2195 2200 2420 2476 2497 2537 2765 2766 2767 2768 2769 2771
+2776 2783 2784 2785 2786 2787 2788 2798 2816 3357 3557 3577 3581 3597 3656
+3677 3778 3957 4079 4176 4177 4256 4297 4437 4785 4790
+]], "Horde")
+
+local NativeGetAchievementInfo = GetAchievementInfo
+local NativeGetCategoryNumAchievements = GetCategoryNumAchievements
+local NativeGetLatestCompletedAchievements = GetLatestCompletedAchievements
+local NativeGetTrackedAchievements = GetTrackedAchievements
+local NativeGetNumCompletedAchievements = GetNumCompletedAchievements
+local NativeGetTotalAchievementPoints = GetTotalAchievementPoints
+
+local categoryCache = {}
+local summaryCache = {}
+
+local function GetDisplayFaction()
+    local faction = UnitFactionGroup("player")
+    if MoonWell_IsTraitor then
+        if faction == "Alliance" then
+            return "Horde"
+        elseif faction == "Horde" then
+            return "Alliance"
+        end
+    end
+    return faction
+end
+
+local function IsAchievementVisible(id, faction)
+    local requiredFaction = achievementFaction[id]
+    return not requiredFaction or not faction or requiredFaction == faction
+end
+
+local function BuildCategory(categoryID, showAll)
+    local faction = GetDisplayFaction()
+    local key = tostring(categoryID) .. ":" .. tostring(showAll and 1 or 0)
+        .. ":" .. tostring(faction) .. ":" .. tostring(MoonWell_IsTraitor)
+    local cached = categoryCache[key]
+    if cached then
+        return cached
+    end
+
+    local nativeCount = NativeGetCategoryNumAchievements(categoryID, showAll)
+    local indices = {}
+    local completed = 0
+
+    for nativeIndex = 1, nativeCount do
+        local id, _, _, isCompleted = NativeGetAchievementInfo(categoryID, nativeIndex)
+        if id and IsAchievementVisible(id, faction) then
+            indices[#indices + 1] = nativeIndex
+            if isCompleted then
+                completed = completed + 1
+            end
+        end
+    end
+
+    cached = { indices = indices, completed = completed }
+    categoryCache[key] = cached
+    return cached
+end
+
+function GetCategoryNumAchievements(categoryID, showAll)
+    local category = BuildCategory(categoryID, showAll)
+    return #category.indices, category.completed
+end
+
+function GetAchievementInfo(idOrCategory, achievementIndex)
+    if achievementIndex == nil then
+        return NativeGetAchievementInfo(idOrCategory)
+    end
+
+    local category = BuildCategory(idOrCategory, false)
+    local nativeIndex = category.indices[achievementIndex]
+    if not nativeIndex then
+        return nil
+    end
+    return NativeGetAchievementInfo(idOrCategory, nativeIndex)
+end
+
+local function BuildSummary()
+    local faction = GetDisplayFaction()
+    local key = tostring(faction) .. ":" .. tostring(MoonWell_IsTraitor)
+    local cached = summaryCache[key]
+    if cached then
+        return cached
+    end
+
+    local total, completed = NativeGetNumCompletedAchievements()
+    local points = NativeGetTotalAchievementPoints()
+    local statisticFlag = ACHIEVEMENT_FLAGS_STATISTIC or 0x00000001
+    local hiddenFlag = ACHIEVEMENT_FLAGS_HIDDEN or 0x00000002
+
+    for id, requiredFaction in pairs(achievementFaction) do
+        if faction and requiredFaction ~= faction then
+            local _, _, achievementPoints, isCompleted, _, _, _, _, flags =
+                NativeGetAchievementInfo(id)
+            if flags and bit.band(flags, statisticFlag) == 0 then
+                local isHidden = bit.band(flags, hiddenFlag) ~= 0
+                if not isHidden or isCompleted then
+                    total = total - 1
+                end
+                if isCompleted then
+                    completed = completed - 1
+                    points = points - (achievementPoints or 0)
+                end
+            end
+        end
+    end
+
+    cached = { total = total, completed = completed, points = points }
+    summaryCache[key] = cached
+    return cached
+end
+
+function GetNumCompletedAchievements()
+    local summary = BuildSummary()
+    return summary.total, summary.completed
+end
+
+function GetTotalAchievementPoints()
+    return BuildSummary().points
+end
+
+local function FilterAchievementIDs(getter)
+    local faction = GetDisplayFaction()
+    local source = { getter() }
+    local filtered = {}
+    for i = 1, #source do
+        if IsAchievementVisible(source[i], faction) then
+            filtered[#filtered + 1] = source[i]
+        end
+    end
+    return unpack(filtered)
+end
+
+if NativeGetLatestCompletedAchievements then
+    function GetLatestCompletedAchievements()
+        return FilterAchievementIDs(NativeGetLatestCompletedAchievements)
+    end
+end
+
+if NativeGetTrackedAchievements then
+    function GetTrackedAchievements()
+        return FilterAchievementIDs(NativeGetTrackedAchievements)
+    end
+end
+
+function MoonWellAchievementFaction_Refresh()
+    categoryCache = {}
+    summaryCache = {}
+    if AchievementFrame and AchievementFrame:IsShown() then
+        if AchievementFrameCategories_Update then
+            AchievementFrameCategories_Update()
+        end
+        if AchievementFrameAchievements_ForceUpdate then
+            AchievementFrameAchievements_ForceUpdate()
+        elseif AchievementFrameAchievements_Update then
+            AchievementFrameAchievements_Update()
+        end
+        if AchievementFrameSummary_Update then
+            AchievementFrameSummary_Update()
+        end
+    end
+end
+
+local events = CreateFrame("Frame")
+events:RegisterEvent("ACHIEVEMENT_EARNED")
+events:RegisterEvent("PLAYER_ENTERING_WORLD")
+events:RegisterEvent("UNIT_FACTION")
+events:SetScript("OnEvent", function(self, event, unit)
+    if event ~= "UNIT_FACTION" or unit == "player" then
+        MoonWellAchievementFaction_Refresh()
+    end
+end)

src/Data/ruRU/patch-ruRU-5/Interface/AddOns/MoonWellClient/MoonWellClient.lua

@@ -1,62 +1,85 @@
--- ============================================================================
--- MoonWell Client
--- Server integration: game modes, traitor faction display
--- ============================================================================
+-- MoonWell client game-mode integration.
+-- WarcraftXL retains the selected character's server-provided charFlags while
+-- WoW replaces the GlueXML Lua state with the in-world FrameXML state.
 
--- Global flag read by FrameXML files to decide which faction icon to show.
--- true  = show opposite faction icon (traitor)
--- false = show real faction icon (normal)
 MoonWell_IsTraitor = false
 
--- ============================================================================
--- AIO handler — called by server on login
--- Server: AIO:Handle(player, "MoonWellClient", "Init", gameMode)
---   gameMode: 0 = normal, 1 = traitor
--- ============================================================================
-
-if not AIO then
-    return
-end
-
-local Handler = AIO.AddHandlers("MoonWellClient", {})
-
-local function MoonWell_RefreshFactionIcons()
-    -- Portrait PvP icon
+local function RefreshFactionIcons()
     if PlayerFrame_UpdatePvPStatus then
         PlayerFrame_UpdatePvPStatus()
     end
-    -- DragonUI PvP micro button: SetupPVPButton() runs on load before AIO responds,
-    -- so we refresh its DragonUIPVPIcon texture directly after Init.
+
+    if PVPFrame and PVPFrame:IsShown() and PVPFrame_Update then
+        PVPFrame_Update()
+    end
+    if BattlefieldFrame and BattlefieldFrame:IsShown() and BattlefieldFrame_Update then
+        BattlefieldFrame_Update()
+    end
+
     if PVPMicroButton and PVPMicroButton.DragonUIPVPIcon then
         local factionGroup = UnitFactionGroup("player")
         if factionGroup then
             local displayFaction = MoonWell_IsTraitor
                 and (factionGroup == "Alliance" and "Horde" or "Alliance")
                 or factionGroup
-            local microTexture = "Interface\\AddOns\\DragonUI\\Textures\\Micromenu\\micropvp"
+            local texture = "Interface\\AddOns\\DragonUI\\Textures\\Micromenu\\micropvp"
             local icon = PVPMicroButton.DragonUIPVPIcon
+            local highlight = PVPMicroButton:GetHighlightTexture()
+
             if displayFaction == "Alliance" then
-                icon:SetTexture(microTexture)
+                icon:SetTexture(texture)
                 icon:SetTexCoord(0, 118/256, 0, 151/256)
+                if highlight then
+                    highlight:SetTexture(texture)
+                    highlight:SetTexCoord(0, 118/256, 0, 151/256)
+                end
             elseif displayFaction == "Horde" then
-                icon:SetTexture(microTexture)
+                icon:SetTexture(texture)
                 icon:SetTexCoord(118/256, 236/256, 0, 151/256)
-            end
-            local hl = PVPMicroButton:GetHighlightTexture()
-            if hl then
-                if displayFaction == "Alliance" then
-                    hl:SetTexture(microTexture)
-                    hl:SetTexCoord(0, 118/256, 0, 151/256)
-                elseif displayFaction == "Horde" then
-                    hl:SetTexture(microTexture)
-                    hl:SetTexCoord(118/256, 236/256, 0, 151/256)
+                if highlight then
+                    highlight:SetTexture(texture)
+                    highlight:SetTexCoord(118/256, 236/256, 0, 151/256)
                 end
             end
         end
     end
 end
 
-function Handler.Init(_, mode)
-    MoonWell_IsTraitor = (tonumber(mode) == 1)
-    MoonWell_RefreshFactionIcons()
+local function ReadNativeGameMode()
+    if type(MoonWellIsTraitor) ~= "function" then
+        return false
+    end
+
+    local wasTraitor = MoonWell_IsTraitor
+    MoonWell_IsTraitor = MoonWellIsTraitor() and true or false
+    if wasTraitor ~= MoonWell_IsTraitor and MoonWellAchievementFaction_Refresh then
+        MoonWellAchievementFaction_Refresh()
+    end
+    RefreshFactionIcons()
+    return true
 end
+
+local events = CreateFrame("Frame")
+events:RegisterEvent("PLAYER_LOGIN")
+events:RegisterEvent("PLAYER_ENTERING_WORLD")
+events:RegisterEvent("UNIT_FACTION")
+events:SetScript("OnEvent", function(self, event, unit)
+    if event ~= "UNIT_FACTION" or unit == "player" then
+        ReadNativeGameMode()
+    end
+end)
+
+-- WarcraftXL may publish its Lua globals shortly after addons are loaded.
+-- Lua 5.1/WotLK has no C_Timer, so retry cheaply until the native API appears.
+local elapsedTotal = 0
+events:SetScript("OnUpdate", function(self, elapsed)
+    elapsedTotal = elapsedTotal + elapsed
+    if elapsedTotal < 0.25 then
+        return
+    end
+    elapsedTotal = 0
+
+    if ReadNativeGameMode() then
+        self:SetScript("OnUpdate", nil)
+    end
+end)

src/Data/ruRU/patch-ruRU-5/Interface/AddOns/MoonWellClient/MoonWellClient.toc

@@ -1,13 +1,13 @@
 ## Interface: 30300
 ## Title: MoonWell Client
-## Notes: MoonWell server integration — game modes, traitor faction display
-## Version: 1.0.0
+## Notes: Native WarcraftXL game-mode and traitor faction display
+## Version: 2.0.0
 ## Author: MoonWell
 ## SavedVariables: MoonWellClientDB
-## Dependencies: AIO_Client
 ## DefaultState: Enabled
 ## X-Hidden: 1
 
+AchievementFactions.lua
 MoonWellClient.lua
 EncounterJournal\EncounterJournalCompat.lua
 EncounterJournal\SharedXML\SoundKitConstants.lua