Files
sindoring 3a42406898 Quest map: what the character handed in comes from the server
On entering the world the map asks `.mwquests` and takes the server's list
of rewarded quests as its history (the full list replaces it when its
count holds), then adds each "+id" as a quest is rewarded. Once the list is
in, nothing is guessed from the log's chains. Needs the MoonWell server
with `.mwquests`; an older one answers that the command does not exist.

Checked live on the local server: history equals the server's after login
and after a forced resync, a reward arrives at once.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 14:20:50 +04:00
..
2026-10-28 18:52:29 +04:00

MoonWell UI: Forever UI для клиента 1.12.1

Форк mod-forever-ui для MoonWell, то есть для клиента benilla (World of Warcraft 1.12.1). Апстрим написан под 3.3.5a. Здесь его переносят на API 1.12 и поставляют отдельным патчем, без правок исходников клиента.

Что где лежит

  • data/ — апстрим как есть: аддон и экраны входа под 3.3.5, арт, данные сервера. Это эталон для порта и источник арта. Здесь не правим, чтобы git merge upstream/main проходил без конфликтов.
  • vanilla/ — порт под 1.12:
    • Interface/FrameXML/MoonWellUI/ — код, который клиент грузит вместе со стандартным UI: окно выбора стиля и пункт меню;
    • Interface/FrameXML/MoonWellUI/Forever/ — перенесённые файлы Forever UI, в порядке ForeverUI.toc (см. Forever.xml);
    • Interface/GlueXML/MoonWellUIGlue/ — экраны входа Forever UI (выбор и создание персонажа), перенесённые из data/glue;
    • art-src/ — исходники нашего арта (PNG). Сборка кодирует их в BLP;
    • tools/build.py — сборка источника патча.

Что перенесено

