полный переход на warcraft xl

2026-07-18 15:48:07 +04:00
parent 08c1b9da3f
commit 26ff2b3b94
19 changed files with 748 additions and 403 deletions
@@ -1,90 +1,143 @@
 # MoonWell Client Sources

-Репозиторий с ресурсами и исполняемым файлом модифицированного клиента World of Warcraft 3.3.5a.
+Исходники клиентских изменений MoonWell для World of Warcraft 3.3.5a (build 12340).

-Основная цель проекта: хранить и сопровождать клиентские изменения поверх стандартных MPQ-пакетов WoW, включая интерфейс, графику, звук и дополнительные данные для кастомных систем сервера.
+Клиент переведён на [WarcraftXL](https://github.com/WarcraftXL): `Wow.exe` больше не содержит
+MoonWell-патчей. Неподписанный оригинальный executable загружается как обычно, локальный
+`d3d9.dll` proxy подхватывает `WarcraftXL.dll`, а модуль MoonWell применяет проверенные изменения
+только к памяти запущенного процесса.

-## Что находится в репозитории
+## Что перенесено из модифицированного Wow.exe

- `Wow.exe` - модифицированный клиентский исполняемый файл.
-  - Поддерживает использование до 4 ГБ ОЗУ.
-  - Игнорирует блокирование изменений в исходниках `GlueXML`, что позволяет вносить свои изменения в интерфейс и модели.
- `patch-4/` - наши изменения поверх стандартного `patch-4.MPQ`.
-  - Содержит графические элементы внутриигрового магазина.
-  - Основная зона изменений: `Interface/Store_UI`.
- `patch-ruRU-4/` - наши изменения поверх стандартных `patch-ruRU-1.MPQ`, `patch-ruRU-2.MPQ` и `patch-ruRU-3.MPQ`.
-  - Содержит ресурсы локали `ruRU`, связанные с экраном входа, `GlueXML`, заставками и звуком.
-  - Внутри есть `Interface/GlueXML`, `Interface/Glues`, `Interface/LoginScreen`, `Sound/Ambience`, `Sound/Music`.
- `patch-ruRU-5/` - пакет русской локализации и дополнительных интерфейсных ресурсов.
-  - Содержит перевод на русский язык для glue-интерфейса и связанных экранов клиента.
-  - Внутри есть `Interface/GlueXML`, `Interface/Glues`, `Interface/GluesVideo`, `Interface/Loginscreen`, `Interface/tooltips`, `Interface/cinematics`.
- `patch-Z/` - кастомный пакет для модуля Mythic+.
-  - Содержит графические ресурсы Mythic+.
-  - Также включает связанные клиентские данные в `DBFielsClient/` и иконки в `Interface/Icons/`.
+- разблокировка пользовательского `GlueXML`;
+- `CreateCharacter(name, modeId)` и поле режима в `CMSG_CHAR_CREATE`;
+- одиннадцатое значение `GetCharacterInfo` — `charFlags`, включая флаг предателя `0x40000000`;
+- загрузка WarcraftXL без import-table patch и без отдельного injector.

-## Структура по назначению
+Large Address Aware намеренно не включён: Windows читает этот PE-флаг до загрузки DLL, поэтому
+сохранить его и одновременно оставить файл байт-в-байт оригинальным невозможно. Это означает
+стандартный 2-ГБ лимит адресного пространства для 32-битного клиента.

-### Внутриигровой магазин
+## Структура

-Файлы магазина находятся в [`patch-4/Interface/Store_UI`](./patch-4/Interface/Store_UI).
+```text
+modules/moonwell/        MoonWell runtime-модуль WarcraftXL
+vendor/warcraftxl/       закреплённый upstream git submodule
+vendor/modules/          закреплённые модули WarcraftXL
+src/Data/                исходники MPQ-патчей
+tool/                    сборщик MPQ
+build-warcraftxl.ps1     сборка Win32 runtime/proxy и x64 asset host
+run.ps1                  полная сборка, установка и запуск клиента
+Wow_Original.exe         локальный оригинал build 12340 (не хранится в Git)
+```

-Примеры ресурсов:
+Подключены модули `wxl-modern-assets`, `wxl-modern-render`, `wxl-unit-outline` и
+`wxl-modern-adt`. Их точные ревизии вместе с ревизией ядра закреплены git submodule.
+Для обновления всех зависимостей WarcraftXL:

- `Currencies/Gold.blp`
- `Currencies/Token.blp`
- `Frames/StoreFrame_Main.blp`
+```powershell
+git submodule update --remote vendor/warcraftxl vendor/modules/*
+```

-### Экран входа и локализованные ресурсы
+После обновления обязательно пересоберите и проверьте вход/создание персонажа: API WarcraftXL
+пока развивается.

-Файлы экрана входа и связанные ресурсы находятся в [`patch-ruRU-4`](./patch-ruRU-4).
+## Требования

-Основные каталоги:
+- Visual Studio 2022 с C++ toolchain для Win32 и x64;
+- CMake 3.20+;
+- Rust/Cargo для существующего MPQ-сборщика;
+- локальный оригинальный `Wow_Original.exe` с SHA-256
+  `AA63A5750D60EF16746C686B3D5E26876D98953EAB08B1C026CD0FAF78E88CB8`.

- `Interface/GlueXML` - Lua/XML-исходники интерфейса загрузки и логина
- `Interface/Glues` - графика и модели для glue-экрана
- `Interface/LoginScreen` - фон и связанные изображения
- `Sound/Ambience/GlueScreen` - фоновые звуки
- `Sound/Music/GlueScreenMusic` - музыка экрана входа
+После клонирования инициализируйте submodule:

-### Русский перевод для `patch-ruRU-5`
+```powershell
+git submodule update --init --recursive
+```

-Файлы русской локализации и расширенного glue-интерфейса находятся в [`patch-ruRU-5`](./patch-ruRU-5).
+## Сборка WarcraftXL

-Основные каталоги:
+Быстрое полное развёртывание клиента одной командой:

- `Interface/GlueXML` - Lua/XML-исходники экранов логина, выбора реалма, выбора и создания персонажа
- `Interface/Glues` - текстуры, кнопки, логотипы и элементы интерфейса для `CharacterCreate` и `CharacterSelect`
- `Interface/GluesVideo` - видеоресурсы и ассеты glue-экранов
- `Interface/Loginscreen` - фон и изображения экрана входа
- `Interface/tooltips` - локализованные рамки и оформление тултипов
- `Interface/cinematics` - элементы интерфейса для роликов и заставок
+```powershell
+.\deploy.ps1
+```

-Этот пакет используется как слой русификации для дополнительных экранов клиента и их визуальных элементов.
+Скрипт инициализирует зависимости, собирает MPQ-патчи, Win32 runtime, D3D9 proxy и x64 Host,
+обновляет `dist`, устанавливает комплект в клиент и формирует `manifest.json`. Путь берётся из
+`WOW_HOME`/`.env`, а при их отсутствии используется `C:\Program Files (x86)\World of Warcraft`.

-### Mythic+
+Полезные варианты:

-Файлы Mythic+ находятся в [`patch-Z`](./patch-Z).
+```powershell
+# Явный путь и запуск клиента после установки
+.\deploy.ps1 -ClientPath 'D:\Games\World of Warcraft' -StopClient -Launch

-Основные каталоги:
+# Быстро обновить только WarcraftXL без пересборки MPQ
+.\deploy.ps1 -SkipDataBuild

- `Interface/MythicPlus/textures` - текстуры интерфейса Mythic+
- `Interface/MythicPlus/sounds` - звуки таймеров и событий
- `Interface/Icons` - дополнительные иконки
- `DBFielsClient` - клиентские DBC-данные, связанные с отображением предметов и интерфейсом
+# Аварийный native D3D9 вместо D3D9On12
+.\deploy.ps1 -NativeRenderer
+```

-## Как воспринимать содержимое репозитория
+Без установки в клиент:

- Каталоги `patch-*` представляют содержимое соответствующих MPQ-патчей в распакованном виде.
- Названия каталогов соответствуют именам клиентских патч-пакетов, поверх которых вносятся наши изменения.
- Репозиторий не является полной копией клиента WoW, а только набором модифицированных клиентских ресурсов и исполняемого файла.
+```powershell
+.\build-warcraftxl.ps1 -Configuration Release
+```

-## Для чего используется
+С установкой:

-Проект нужен для сопровождения клиентской части MoonWell:
+```powershell
+.\build-warcraftxl.ps1 -Configuration Release `
+  -ClientPath 'C:\Program Files (x86)\World of Warcraft' -Deploy
+```

- кастомизации GlueXML;
- поддержки русского перевода для `patch-ruRU-5`;
- поддержки внутриигрового магазина;
- добавления графики и данных для Mythic+;
- хранения пакетов графических улучшений;
- работы с модифицированным `Wow.exe` для WoW 3.3.5a.
+При `-Deploy` скрипт:
+
+1. проверяет хеш `Wow_Original.exe`;
+2. сохраняет прежний модифицированный клиент как `Wow.moonwell-patched.backup.exe`;
+3. восстанавливает оригинальный `Wow.exe`;
+4. устанавливает `WarcraftXL.dll`, D3D9On12 proxy и `Utils\WarcraftXLHost.exe`;
+5. монтирует шейдеры modern ADT как loose patch `Data\Patch-WXL.MPQ`;
+6. при `-PackagePath` кладёт полный runtime-комплект в `dist` для launcher/S3.
+
+Основной proxy использует D3D9On12, необходимый `wxl-modern-render`. Эффекты постобработки в самом
+модуле по умолчанию выключены. Для диагностики или несовместимой видеосистемы можно собрать и
+установить native-переходник без modern-render:
+
+```powershell
+.\build-warcraftxl.ps1 -Configuration Release -NativeRenderer `
+  -ClientPath 'C:\Program Files (x86)\World of Warcraft' -Deploy
+```
+
+Резервная DLL всегда также сохраняется как `Utils\d3d9-native.dll`.
+
+Полная сборка MPQ, установка WarcraftXL и запуск:
+
+```powershell
+$env:WOW_HOME = 'C:\Program Files (x86)\World of Warcraft'
+.\run.ps1
+```
+
+Диагностика запуска находится в `Logs\wxl-core.log`, `Logs\d3d9proxy.log` и
+`Utils\WarcraftXLHost.log` внутри клиента.
+
+## MPQ-пакеты
+
+Распакованные изменяемые слои уже находятся в `src/Data/`; полный набор базовых MPQ для сборки
+WarcraftXL не требуется и в объектное хранилище не загружается.
+
+Основные пакеты:
+
+- `patch-4` — ресурсы внутриигрового магазина;
+- `patch-ruRU-4` — экран входа и GlueXML;
+- `patch-ruRU-5` — русская локализация и интерфейс;
+- `patch-Z` — Mythic+ ресурсы и клиентские данные.
+
+## Лицензирование
+
+WarcraftXL распространяется по GPL-3.0 и подключён как отдельный upstream submodule. MoonWell-модуль,
+скомпонованный в `WarcraftXL.dll`, должен распространяться с соблюдением GPL-3.0 и доступным
+соответствующим исходным кодом. Репозиторий не должен публиковать Blizzard assets или `Wow.exe`.