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

5.0 KiB

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.

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

  • 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 - музыка экрана входа

Mythic+

Файлы Mythic+ находятся в 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.