Файл апстрима Как
UIAtlas*.lua, Texts.lua, Texts_enUS.lua, Texts_ruRU.lua как есть: сборка копирует их из data/ и ставит сверху проверку стиля
AtlasUtil.lua целиком: атласы, заливка, nine-slice, панели, вставки, кнопки
Layout.lua позиции и их сохранение (ForeverUIDB через RegisterForSave), /fui reset
PlayerFrame.lua целиком, без транспорта и API угрозы
PetFrame.lua рамка питомца camelot (оформление цели цели) под рамкой игрока вместо стоковой: полосы, имя, портрет, довольство питомца охотника с подсказкой, пульсация атаки; клики и меню как в стоковом PetFrame_OnClick
PartyFrame.lua рамки группы camelot вместо стоковых PartyMemberFrame1..4: полосы, имя, портрет с тоном при смерти, призраке и 20 % здоровья и пульсацией, лидер, ответственный за добычу, PvP, отключение, четыре дебаффа (рассеиваемые по опции 1.12), подсветка рассеиваемого, питомцы участников по SHOW_PARTY_PETS, скрытие в рейде по HIDE_PARTY_INTERFACE; меню и подсказка аур — стоковые. Без угрозы, ролей и проверки готовности (их нет в 1.12)
TargetFrame.lua рамка цели, цель цели, очки серии
TargetFrameAuras.lua баффы и дебаффы цели; в 1.12 у ауры цели нет заклинателя и времени, поэтому все значки одного размера и без таймера
ActionBar.lua главная панель: клиентские кнопки в новой отделке, рамка, стрелки страниц, грифоны/виверны, выезд бонусной панели
MultiBars.lua панели 2–5; левый край считается от ряда, а позиции клиента (UIParent_ManageFramePositions) перебиваются после него
StanceBar.lua, PetBar.lua панели стоек и питомца, без тотемной панели
BottomBar.lua микроменю (кнопки 1.12; «Карта» и «Помощь» убраны, как в camelot), сумки и кольцо ключей, сборка ряда, задержка в подсказке кнопки меню
StatusBars.lua полосы опыта и репутации; потолок уровня 60
CastBar.lua полоса заклинаний на событиях SPELLCAST_* из 1.12; без щита «нельзя прервать» (1.12 этого не сообщает)
Minimap.lua миникарта: кольцо, маска, полоса зоны, отслеживание (значок способности в рамке), почта, масштаб колесом, кольцо день/ночь поверх GameTimeFrame, серверное время в полосе, координаты; константы в таблице C (лимит 32 upvalue в Lua 5.0)
Buffs.lua баффы и дебаффы игрока на GetPlayerBuff/PLAYER_AURAS_CHANGED, сворачивание долгих баффов; без объединения баффов и отмены зачарований оружия (их нет в 1.12)
Tooltips.lua подсказки: nine-slice camelot вместо рамки клиента, заголовок сравнения у ShoppingTooltip1/2 при их показе
Bags.lua окна сумок: рамка, портрет, сетка, поиск, сортировка, раскладка столбцами; GetItemInfo по строке item:, общая сумка по подклассу аукциона; без валют
TabMacros.lua вкладки окон на панелях команд (как в апстриме): перетащенная вкладка становится общим макросом, который открывает её окно (создаётся один раз и находится по телу), на панели такой макрос показывает иконку вкладки; без свободного места — сообщение; макрос ячейки ищется по имени (GetActionText, GetMacroIndexByName: в 1.12 нет GetActionInfo); боковые вкладки персонажа дают /script ToggleCharacter(...)
CharacterFrame.lua лист персонажа 631×484 в вёрстке camelot: рамка, портрет, полоса уровня, модель с вращением мышью, слоты, статы 1.12 группами, сопротивления, колонка боковых вкладок; страницы регистрируются через CharacterSheet.RegisterPage; питомец пока в вёрстке клиента без старого фона
ScrollBar.lua полоса прокрутки camelot, обработчики на this
ReputationTab.lua страница репутации в панелях листа: свои строки по GetFactionInfo (без подзаголовков 1.12), подробности и флажки справа
SkillsTab.lua страница навыков в панелях листа: свои строки по GetSkillLineInfo, ранг и описание выбранного справа
PvPTab.lua страница чести: циферблат ранга camelot на нативных рангах 1.12 (UnitPVPRank, GetPVPRankProgress), статистика пяти периодов справа; без арен и списка полей боя
PetTab.lua страница питомца: строка уровня и семейства, модель питомца с поворотом мышью, значок рациона и полоса опыта слева; преданность и очки обучения в каменной плашке, характеристики, ближний бой, защита и сопротивления справа; без спутников и маунтов (их нет в 1.12)
SpellFlyoutsData.lua группы-выпадашки книги заклинаний: ключ текста, иконка, фракция и имена заклинаний группы по-английски и по-русски; генерируется tools/spell_flyouts.py из Spell.dbc 1.12 (в 1.12 нет GetSpellInfo, поэтому заклинание входит в группу по имени)
SpellBook.lua книга заклинаний camelot: разворот на две страницы или одна (кнопка в заголовке), вкладки категорий (общая с иконкой класса, ветки класса, питомец), сетка с заголовком, листание стрелками и колесом, меню «Скрыть пассивные» и «Показывать все ранги»; обычные кнопки вместо secure-контроллера 3.3.5 (в 1.12 CastSpell не защищён), клики как в стоковом SpellButton_OnClick; группы-выпадашки camelot (порталы, телепорты, духи, стойки, ауры, благословения, печати, облики, выслеживание, призыв демонов, питомец), пункт «Группировать похожие заклинания» в меню; заклинание входит в группу по имени из SpellFlyoutsData.lua
SpellSearch.lua общий виджет поиска camelot (книга и таланты): поле с рамкой, лупой, подсказкой и крестиком, превью до пяти имён (стрелки, Enter, «И ещё N»), подсказка «Нет на панели команд» до трёх букв; сравнение без регистра через Tpl.Lower (кириллица), заклинания на панелях — из скрытых подсказок действий (в 1.12 нет GetActionInfo)
SpellBookSearch.lua поиск в книге заклинаний camelot на виджете SpellSearch.lua: поле слева от настроек, полные результаты как категория без вкладки — разделы «Точные совпадения», «Связанные», «В названии», «В описании», и фильтр «Нет на панели команд»; описание — последняя строка скрытой подсказки заклинания (в 1.12 нет GetSpellInfo)
WorldMap.lua карта мира camelot в окне: левая панель на месте camelot (16, −116) вместо полноэкранной 1.12, клавиатура не захватывается (можно двигаться с открытой картой), карта уменьшена до 697 px с обрезкой тайлов, рамка с портретом, навигация «Мир › континент › зона» со списками соседей, координаты игрока и курсора, кнопка панели заданий в углу; панель справа встаёт после карты. Без развёрнутого режима, фильтров и этажей (их нет в 1.12); развёрнутый режим (красная кнопка слева от крестика, выбор запоминается): окно по формуле UpdateMaximizedSize camelot — во весь экран по высоте с отступом 30 по ширине, карта одна по центру холста, без портрета и панели заданий, заголовок «Карта мира»; в развёрнутом виде карта закрывает другие панели и закрывается ими
QuestLog.lua журнал заданий как правая панель карты: L и кнопка меню открывают карту с ним, поиск, счётчик, заголовки зон со сворачиванием и меню «Отслеживать все», задания с цветом сложности, целями и галкой отслеживания, подсказка; по клику — страница задания (цели, описание, награды на выбор и обязательные, деньги, заклинание; «Отказаться», «Поделиться», «Отслеживать»). Отслеживание как в стоковом 1.12 (AutoQuestWatch_Insert); без меток на карте, ссылок на задания и текста завершения (их нет в 1.12)
ObjectiveTracker.lua отслеживание заданий camelot вместо стоковых QuestWatchFrame и QuestTimerFrame: заголовок «Все задачи» и модуль «Задания» со сворачиванием, блок на задание (уровень, тип), цели «1/10 …» с галочками и анимацией выполнения, «Можно сдавать», полоса таймера, недостающие деньги; клик открывает страницу задания, Shift — перестать отслеживать, правый клик — меню; перемещается в режиме правки. Без достижений, предметов заданий и сортировки (их нет в 1.12)
Templates.lua общие детали окон camelot: окно с портретом (камень, полосы, металл, заголовок), красный крестик, тонкая полоса прокрутки поверх стоковой, обводка качества предмета; общая расстановка панелей: левая с отступом 20, центральная справа от левой; широкие окна (книга заклинаний, таланты) закрывают другие панели и закрываются ими; кнопка «Фильтр» camelot (ремесло, тренер); рамка и шапка диалогов DiamondMetal, красные трёхчастные кнопки
QuestPOIData.lua, QuestPOI.lua карта заданий (после MinimapQuests.lua апстрима и POI поздних клиентов): на карте мира и миникарте жёлтый ! у тех, кто даёт доступное задание, ? у принимающего готовое, голубые области с контуром и метка на каждой там, где выполняются оставшиеся цели (убийство, объект, предмет из добычи существ и сундуков, исследование); подсказка с названием и прогрессом, щелчок по метке открывает страницу задания, наведение на строку журнала, блок трекера, метку или область подсвечивает области задания; на миникарте — масштаб и движение, обрезка по кругу, стрелка на краю к ближайшей цели отслеживаемого задания (миникарта 1.12 не вращается). Данные — QuestPOIData.lua, генерируется tools/quest_poi.py из world-БД vMaNGOS; ID строки журнала и мировая позиция — от клиента MoonWell (MoonWell_GetQuestLogQuestID, MoonWell_GetPlayerPlace), без них ничего не рисуется. Доступность — как CanSeeStartQuest сервера; сданные задания клиенту 1.12 не сообщаются: задание, ушедшее из журнала готовым и без отказа, запоминается как сданное (плоские MoonWellQuestMap1..64), задание в журнале доказывает предыдущие; правый щелчок по ! скрывает задание. /questmap available|areas|minimap|trivial|unhide|forget
NpcDialog.lua окна NPC camelot 338 × 496 на пергаменте: разговор, задание (приветствие, описание, прогресс, награда), книга, хартия гильдии, регистратор; имя NPC в заголовке, портрет NPC или книга, полоса прокрутки прячется, когда текст влезает, и текст расширяется; обводка качества у наград и требуемых предметов
Loot.lua окно добычи camelot: плоская панель «Предметы» до 290 px, карточка на каждый слот (фон по качеству, метка редкости, иконка, название), появление и выезд взятого слота вправо, прокрутка с тенями; кнопки карточек — LootButton 1.12 (иначе слот не взять), клики с Ctrl и Shift и выбор для ответственного за добычу как в стоковом LootFrameItem_OnClick
Merchant.lua торговец camelot 336 × 444: вставка с мрамором, нижние вкладки «Торговец» и «Выкуп», иконки починки camelot, последний выкуп со стрелкой отмены, кошелёк в золотой рамке, название товара в цвете качества с обводкой иконки (качество из ссылки через GetItemInfo); у выкупа в 1.12 нет ссылок — без цвета
Taxi.lua карта полётов camelot: бронзовая рамка без портрета, карта во вставке, значки узлов camelot (текущий, доступный, дальний) с подсветкой, линии маршрута и прямых рейсов; карта — клиентская 1.12, увеличенная до высоты camelot 580 в своих пропорциях: TaxiNodePosition в 1.12 отдаёт доли своей карты 316 × 352, а не мировой квадрат, на котором стоят картинки camelot
Bank.lua банк camelot 480 px: банк и его сумки в одной сетке по 8, 88 ячеек на страницу со вкладками страниц справа, поиск с затемнением неподходящих, сортировка как у сумок, ячейки сумок с замком на некупленных, стоимость и покупка ячейки, кошелёк в золотой рамке; в 1.12 24 ячейки банка и 6 сумок, клики по ячейкам сумок — стоковые
Mail.lua почта camelot 338 × 424: входящие на пергаменте с рамкой качества у вложений (серой у прочитанных), «Открыть все» (деньги и предметы по одному, после ответа ящика; письма ГМ и с наложенным платежом пропускаются), отправка и просмотр письма с полосой прокрутки по надобности и бумагой, обрезанной по окну; нижние вкладки camelot; в 1.12 одно вложение на письмо, поэтому ряд вложений один, а выбора бумаги нет и в стоке
ProfessionsBook.lua книга профессий camelot 673 × 594 и её кнопка в микроменю (после портрета): карточки основных профессий с полосой навыка в цветах профессии, заклинаниями и кнопкой «Отказаться», три колонки вспомогательных (кулинария, рыбная ловля, первая помощь) с текстом-приглашением, если навыка нет; боковые вкладки: обзор и профессии с окном ремесла (вкладка применяет открывающее его заклинание). В 1.12 нет GetSpellInfo и номеров заклинаний в книге: профессия узнаётся по названию строки навыка (SkillLine.dbc, enUS и ruRU), её заклинания — по значку на вкладке «Общее» (Spell.dbc / SpellIcon.dbc); книга не двигается; вкладки стоят рядом с ней или с открытым окном ремесла
Crafting.lua окно ремесла camelot 673 × 594 для обоих окон 1.12: TradeSkillFrame (ремёсла) и CraftFrame (наложение чар и дрессировка питомца, у которой вместо полосы навыка — очки обучения): список рецептов с заголовками, значками шанса повысить навык, поиском и фильтром (повышает навык, есть материалы, ячейки), полоса навыка в цветах профессии, карточка рецепта (результат с рамкой качества, инструменты или требование к уровню питомца, восстановление или стоимость в очках, описание, реагенты), кнопки «Создать», «Создать все» и счётчик; в 1.12 нет фильтров по имени и наличию материалов, ссылок на рецепты и GetStringHeight: поиск (с кириллицей без учёта регистра) и фильтры работают здесь, высота текста считается по ширине; открытие одного окна ремесла закрывает книгу и другое окно
Chat.lua окна чата camelot: вместо стрелок — тонкая полоса прокрутки и кнопка «вниз», мигающая, пока чат не в самом низу; фон шире справа, под полосу; кнопка меню чата внизу колонки слева, кнопка друзей camelot над ней (открывает окно друзей); в покое видны только сообщения, колонка, полоса и кнопка проявляются при наведении; колесо мыши прокручивает чат (Shift — до конца, Ctrl — страница), как в camelot (в 1.12 колесо отдано камере); вкладки — клиентские, их рисунок совпадает с camelot; копирование выделением (Alt) из исходника не перенесено: ему нужны GetStringHeight и строки сообщений, которых 1.12 не даёт
Social.lua окно друзей camelot 385 × 424: металлическая рамка с портретом battle.net, нижние вкладки, страница контактов с верхними вкладками «Друзья» и «Черный список»: друзья в сети, разделитель, не в сети (уровень, класс, зона, статус), выделение строки, меню по правому клику; кнопки нажимают клиентские, так что работает стоковый FriendsFrame.lua; в 1.12 у друзей четыре кнопки (добавить, сообщение, пригласить, удалить) — два ряда, GetNumFriends отдаёт только общее число (кто в сети, считается здесь), значков статуса нет — «отсутствует» и «не беспокоить» пишутся текстом
SocialWho.lua страница «Кто»: карточки игроков camelot (имя, уровень, раса, класс цветом класса, зона, гильдия; подсказка, если текст обрезан), всего найдено, поле запроса, «Обновить», «Добавить», «Пригласить», флажок «Ищу группу» из 1.12; пока страница открыта, ответы /who идут в окно (SetWhoToUI), как у стокового WhoFrame; в 1.12 GetWhoInfo не отдаёт токен класса — цвет берётся по названию (ChrClasses.dbc)
SocialGuild.lua страница «Гильдия»: состав в духе camelot (уровень, значок класса, имя цветом класса и короной у главы, зона или время последнего входа, звание), сортировка по колонкам, всего и в игре, «Показывать отсутствующих», сообщение дня с правкой по щелчку, «Управление», «Добавить игрока», «Информация»; сведения о члене гильдии (звание с повышением и понижением, заметки, «Исключить», «Пригласить») и информация о гильдии — свои окна сбоку; стоковое окно управления гильдией ставится рядом; стоковый GuildFrame остаётся показанным за краем экрана: только тогда клиент обновляет состав по GUILD_ROSTER_UPDATE; в 1.12 нет журнала событий гильдии и значков «отсутствует»/«не беспокоить», координаты значков классов заданы здесь
SocialRaid.lua страница «Рейд»: вне рейда — описание и «Создать рейд»; в рейде — восемь групп по пять мест (имя цветом класса, красным у мёртвых, серым не в сети; уровень, класс; значки лидера и помощника), ряд классов внизу со счётчиками и подсказкой, «Готовность» и «Добавить игрока» для лидера, «Информация» о сохранённых подземельях; щелчок по месту выбирает цель (как RaidGroupButton_OnClick), правый — меню рейда, лидер перетаскивает игроков между группами; подпись группы или значок класса, вытащенные мышью, становятся стоковым выносным окном (RaidPullout_*); в 1.12 нет ролей танка и помощника, значка ответственного за добычу и состояния готовности у каждого игрока
TalentsData.lua формы узлов талантов (квадрат — активная способность, круг — пассивная) по фону ветки и «ряд:колонка»; генерируется tools/talent_shapes.py из DBC 1.12
Talents.lua окно талантов camelot внутри TalentFrame: три ветки рядом на фоне класса, узлы с рангами и цветом состояния, стрелки требований, «ворота» закрытых рядов, нераспределённые очки, иконки и очки веток; ЛКМ добавляет очко в план, ПКМ снимает его (если дерево остаётся верным), «Применить изменения» изучает план по одному очку (LearnTalent просит следующий ранг, поэтому каждое ждёт предыдущего), «Отменить» сбрасывает; закрытие с планом спрашивает подтверждение; узел изученного активного таланта перетаскивается на панель; в 1.12 семь рядов, поэтому окно ниже, а нет предпросмотра, второй специализации, символов, талантов питомца, осмотра и ссылок
TalentsSearch.lua поиск по талантам camelot: поле слева от счётчика очков, превью имён, без списка результатов — у подходящих узлов значок talents-search-* с пульсирующим свечением и подсказкой о типе совпадения (точное, в названии, в описании, связанное) или фильтр «Нет на панели команд» для изученных активных талантов; описание читается из скрытой подсказки таланта без строк уровня и требований; меню «Скрыть пассивные» / «Показать уровни» не перенесено
Trainer.lua окно тренера camelot внутри ClassTrainerFrame: крупные строки навыков (иконка, ранг, требования уровня, навыка, способностей и шага, цена красным, если не хватает денег; недоступные затемнены, изученные помечены «Уже известно») под сворачиваемыми категориями, полоса навыка у тренера профессии, кнопка «Фильтр» открывает стоковое меню, «Обучиться» и кошелёк; выбор, заголовки, фильтры и обучение идут через код клиента (его строки и панель описания скрыты), описание — в подсказке; в 1.12 нет ссылок на услуги тренера
Macros.lua окно макросов camelot (MacroFrame, 338 × 424): верхние вкладки «Общие» / персонажа, сетка 6 × 3 по центру вставки, выбранный макрос, текст с полосой прокрутки только при нужде, «Удалить» / «Создать» / «Выход»; выбор иконки (MacroPopupFrame) — окно 525 × 495 с сеткой 10 × 7 вместо стоковых 5 × 4 (кнопкам выдаются id, которые формула 1.12 переводит в показанную иконку), «Выбрано сейчас» с прокруткой к выбранной иконке по щелчку
Inspect.lua окно осмотра camelot (InspectFrame, 338 × 424): боковые вкладки «Персонаж» и «Честь» вместо нижних; страница персонажа — уровень, модель с вращением мышью, рамка Char-Paperdoll, слоты по бокам и оружие снизу, обесцвеченный фон расы; страница чести на данных 1.12 (GetInspectHonorData) — значок звания (или фракции), звание, номер и прогресс, затем пять периодов полосами, как на странице чести персонажа; в 1.12 нет осмотра талантов и команд арены
AuctionHouse.lua аукцион camelot поверх видимого прямоугольника стокового AuctionFrame (832 × 447): окно с портретом, вставки с фонами auctionhouse-* вокруг категорий, результатов, ставок, продажи и лотов, категории по уровням (класс, подкласс, тип), строки с полосами, выбором и наведением, иконки в кольце, стрелки сортировки camelot (по IsAuctionSortReversed), поля и флажки camelot, вкладка «Объявить аукцион» и рамка предмета, нижние вкладки и кошелёк; у продажи 1.12 нет размера стопки, числа стопок и меню цены/длительности — её поля остаются на местах; выпадающее меню качества пока стоковое
DressUp.lua примерочная camelot (DressUpFrame, 450 × 545): окно с портретом игрока, вставка, сцена — модель поверх фона расы (нижние части обрезаны по сцене), стрелки вращения сверху, вращение мышью, «Отмена» и «Сброс» внизу справа
TabardFrame.lua окно гербовой накидки camelot (TabardFrame, 338 × 424): окно с портретом торговца и его именем в заголовке, вставка и кошелёк с золотой каймой, модель в левой половине (с вращением мышью), панель настройки справа, «Принять» и «Отмена» на местах camelot
Stable.lua стойла camelot (PetStableFrame): окно с портретом смотрителя, имя и уровень питомца с преданностью под ним, сцена — модель поверх мрамора с тенью питомца, рамкой вставки и тенью краёв, рацион слева сверху, кнопки вращения и сброса при наведении, полоса опыта призванного питомца; ряд «текущий + 2 стойла» по центру под сценой, стоимость, «Приобрести» и кошелёк; в 1.12 нет специализаций питомцев, сцена остаётся на мраморе
Dialogs.lua окна подтверждения (StaticPopup1–4): рамка UI-DiamondDialogBox-Border нарезкой на девять частей, тёмный фон, красный крестик camelot; размеры, тексты и кнопки остаются клиентскими
ColorPicker.lua выбор цвета camelot (ColorPickerFrame, 388 × 210, без прозрачности 331): рамка и шапка DiamondMetal, круг цвета, образец, столбец прозрачности на стоковом ползунке (шахматка, градиент выбранного цвета, стрелка-ползунок), пара кнопок по центру; OpacityFrame — только рамка
GameMenu.lua меню по Esc camelot (GameMenuFrame): рамка и шапка DiamondMetal, кнопки — красные трёхчастные 200 × 36 в столбик с отступами camelot и разрывами перед «Выходом из мира» и «Назад»; кнопки клиента, benilla и «Стиль интерфейса» остаются на своих местах в порядке, раскладка повторяется при каждом показе
DropDown.lua все выпадающие и контекстные меню (DropDownList1–3) в стиле 1 camelot: фон common-dropdown-bg нарезкой с тенью, строки по 20, квадратик common-dropdown-ticksquare под жёлтой галочкой у строк с флажком (у заголовков и notCheckable — без), стрелка подменю клиента; высоты строк клиента не трогаются, строки сдвигаются сразу после него
Battlefield.lua окно военачальника (BattlefieldFrame, 338 × 424) в стиле окон camelot: портрет NPC, название поля боя в заголовке, список экземпляров во вставке со строками наведения и выбора camelot и тонкой полосой прокрутки, описание белым во второй вставке, «Вступить группой», «Вступить в бой», «Отмена» справа внизу; списка всех полей боя, как в PvP-вкладке 3.3.5, в 1.12 нет
Settings.lua окно настроек этого клиента (BenillaOptionsFrame benilla — оно же назначение клавиш) в стиле SettingsPanel camelot: металлическая рамка без портрета поверх чёрного 0,8 с полосами сверху, заголовок над металлом, рамки вставок вокруг списка категорий и страницы, строки категорий options_list (выбранная и наведение), минималистичные флажки, ползунки minimal_sliderbar, рамка поиска; страницы, логика и CVar остаются benilla; кнопки клавиш остаются панельными — серебряных кнопок 3.3.5 в 1.12 нет; скин накладывается на VARIABLES_LOADED, когда слой benilla уже загружен

