initial commit

2026-03-15 15:20:46 +04:00
commit d029047678
131 changed files with 12269 additions and 0 deletions
@@ -0,0 +1,81 @@
+# MoonWell Client Sources
+
+Репозиторий с ресурсами и исполняемым файлом модифицированного клиента World of Warcraft 3.3.5a.
+
+Основная цель проекта: хранить и сопровождать клиентские изменения поверх стандартных MPQ-пакетов WoW, включая интерфейс, графику, звук и дополнительные данные для кастомных систем сервера.
+
+## Что находится в репозитории
+
+- `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-Z/` - кастомный пакет для модуля Mythic+.
+  - Содержит графические ресурсы Mythic+.
+  - Также включает связанные клиентские данные в `DBFielsClient/` и иконки в `Interface/Icons/`.
+- `patch-ruRU-AW.zip` - архив с MPQ-пакетами для графических улучшений.
+
+## Структура по назначению
+
+### Внутриигровой магазин
+
+Файлы магазина находятся в [`patch-4/Interface/Store_UI`](./patch-4/Interface/Store_UI).
+
+Примеры ресурсов:
+
+- `Currencies/Gold.blp`
+- `Currencies/Token.blp`
+- `Frames/StoreFrame_Main.blp`
+
+### Экран входа и локализованные ресурсы
+
+Файлы экрана входа и связанные ресурсы находятся в [`patch-ruRU-4`](./patch-ruRU-4).
+
+Основные каталоги:
+
+- `Interface/GlueXML` - Lua/XML-исходники интерфейса загрузки и логина
+- `Interface/Glues` - графика и модели для glue-экрана
+- `Interface/LoginScreen` - фон и связанные изображения
+- `Sound/Ambience/GlueScreen` - фоновые звуки
+- `Sound/Music/GlueScreenMusic` - музыка экрана входа
+
+### Mythic+
+
+Файлы Mythic+ находятся в [`patch-Z`](./patch-Z).
+
+Основные каталоги:
+
+- `Interface/MythicPlus/textures` - текстуры интерфейса Mythic+
+- `Interface/MythicPlus/sounds` - звуки таймеров и событий
+- `Interface/Icons` - дополнительные иконки
+- `DBFielsClient` - клиентские DBC-данные, связанные с отображением предметов и интерфейсом
+
+## Важное ограничение
+
+Текущий `Wow.exe` игнорирует изменения в исходниках `GlueXML`. Это означает, что правки в:
+
+- `patch-ruRU-4/Interface/GlueXML/*.lua`
+- `patch-ruRU-4/Interface/GlueXML/*.xml`
+
+могут храниться в репозитории как исходники или справочный материал, но не обязательно будут подхватываться этим исполняемым файлом во время запуска клиента.
+
+## Как воспринимать содержимое репозитория
+
+- Каталоги `patch-*` представляют содержимое соответствующих MPQ-патчей в распакованном виде.
+- Названия каталогов соответствуют именам клиентских патч-пакетов, поверх которых вносятся наши изменения.
+- Репозиторий не является полной копией клиента WoW, а только набором модифицированных клиентских ресурсов и исполняемого файла.
+
+## Для чего используется
+
+Проект нужен для сопровождения клиентской части MoonWell:
+
+- кастомизации экрана входа;
+- поддержки внутриигрового магазина;
+- добавления графики и данных для Mythic+;
+- хранения пакетов графических улучшений;
+- работы с модифицированным `Wow.exe` для WoW 3.3.5a.