KP_ApiDumper — ваш личный браузер API для World of Warcraft
Если вы когда-нибудь писали аддоны для World of Warcraft, то наверняка сталкивались с вечной проблемой: нужная функция есть в памяти, но где её искать — непонятно. Открываешь сайты, переключаешься между окнами, мучительно вспоминаешь сигнатуру UnitHealth или параметры С_Timer. Знакомо? Аддон KP_ApiDumper решает эту боль раз и навсегда — он превращает сам игровой клиент в справочник по его собственным интерфейсам.
KP_ApiDumper для World of Warcraft сканирует все нативные интерфейсы, которые реально использует ваш клиент, и выводит их в удобное окно прямо внутри игры. Автор аддона — KuaiPaoNO1. Интересно, что аддон совместим с любыми версиями клиента: Retail, Classic, TBC, WotLK, Cataclysm и даже MoP (Пандарен). Более того, он корректно работает на приватных и «специальных» серверах, где часть API отличается от официальной документации. Результаты сканирования всегда соответствуют конкретно вашей сборке.
Что умеет KP_ApiDumper
При первом входе в игру аддон автоматически сканирует все доступные интерфейсы и сохраняет результаты в файл настроек. Поиск и копирование происходят мгновенно, без выхода из игры. Весь функционал разбит на три ключевые категории.
- Глобальные функции — UnitHealth, GetSpellInfo, SendChatMessage и другие. Аддон фильтрует результаты так, что в списке остаются только оригинальные функции движка, а не методы сторонних аддонов.
- Пространства имён C_ — современные таблицы интерфейсов C_Timer, C_Map, C_CVar и им подобные.
- Методы контролов — все доступные методы более чем для двадцати типов UI-элементов, от Frame и Button до EditBox, Texture и FontString.
Отдельная гордость аддона — функция наведения курсора. Включите её в настройках, наведите мышь на любой фрейм — и получите полную информацию: имя (анонимные фреймы помечаются отдельно), тип контрола, видимость, размер и масштаб, уровень слоя, число дочерних фреймов, прикреплённые скрипты, путь к текстуре, содержимое и размер шрифта, а также список доступных методов. Даже аурки WeakAuras подсвечиваются с указанием имени. Клик по тултипу открывает полный список методов прямо в браузере.
Интерфейс и управление
Основное окно открывается слэш-командой /KPAPI. В нём есть категории (глобальные функции, пространства имён C_ и методы контролов), источники для выбора конкретного пространства или типа контрола, мгновенный поиск без учёта регистра и виртуальная прокрутка — список остаётся плавным даже при огромном количестве интерфейсов. Клик по имени любой функции открывает окно копирования.
Внизу окна располагается информационная панель: версия клиента и номер билда (определяются автоматически при смене клиента), общее число интерфейсов и количество текущих результатов фильтра.
- /KPAPI — открыть окно браузера API.
- /apidump — пересканировать все интерфейсы немедленно.
- /kphover — включить или отключить подсказки при наведении.
Все слэш-команды нечувствительны к регистру. Управлять аддоном можно и через стандартную панель: нажмите ESC, найдите пункт KР_API Browser в списке дополнений и откройте окно, пересканируйте интерфейсы или переключите подсказки при наведении. Состояние галочек всегда точно соответствует реальной работе функции.
Автообновление версий и простота запуска
Аддон включает несколько дескрипторных файлов, которые автоматически адаптируются к разным клиентам: Live, Пандарен (MoP), Cataclysm, WotLK, Classic, Burning Crusade и даже Timeless Isle (обрабатывается как часть версии WotLK). Код интерфейса учитывает различия между старыми и новыми системами конфигурации и шаблонами тултипов, поэтому переключение между версиями не доставляет хлопот. Если говорить о том, как установить KP_ApiDumper, всё сводится к стандартной процедуре: распаковка папки аддона в каталог Interface\AddOns и перезагрузка игры. Для комфортной установки удобно пользоваться лаунчером foxygame.net — в его каталоге дополнений легко найти KP_ApiDumper, установить его в один клик и не переживать о несовместимости с вашей версией World of Warcraft.
Использование аддона для разработки
Сканирование выполняется непосредственно на работающем клиенте, поэтому результаты идеально совпадают с вашим окружением — включая приватные интерфейсы кастомных серверов. Вы больше не столкнётесь с ситуацией, когда функция есть в онлайн-справке, но отсутствует в вашем клиенте.
Особенно интересен сценарий использования сканированных данных для разработки. Аддон сохраняет полный список интерфейсов в файл KP_ApiDumperDB.lua в папке WTF\Account\Ваш_Аккаунт\SavedVariables\. Этот файл вместе с данными о версии и билде клиента можно отправить ИИ-ассистенту по кодингу — и модель сгенерирует код строго на основе реальных API вашего клиента, без выдуманных функций и неправильных параметров. Это настоящая находка для работы с сильно модифицированными клиентами и серверами Timeless Isle, где официальная документация расходится с реальностью.
Советы к использованию
- При первой установке полностью выйдите из игры и войдите заново, чтобы аддон загрузился корректно.
- После входа подождите несколько секунд, пока завершится сканирование.
- Для быстрой проверки любой функции наберите /KPAPI и ищите по ключевым словам.
- После крупного обновления клиента просто нажмите «Пересканировать интерфейсы» в панели настроек.
Все данные сканирования и настройки функций хранятся в файлах KP_ApiDumperDB и KP_ApiDumperCfg. Когда функция подсказок при наведении отключена, аддон не ведёт постоянного мониторинга и не создаёт дополнительной нагрузки на игру. Результаты записываются в файл при выходе на экран выбора персонажа или при закрытии игры.
KP_ApiDumper — это тот инструмент, о существовании которого мечтает каждый разработчик аддонов. Скачать KP_ApiDumper сейчас — значит навсегда забыть о мучительном переключении между игрой и справочниками. Изучение интерфейсов, написание скриптов и отладка становятся быстрыми и приятными, а полное соответствие данных вашему клиенту гарантирует точность в любой рабочей ситуации.