Compat.lua — наши помощники: HookScript, HookGlobal/HookMethod вместо hooksecurefunc, сила через UnitMana, тексты полос по statusBarText.

Арт. Сборка кладёт в архив только листы, которые нужны перенесённым файлам: она ищет в них имена атласов и пути Interface\ForeverUI\.... Сейчас это 6 листов, около 12 МБ.

Экраны входа

Выбор и создание персонажа camelot из data/glue на GlueXML 1.12. Стиля у них нет: в 1.12 на экранах входа нет GetCVar, поэтому эти два экрана всегда современные, у обоих стилей. Остальные экраны (вход, список миров, модификации) остаются стоковыми, со стоковым масштабом.

Файл апстрима Как
ForeverUIGlueFonts.xml, ForeverUIGlueTexts*.lua (en, ru), ForeverUIGlueAtlas.lua, ForeverUIGlueData.lua как есть: сборка копирует их из data/glue
ForeverUIGlue.lua база: масштаб camelot (высота 1080 — запасное значение апстрима, gxResolution в 1.12 на экранах входа не прочитать) только пока открыт экран camelot, подгонка под короткий экран, шрифты, атлас, nine-slice, красные кнопки, рамка диалога; подсказка ставится своими якорями — GlueTooltip_SetOwner 1.12 знает только BOTTOMLEFT к TOPRIGHT
ForeverUIGlueTemplates.lua растянутый и плиточный атлас, кнопки с артом, квадратные кнопки с иконкой, тонкая полоса прокрутки; панельной кнопки нет — её не использует ни один перенесённый экран
ForeverUIGlueCharacterSelect.lua выбор персонажа: верхняя панель «Миры», «Меню», «Модификации», карточки из GetCharacterInfo (раса по файлу расы, цвет класса по имени класса на языке клиента — ForeverUIGlueClassNames.lua), гербы фракций, прокрутка, «Новый персонаж», удаление, свернуть список, глаз, вход в мир, поворот; платных услуг в 1.12 нет
ForeverUIGlueCharacterCreate.lua создание в два шага: расы по фракциям, тело, классы, панели фракции, расы и класса с текстами клиента (FACTION_INFO_*, RACE_INFO_*, ABILITY_INFO_*, CLASS_*); затем пять настроек внешности со стрелками и колесом, случайная внешность, имя, поворот; режим 1 апстрима — номера, образцы цветов и списки (режим 2) требуют пропатченного клиента 3.3.5; кнопка случайного имени скрыта, как в стоке
ForeverUIGlueDialogs.lua диалоги экранов входа (две кнопки, без HTML), удаление и переименование персонажа, подсказка
ForeverUIGlueMenu.lua меню выбора персонажа: модификации (если есть), выход, закрыть; настроек, видео и титров на экране выбора 1.12 нет

