LibPlayerSpells-1.0

Хочешь карту со своим ником? Оформить ❤️

LibPlayerSpells-1.0

LibPlayerSpells-1.0-это библиотека, предоставляющая данные о заклинаниях двенадцати классов персонажей в World of Warcraft. Он также включает в себя дополнительные заклинания, полученные из расовых особенностей и других источников. Слово «заклинания» используется здесь в общем смысле; оно включает как активные навыки, так и пассивные заклинания, которые можно найти в книге заклинаний игроков. Баффы и дебаффы, которые применяются игроком из других источников, также покрываются.

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

Он дает ответы на такие вопросы, как:

• Есть ли у этого заклинания перезарядка?
• Применяется ли это заклинание один или несколько баффов или дебаффов?
• Это заклинание требует выживания, или использовать для ДПС?
• Это заклинание регенерирует ману или какой-то другой ресурс?
• Каковы баффы выживания всех классов?
• Какие способности прерывания заклинаний доступны?

Каждый класс имеет свой собственный файл данных, который может быть обновлен отдельно от основного кода.

Поддерживаемые классы и спецификации

Еще не все классы и специализации поддерживаются на 100%. Тем не менее, большинство прерываний, рассеиваний и охлаждений выживания завершены.

Если LibPlayerSpells не хватает чего-то конкретного из вашего класса, пожалуйста, напишите подробную ошибку на Github или внесите свой вклад в проект самостоятельно, если вы чувствуете себя храбрым! Во втором случае обязательно ознакомьтесь с руководящими принципами по вкладу.

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

Скопируйте файлы библиотеки в свой аддон и перечислите lib.xml файл в файле TOC.

LibPlayerSpells-1.0 использует LibStub:
local LibPlayerSpells = LibStub ('LibPlayerSpells-1.0')

Запрос информации из заклинания

Затем вы можете получить информацию о данном заклинании с помощью GetSpellInfo:
локальные флаги, провайдеры, modifiedSpells [, moreFlags] = LibPlayerSpells:GetSpellinfo(spellId)
Где:

• spellId-это числовой идентификатор заклинания.
• флаги-это битовое поле, содержащее данные о заклинаниях (см. ниже).
• провайдеры — это идентификатор(или таблица) идентификаторов заклинаний; в противном случае, если провайдер не найден в книге заклинаний игрока, данное заклинание недоступно. Например, заклинание поставщика может быть пассивным заклинанием, заданным талантом.
• modifiedSpells является (или таблицу) идентификатор(ы) чар(ы), пострадавших от данного заклинания.
• Если данное заклинание является частным случаем (см. ниже), то moreFlags содержит еще одно битовое поле.

Запрос базы данных заклинаний

Вы можете перебирать базу данных, ища определенные заклинания, используя IterateSpells:
для spellId, flags, providers, modifiedSpells, moreFlags в LibPlayerSpells: IterateSpells(oneOfFlags, requiredFlags, rejectedFlags) do
-- Сделай что-нибудь с добычей
.
флаги, поставщики, modifiedSpells, moreFlags имеют то же значение, что и значения, возвращаемые GetSpellinfo. spellId-это, очевидно, числовой идентификатор текущего заклинания.

Три аргумента метода используются для построения фильтра. Это спецификации битовой маски. Они могут быть переданы как числовая битовая маска, вычисленная с использованием bit.bor и библиотечных констант, или строка, содержащая флаги, разделенные пробелами или запятыми. Например, bit.bor(LibPlayerSpells.constants.Охотник, LibPlayerSpells.constants.Прорвало) такая же маска, как "охотник взрыв".

IterateSpells перечисляет все заклинания, которые:

• имеет по крайней мере один из флагов, перечисленных oneOfFlags
• и имеет все флаги, перечисленные requiredFlags,
• и не имеет ни одного из флагов в rejectedFlags.

Если битовая маска пуста или не предусмотрена, соответствующее условие игнорируется. Без каких-либо аргументов перечисляются все заклинания.

