Шаблоны аддонов WoW Forever: Forever — третий клиент

Три клиента, одна ошибка

Чаще всего модели и разработчики ошибочно считают Forever либо Classic Era с новыми зонами, либо Midnight со старым миром. Это не так.

Номера интерфейса взяты из таблицы TOC Warcraft Wiki, а изменение журнала боя в Midnight — из заметок к API патча 12.0.0 в вики. Строки беты в колонке Forever основаны на тестах сообщества.

Определяйте Forever, не полагаясь только на Project ID

Прежнее сообщение о сборке 69913 указывало возврат WOW_PROJECT_ID = 1, значения Mainline. Сохраненная проверка от 12 октября на сборке 70338, напротив, записала 18, а константы клиента Blizzard называют его WOW_PROJECT_CAMELOT. Сравните эту именованную константу, если она существует, затем проверьте API нужной функции. Blizzard сообщила, что переименует внутреннее название Camelot до запуска, поэтому повторите проверку на своей сборке.Источник: константы проекта Camelot от Blizzard, сохраненное извлечение 70338 изучено 13 окт. 2026; проверка WFG записана 12 окт.. Зеркало может показывать более позднюю сборку.

local function IsForever()
    return WOW_PROJECT_CAMELOT ~= nil
        and WOW_PROJECT_ID == WOW_PROJECT_CAMELOT
end

-- Example capability: check the API your feature actually uses.
local canReadPreset = C_GameRules
    and type(C_GameRules.GetForeverExperiencePreset) == "function"

local function HasSecrets()
    return type(issecretvalue) == "function"
end

-- For logs only: 16001 on the beta. Do not hardcode it as the test.
local iface = select(4, GetBuildInfo())

Сверьте этот тест с таблицами API и ловушками из двенадцати ошибок, которых следует избегать, а затем запустите его в своей сборке, прежде чем полагаться на результат.

Сохраненный пример Warcraft Wiki сочетает WOW_PROJECT_MAINLINE с LE_EXPANSION_LEVEL_CURRENT == LE_EXPANSION_CLASSIC или читает переменную типа игры из TOC. Его условие ID проекта Mainline ложно в записанном клиенте 70338. Архитектура интерфейса Mainline не подразумевает ID проекта Mainline. Переработанный пример сверен с источниками, но не проверен в игре.

Обработка секретных значений

В Midnight появились секретные значения, ограничивающие боевую автоматизацию, и Blizzard сказала, что они есть и в Forever.

1. Вызовите API.
   type() все еще сообщает тип: number, string или boolean.
2. Ask issecretvalue
   прежде чем сравнивать, проверять или выводить его.
3. Если значение секретное, используйте виджет.
   В противном случае показывайте фиксированную метку.
4. Не полагайтесь на pcall при выполнении защищенных действий.

Вызов по-прежнему возвращает значение настоящего типа. StatusBar:SetValue — пример виджета из вики, который принимает секретные значения. Не оборачивайте защищенное действие в pcall, считая проблему решенной: тестировщики сообщают, что сбой может быть незаметным и сохраняться.

Under the Warcraft Wiki's Midnight rules, addon code can store secrets, pass them to functions, and concatenate or string.format them. It cannot do math on them, compare them, test them as booleans, index them or use them as table keys. The rules block those operations; an attempt throws a Lua error right away. Warcraft Forever reports that printing a secret throws on Forever, so guard before you print.

Поделиться изображением: заметки к релизу Questie v12.0.1+v1.0.3 на GitHub: первым пунктом в разделе New Features стоит Added Forever client support, ниже идут исправления Forever

Тест, который можно вставить в игру

/run local h = UnitHealth("player"); print(type(h), pcall(function() return h + 1 end))

В сборке 69913 эта команда вывела number false. false от pcall означает, что движок отклонил сложение. Примеры полосы состояния смотрите в шаблонах кода и скачиваемом образце Beacon, а затем проверьте их в своей сборке.

Ауры — это контейнеры, а не таблицы, принадлежащие вам

Blizzard сообщила, что изменения AuraContainer и AuraButton из версии 12.1.0 доступны в Forever, а последующие изменения интерфейса должны появляться и в Standard, и в Forever. В заметках вики о Midnight сказано, что данные аур становятся секретными при действующих боевых ограничениях. Надежнее позволить рамкам аур Blizzard решать, что показывать, оформлять созданные ими элементы и никогда не читать содержимое ауры, чтобы принимать игровые решения.

Что стоит создавать сейчас

Прежде чем просить модель написать код или переносить старый код, выясните, что разрешает клиент:

Порядок переноса

С Midnight

Добавьте 16001 в строку интерфейса или поставляйте _Camelot.toc. Удалите все ветки, которые считают, что ID проекта 1 означает «это Midnight», и включают функции только для Midnight. Перед выпуском повторно проверьте все пути работы с секретными значениями в клиенте Forever.

С Classic Era

