moonwell-client/README.md

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-ruRU-5/ - пакет русской локализации и дополнительных интерфейсных ресурсов.
  • Содержит перевод на русский язык для glue-интерфейса и связанных экранов клиента.
  • Внутри есть Interface/GlueXML, Interface/Glues, Interface/GluesVideo, Interface/Loginscreen, Interface/tooltips, Interface/cinematics.
• patch-Z/ - кастомный пакет для модуля Mythic+.
  • Содержит графические ресурсы Mythic+.
  • Также включает связанные клиентские данные в DBFielsClient/ и иконки в Interface/Icons/.

Структура по назначению

Внутриигровой магазин

Файлы магазина находятся в patch-4/Interface/Store_UI.

Примеры ресурсов:

• Currencies/Gold.blp
• Currencies/Token.blp
• Frames/StoreFrame_Main.blp

Экран входа и локализованные ресурсы

Файлы экрана входа и связанные ресурсы находятся в patch-ruRU-4.

Основные каталоги:

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

Русский перевод для patch-ruRU-5

Файлы русской локализации и расширенного glue-интерфейса находятся в patch-ruRU-5.

Основные каталоги:

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

Этот пакет используется как слой русификации для дополнительных экранов клиента и их визуальных элементов.

Mythic+

Файлы Mythic+ находятся в patch-Z.

Основные каталоги:

• Interface/MythicPlus/textures - текстуры интерфейса Mythic+
• Interface/MythicPlus/sounds - звуки таймеров и событий
• Interface/Icons - дополнительные иконки
• DBFielsClient - клиентские DBC-данные, связанные с отображением предметов и интерфейсом

Как воспринимать содержимое репозитория

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

Для чего используется

Проект нужен для сопровождения клиентской части MoonWell:

• кастомизации GlueXML;
• поддержки русского перевода для patch-ruRU-5;
• поддержки внутриигрового магазина;
• добавления графики и данных для Mythic+;
• хранения пакетов графических улучшений;
• работы с модифицированным Wow.exe для WoW 3.3.5a.