Не перенесены (в 1.12 остаются стоковыми): вход (ForeverUIAccountLogin.lua), список миров, список модификаций, настройки, видеоролики, титры, выпадающие меню экранов входа.

Что не перенесено

Окна апстрима, которых в 1.12 нет: достижения и статистика, руны рыцаря смерти, транспорт и спутники, арена, поиск группы, инкрустация, парикмахерская, менеджер экипировки, гильдейский банк, символы, вторая специализация, таланты питомца, осмотр талантов, валюта. Масштабирование карты колесом (WorldMapZoom.lua) опирается на слои карты 3.3.5, которых в 1.12 нет; задания на карте и миникарте — своя реализация (QuestPOI.lua), а не перенос MinimapQuests.lua.

Как это работает

Модуль — это один архив, Data/patch-F.MPQ:

  • Interface\FrameXML\FrameXML.toc — стандартный toc игрока плюс строка MoonWellUI\MoonWellUI.xml. Сборка берёт toc из установки, файлов Blizzard в репозитории нет. benilla грузит этот toc из цепочки патчей так же, как 1.12 грузит пропатченный.
  • Interface\FrameXML\MoonWellUI\ — наш код. Он грузится после стандартных файлов и до слоя benilla.
  • Interface\MoonWellUI\ — наш арт (сейчас превью для окна выбора).
  • Interface\GlueXML\GlueXML.toc — стандартный glue-toc игрока плюс строка MoonWellUIGlue\MoonWellUIGlue.xml; Interface\GlueXML\MoonWellUIGlue\ — экраны входа. Русский пакет Data/ruRU своего GlueXML.toc не несёт (только AccountLogin.xml, GlueStrings.lua, GlueLocalization.lua), поэтому наш не перекрывается. Арт экранов входа — листы атласа ForeverUIGlueAtlas.lua, чьи имена встречаются в перенесённых файлах, и иконки рас и классов Interface\ForeverUI\charactercreate\.

