Files
moonwell-client/README.md
T
2026-03-15 15:43:20 +04:00

82 lines
5.0 KiB
Markdown

# 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.