Продолжается обсуждение вышедшего на днях трейлера нового дополнения — Mists of Pandaria. Не забудьте принять участие в голосовании за ваши любимые трейлеры.

А Mahotsukai сделал любопытную подборку скриншотов из трейлера и игры: По следам вступительного ролика Mists of Pandaria

Продолжается работа над классовыми гайдами Mist of Pandaria. На сайте уже опубликованы следующие из них:

• Гайд по Воину Оружия 5.x
• Гайд по Друиду-танку 5.0
• Гайд по Друидам Кошкам 5.0
• Гайд по Жрецу Света 5.0
• Гайд по Паладину Воздаяния 5.4
• Гайд по Холи Паладину 5.4

Данная статья является продолжением цикла статей об аддонах. Предыдущая часть: Как написать аддон для ВоВ. Сохранение настроек. Значения по умолчанию. Слэш команды.

В университете меня очень напрягало отсутствие прикладной состовляющей некоторых наук. Т.е. идёт очень большое количество теории и абсолютно не ясно, как и где это можно применить на практике. Много позже я сталкивался в работе или в жизни с реальными примерами и брал в руки учебник. Надо заметить — учёба шла значительно быстрее.

Посему, я решил отойти от примера «Hello World» и сразу сделать что–то полезное в реальной жизни.

Готовый автоинвайтер можно скачать тут:

• Страница аддона на Curse.com: http://www.curse.com/addons/wow/autoinviterwr

Данная статья является продолжением цикла статей об аддонах. Предыдущая часть: Как написать аддон для ВоВ. API. XML. События.

Сохранение настроек

Многие аддоны должны уметь сохранять свои настройки между вашими входами в игровой мир. Реализовать эту возможность в вашем аддоне крайне легко. Это делается с помощью специальной директивы из файла toc.

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

Данная статья является продолжением цикла статей об аддонах. Предыдущая часть: Как написать аддон для ВоВ. Введение.

Элементы XML

Для проектирования интерфейса вашего аддона, вам понадобятся стандартные элементы — окна, кнопки и т.п. Они могут быть определены в XML файле с помощью стандартных элементов. Список элементов можно найти здесь: XML

По мере написания статей, буду переводить описание различных элементов на русский язык.

Так же XML файлы могут содержать код на языке LUA, описывающий реакцию элементов интерфейса на те или иные события. См. ниже.

Обстоятельства сложились так, что мне нужно написать аддон для нашей базы данных. Аддоны я никогда не писал, но хотел. И идеи были. Но не было времени. А теперь — нужно. Под это дело я начинаю цикл статей, который познакомит желающих с тем, как пишутся аддоны для World of Warcraft. Очень надеюсь на помощь и советы тех, кто аддоны уже писал или правил, вобщем — разбирается.

Скажу сразу, что данный цикл статей будет ориентирован на людей знакомых с программированием, или способных разобраться в программировании самостоятельно. Т.е. основ тут не будет. В идеале вам нужно иметь опыт работы с парой различных языков, JavaScript и представление о формате XML.

Общее

Lua — это скриптовый язык программирования, используемый для расширения интрефейса ВоВ. Название языка происходит от португальского слова Луна. В настоящее время реализована официальная спецификация языка 5.1., которой хватает для реализации аддонов. Дополнительная информация может быть найдена в ЧаВо по языку Lua.

Справочники по программированию

Существует не так много руководств, но по существующим у нас можно разобраться в том, как писать аддоны или использовать язык Lua в макросах. Для освоения Lua вам понадобятся базовые знания по программированию.

Как написать аддон для ВоВ. Введение. — цикл статей на нашем сайте, посвященный написанию аддонов.

Официальное руководство — содержит базовое описание синтаксиса и команд. Это руководство трудно использовать тем, кто не имеет опыта программирования вообще.

Программирование на Lua — Руководство по языку Lua от Роберто Иерусалимичи (Roberto Ierusalimschy). Онлайн версия.