Пример:
- Повторяйте заклинания, которые имеют перезарядку, являются / применяют ауру и являются либо навыками выживания, либо навыками регенерации маны.
для spellId, флаги, поставщиков, modifiedSpells, moreFlags в LibPlayerSpells:IterateSpells("REGEN_MANA выживания", "аура восстановления"), делать
-- Сделай с ним
что-нибудь!

Флаги

Большая часть информации о заклинаниях хранится в битовом поле для компактного хранения и легкой проверки или фильтрации заклинаний. Константы битовых значений доступны в таблице LibPlayerSpells.constants.

Наличие определенного флага можно проверить таким образом:
если bit. band(флаги, LibPlayerSpells. constants.Аура) ~ = 0 тогда
-- Это заклинание-аура, сделай с ним что-нибудь осмысленное.


Однако библиотека предоставляет способ легко создавать тесты флагов.

Специальные типы заклинаний

Эти флаги указывают на специальные заклинания, которые (будут) иметь дополнительные данные.

• CROWD_CTRL: это заклинание контроля толпы; дополнительные данные — это битовое поле, указывающее на категорию уменьшающихся возвратов (дезориентация, насмешка и т. д.).
• DISPEL: это заклинание может рассеять как дебаффы союзников, так и баффы врагов; никаких дополнительных данных пока нет.

Флаги контроля толпы

Эти флаги используются в дополнительных данных для заклинаний контроля толпы и указывают на категорию убывающей отдачи, к которой принадлежит заклинание. Хотя прерывание и откат технически сами по себе являются категориями DR, они не всегда имеют связанную ауру и не прослеживаются через событие UNIT_AURA. Таким образом, они являются просто обычными флагами в битовой маске заклинания.

• Дезориентация
• Вывести из строя
• КОРЕНЬ
• ОГЛУШАТЬ
• КОЛКОСТЬ

Источники заклинаний

Эти флажки указывают на источник заклинания. Константы объясняются сами собой: рыцарьсмерти , друид, охотник, маг, монах, паладин, жрец, разбойник, шаман, колдун, воин, раса.

Нацеливание

Эти флаги намекают на механизм наведения заклинания. Большую часть времени они эксклюзивны.

• Полезно: заклинание может быть наложено на любого союзника, включая игрока и его питомца.
• Вредно: заклинание может быть наложено на любого врага.
• Личное: заклинание автоматически нацеливается на игрока.
• Домашнееживотное: заклинание автоматически нацеливается на домашнее животное игрока.

Разнообразный

• Аура: заклинание применяется (или является) баффом к союзникам или дебаффом к врагам.
• UNIQUE_AURA: данный персонаж может иметь только один экземпляр этого (de)баффа одновременно, даже если несколько игроков наложили на него одно и то же заклинание, например метку охотника.
• Перезарядка: это заклинание имеет значимый кулдаун.
• Выживание: это заклинание считается навыком выживания.
• Взрыв: это заклинание считается навыком взрыва (либо повреждающим, либо исцеляющим).
• POWER_REGEN: это заклинание позволяет цели перезарядить какой-то альтернативный ресурс, например, заряжающий энергией напиток.
• Важно: важное заклинание, на которое игрок должен реагировать.
• INVERT_AURA: логика ауры этого заклинания перевернута. Он применяет дебафф к союзникам или бафф к врагам (этот случай еще не найден), например, ослабленная душа, применяемая силовым словом: щит.

Признание

Спасибо ckaotik, Rainrider, mjmurray88, arcadepro за их тестирование и вклад в заклинания класса.

Лицензия

LibPlayerSpells-1.0 лицензируется с использованием GPL v3. Это означает, что любой аддон, использующий его, должен иметь совместимую лицензию (см.

Похожие аддоны

RatingBuster OnCast (classic) Gnosis (Castbars and Timers) AdiButtonAuras