Стиль интерфейса хранится в CVar moonwellUIStyle (classic или forever; пусто, пока игрок не выбрал). CVar общий для всего клиента и сохраняется в benilla-config/config.toml.

  • Первый вход в мир. Пока стиль не выбран, после входа в мир открывается окно «Выберите интерфейс»: два превью, радиокнопки, «Готово». Escape его не закрывает, Enter подтверждает.
  • Смена стиля. В меню игры (Esc) под «Макросами» есть пункт «Стиль интерфейса». Он открывает то же окно, уже с «Отменой». Если стиль изменился, UI перезагружается (ReloadUI).
  • Почему не на экране выбора персонажа. В 1.12 у экранов входа (GlueXML) нет GetCVar/SetCVar. Общий для аккаунта выбор там не сохранить без правок клиента.

Сборка

Данные карты заданий (QuestPOIData.lua) пересобираются из world-БД локального сервера (контейнер vmangos-local-db-1 в WSL, папка данных сервера с maps/ и dbc/); правки руками — vanilla/tools/quest_poi_overrides.json, арт — vanilla/tools/questpoi_art.py:

python vanilla\tools\quest_poi.py --data //wsl.localhost/Ubuntu/home/sindo/core/deploy/local/data

Нужны Python 3.9+, Pillow и mpqx из benilla (cargo build -p benilla-formats --bin mpqx).