Treat it as a new addon that may keep your SavedVariables schema. Replace global item and spell calls with C_Item and C_Spell and their load events. The retained community notes report combat-log access unavailable. Test listener registration and reader results on your target build before you rely on the feature or delete it. Replace PlaySoundFile on interface .ogg paths with PlaySound and a SOUNDKIT ID. Replace faction checks that use UnitIsEnemy. Then read the file again for any math on health. For starter code, see the copy-paste code templates.

Ошибки беты и особенности дизайна

Отметьте это в заметках к патчу, чтобы игроки не винили ваш аддон:

• Ошибка компиляции защищенных фрагментов: WoW Forever Builds подозревает ошибку.
• SavedVariables не загружаются: сообщалось после перезапуска в середине сентября
• WOW_PROJECT_ID со значением 1: прежнее сообщение о сборке 69913.

Повторно проверьте фрагменты кода, прежде чем навсегда заменить работающий каст по клику менее функциональным. Игроки сообщали об исчезновении сохраненных данных, а ответ на форуме от 25 сентября говорит, что сборка 70009 снова их загружает; проверьте это перед добавлением обходных решений. WoW Forever Builds оставил ID проекта неясным на сборке 69913. Сохраненная проверка 70338 записала 18, именуемое WOW_PROJECT_CAMELOT, хотя Forever остается в семействе Mainline. Проверяйте каждую сборку заново; сравнивайте именованную константу и проверяйте API нужных функций.

Меню аддонов заменяет кнопку у мини-карты

Попросите модель добавить кнопку переключения, и она возьмет библиотеку значков мини-карты из руководства по Classic Era. В Mainline есть более простой вариант: меню аддонов — раскрывающийся список у мини-карты с одной записью для каждого зарегистрированного аддона.Источник: Addon compartment, проверено 28 сент. 2026.

В бета-клиенте это есть. В сборке 1.60.1.70009 TOC файла Blizzard_Minimap загружает AddonCompartment.lua для типа игры mainline, а соседняя строка, исключающая camelot, показывает, что camelot считается mainline.Сообщается, чтение файла клиента Запись в меню на действующем экране Forever пока не подтверждена, как отмечают заметки Beacon о меню аддонов.

Регистрация через TOC или Lua

Три поля TOC регистрируют запись без вызова Lua: AddonCompartmentFunc для щелчка и необязательные AddonCompartmentFuncOnEnter и AddonCompartmentFuncOnLeave для подсказки. Клиент вызывает указанные вами глобальные функции и сначала загружает аддон с загрузкой по требованию, если это необходимо.

Аддон, который меняет метку или значок во время работы, использует вместо этого AddonCompartmentFrame:RegisterAddon, передавая таблицу с text, icon и func. Вики говорит, что эта таблица похожа на старую настройку кнопки UIDropDownMenu, поэтому примеры для Retail подойдут.

Когда кнопка у мини-карты все же нужна

Для собственной кнопки у мини-карты нужны сохранение позиции и код перетаскивания, обычно через библиотеку. Запись в меню этого не требует, потому что меню контролирует клиент. Начните с меню аддонов. Тот же TOC загружает MinimapButtonTemplate для camelot, поэтому настоящая кнопка со значком на мини-карте все еще возможна, если игроки попросят.

Панели настроек меняются по тому же принципу

Для настроек действует то же правило: пишите код Mainline, а не шаблон Classic. Вики сообщает, что Settings API был переработан в патче 10.0.0, а дополнительные изменения, нарушающие совместимость, появились в 11.0.2.Источник: Settings API, проверено 28 сент. 2026. В бете в Blizzard_Settings.lua определены Settings.RegisterAddOnCategory, Settings.RegisterAddOnSetting и Settings.OpenToCategory.Сообщается, чтение файла клиента

RegisterAddOnCategory добавляет вашу категорию в окно настроек игры. RegisterAddOnSetting привязывает флажок или ползунок к ключу в таблице сохраненных переменных, поэтому при нажатии значение записывается без отдельного обработчика для синхронизации. В шаблоне панели настроек есть рабочий флажок с функцией обратного вызова.

Поделиться изображением: окно Options в WoW Forever на вкладке Languages and Social: выпадающий список Preferred Online Language с вариантами English, LatAm Spanish и Brazilian Portuguese

Открытие настроек из меню аддонов

При щелчке по записи в меню можно вызвать Settings.OpenToCategory, а не показывать созданное вами окно. В файле беты это передает управление клиентской функции C_SettingsUtil.OpenSettingsPanel. Ни вики, ни файл не уточняют, работает ли вызов в бою: проверьте это или поставьте вызов в очередь до PLAYER_REGEN_ENABLED, как делает Beacon.

Аддоны маршрутов работают в том же клиенте

Аддоны заданий и маршрутов — самая крупная категория с рекомендацией «Создавать» в таблице выше, и два создателя гайдов уже продают их для Forever. RestedXP открыла прием заказов для Forever 14 сентября 2026. Zygor Guides сообщает, что подписчики Elite получат гайды для Forever на старте. Оба аддона работают в этом клиенте, поэтому к ним применимы те же правила меню аддонов и настроек.

Шаблоны промптов для аддонов Forever включают оба этих шаблона в системный промпт, поэтому модель сначала обращается к меню аддонов и Settings API, а не к библиотеке.