LUA-Users — группа новостей, включающая wiki, которая содержит ЧаВо, руководства и расширенную помощь по многим темам. Группа так же имеет лист рассылки (включая архив) и канал IRC (#lua на irc.freenode.net).

Редакторы Lua

Файлы на языке Lua можно писать в любом текстовом редакторе. Но специализированные редакторы могут иметь дополнительные возможности. См. редакторы Lua.

Использование Lua в ВоВ

Посмотрите следующие темы:

• WoWBench — практически полный эмулятор интерфейса ВоВ.
• Lua 5.1.1 WoW — дистрибутив, созданный cogwheel–ом, включающий всё необходимое для разработки аддонов.

Ссылки

• Области видимости переменных Lua
• Функции Lua — список стандартных функций Lua доступных в ВоВ
• Функции пользователя — функции написаные пользователями WowWiki
• Память занимаемая объектами Lua
• API World of Warcraft — интерфейс LUA World of Warcraft

OnClick

 —

это событие виджета, генерируемое при клике мышкой по фрейму.

Параметры обработчика:

• self — ссылка на фрейм, получивший событие
• button (string) — идентификатор кнопки мыши. Может принимать любое значение, но для стандартных мышей значения следующие:

• LeftButton
• RightButton
• MiddleButton
• Button4
• Button5

• down (boolean) — истина, если кнопка мыши все ещё нажата, ложь в противном случае.

См. также:

• OnClick

OnEvent

 —

это событие виджета, генерируемое при срабатывании любого события игрового мира, зарегистрированного с помощью функции RegisterEvent.

Параметры обработчика:

• self — ссылка на фрейм, получивший событие
• event — название события
• … — аргументы события, различные для разных событий.

См. также:

• OnEvent

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

Функция SetScript позволяет установить конкретный обработчик на хендлер для фрейма:

Аргументы:

• handler (string) — хендлер события, к которому привязывается функция (OnShow, OnEvent и т.п.)
• func (функция) — функция, которая должна быть вызвана для обработки хендлера. Для снятия обработчика, этот параметр должен быть равен nil. Функция будет вызвана со следующими аргументами: (frame, arg1, arg2,…). Для хендлера OnEvent arg1 будет равен event).

Пример:

Результат:

Все фреймы группы будут скрыты при появлении.

Функция UnregisterEvent снимает отслеживания определенного события с объекта.

Аргументы:

• event — имя события, которое больше не должно обрабатываться объектом. См. События API

Возвращает:

• nil

Пример:

Результат:

Код в разделе <OnEvent> больше не будет выполнятся, когда вы получаете сообщение в чат.

См. также:

• RegisterEvent

Функция RegisterEvent позволяет задать, какое событие ваш объект хочет отслеживать. Это позволяет сделать так, что код в разделе <onEvent> не вызывается без дела, а только тогда, когда нужно. События получают только те фреймы, которые запросили этого.

Аргументы:

• event — имя события, которое хочет отслеживать объект. См. События API

Возвращает:

• nil

Пример:

Результат:

Теперь вы можете добавить код в раздел <OnEvent> в вашем аддоне, и каждый раз, когда вы будете получать сообщение в чат, будет выполняться ваш код.

См. также:

• UnregisterEvent

Вы можете зарегистрировать событие, которое должен получать ваш фрейм с помощью функции frame:RegisterEvent(«eventName»). Когда это событие произойдёт, их получит ваш обработчик OnEvent, который можно установить с помощью функции frame:SetScript(«onEvent», handlerFunction). Чтобы отключить обработку события, вы можете воспользоваться функцией frame:UnregisterEvent(«eventName»).

Список игровых событий можно найти здесь: Список событий игрового клиента

Список хендлеров событий для различных объектов можно найти здесь: http://www.wowwiki.com/Widget_handlers

API

 —

англ. абб. application programming interface — совокупность функций, предоставляемых клиентом World of Warcraft для разработчиков аддонов.

Клиент предоставляет 3 различных API, помимо стандартных функций LUA: WOW API, Widget API, Macro API.

Функции WOW API:

• message
• RegisterEvent
• UnregisterEvent
• SetScript

См. также:

• используемые функции LUA: http://www.wowwiki.com/Lua_functions
• функции WOW API на английском языке: http://www.wowwiki.com/World_of_Warcraft_API
• функции для работы с виджетами на английском языке: http://www.wowwiki.com/Widget_API
• функции для использования в макросах на английском языке: http://www.wowwiki.com/Macro_API

Атрибуты XML при описании интерфейса могут быть следущими:

• string — простая строка
• boolean — true или false, соответственно правда и ложь
• int — целое знаковое число
• float — знаковое число с плавающей запятой

Не забывайте, что по правилам XML, вне зависимости от типа атрибута, он должен быть заключён в двойные кавычки.