python vanilla\tools\build.py --data D:\WoW-1.12.1\Data `
  --mpqx C:\Users\sindo\benilla\target\debug\mpqx.exe

Скрипт пишет build/patch-source/Data/patch-F/. Дальше — обычный деплой MoonWell:

# в C:\Users\sindo\benilla
.\scripts\deploy-moonwell.ps1 -DataPath D:\WoW-1.12.1\Data -IconPath ... -AuthHost ... `
  -PatchSource C:\Users\sindo\moonwell-forever-ui\build\patch-source

-PatchSource принимает один каталог. Если у тебя есть другие свои патчи, положи build/patch-source/Data/patch-F рядом с ними в их Data/.

Порядок патчей. Архивы patch-?.MPQ монтируются по имени, и побеждает последний. Если архив с более поздней буквой (patch-G … patch-Z) тоже содержит Interface\FrameXML\FrameXML.toc, он перекроет наш. Тогда либо дай нашему патчу более позднюю букву (--patch patch-Z), либо добавь нашу строку в тот toc. Русский пакет Data/ruRU монтируется после всех patch-?.MPQ, но FrameXML.toc в нём нет, поэтому наш он не перекрывает.

Проверка без сервера

Харнес benilla грузит стандартный UI с нашим патчем без окна и логина:

# Data с patch-F.MPQ; в харнесе только англ. локаль
WOW_DATA=<Data> target/debug/examples/addon_harness --probe-ui \
  --eval 'return MoonWellUIChoiceFrame:IsVisible()'

Харнес сам шлёт VARIABLES_LOADED, PLAYER_LOGIN и PLAYER_ENTERING_WORLD, поэтому окно выбора уже открыто.

Харнес и capture-режим ничего не сохраняют, и CVar в них всегда пустой. Чтобы проверить стиль Forever, собери тестовый патч с --test-style forever: в нём невыбранный клиент сразу стартует на Forever. Игрокам такой патч не отдаём.

Правила порта

  • API — только 1.12. В обработчиках this, event, arg1…, а не self и .... Lua 5.0: table.getn вместо #, string.find вместо string.match, arg в функциях с ..., math.mod вместо %; не больше 32 upvalue на функцию. Нет hooksecurefunc, secure-шаблонов, SetAtlas из 3.x (у ForeverUI свой AtlasUtil на SetTexCoord).
  • Каждый файл Forever UI начинается с if not MoonWellUI_IsForever() then return end и подключается в Forever/Forever.xml перед Forever.lua. На классическом стиле он ничего не меняет.
  • Файл апстрима, который уже работает на 1.12 (только данные, синтаксис Lua 5.0), не копируем руками, а добавляем в UPSTREAM_AS_IS в build.py: тогда он обновляется вместе с апстримом.
  • Перенесённый файл называется как в апстриме и в первой строке говорит, откуда он и чем отличается.
  • Не переносим то, чего нет в 1.12: транспорт, руны рыцаря смерти, символы, достижения и статистику, LFG, арены, гильдбанк, парикмахерскую, менеджер экипировки, валюты, тотемную панель.
  • Арт берём из data/art/interface/foreverui. Имя атласа или путь к текстуре пишем в перенесённом файле строкой целиком, или хотя бы его начало ("ui-hud-micromenu-" .. набор .. состояние): по этим строкам сборка находит листы. Имя, склеенное из одних переменных, она не увидит.

Синхронизация с апстримом

git fetch upstream
git merge upstream/main   # меняется только data/ и файлы апстрима в корне

Новые правки апстрима в data/addon и data/glue смотрим через git diff и переносим в vanilla/ руками.

Лицензия и арт

Код апстрима — GPL-2 (LICENSE), наш код в vanilla/ — тоже. Арт в data/art взят из современного клиента. Ни код, ни арт не кладём в репозиторий клиента (moonwell-client-core, MIT/Apache, без ассетов): модуль живёт здесь и доезжает до игроков только архивом.