diff --git a/EVENTS.md b/EVENTS.md index 4e32792..1f65c97 100644 --- a/EVENTS.md +++ b/EVENTS.md @@ -1,6 +1,22 @@ -### Custom Events +# Nampower Custom Events -#### SPELL_QUEUE_EVENT +This document describes all custom events added by Nampower that you can register and listen to in your addons. + +For custom Lua functions, see [SCRIPTS.md](SCRIPTS.md). For general usage information, see [README.md](README.md). + +## Table of Contents +- [SPELL_QUEUE_EVENT](#spell_queue_event) +- [SPELL_CAST_EVENT](#spell_cast_event) +- [SPELL_DAMAGE_EVENT_SELF and SPELL_DAMAGE_EVENT_OTHER](#spell_damage_event_self-and-spell_damage_event_other) +- [Buff/Debuff Events](#buffdebuff-events) +- [AURA_CAST_ON_SELF and AURA_CAST_ON_OTHER](#aura_cast_on_self-and-aura_cast_on_other) +- [UNIT_DIED](#unit_died) + +--- + +## Custom Events + +### SPELL_QUEUE_EVENT I've added a new event you can register in game to get updates when spells are added and popped from the queue. The event is `SPELL_QUEUE_EVENT` and has 2 parameters: @@ -39,7 +55,7 @@ end NampowerSettings:RegisterEvent("SPELL_QUEUE_EVENT", spellQueueEvent) ``` -#### SPELL_CAST_EVENT +### SPELL_CAST_EVENT Event you can register in game to get updates when you cast spells with some additional information. This will only fire for spells you (and certain pets) initiated. The event is `SPELL_CAST_EVENT` and has 5 parameters: @@ -74,7 +90,7 @@ Cursive:RegisterEvent("SPELL_CAST_EVENT", function(success, spellId, castType, t end); ``` -#### SPELL_DAMAGE_EVENT_SELF and SPELL_DAMAGE_EVENT_OTHER +### SPELL_DAMAGE_EVENT_SELF and SPELL_DAMAGE_EVENT_OTHER New events you can register in game to get updates whenever spell damage occurs. SPELL_DAMAGE_EVENT_SELF will only trigger for damage you deal, while SPELL_DAMAGE_EVENT_OTHER will only trigger for damage dealt by others. Both of these events have the following parameters: @@ -110,7 +126,7 @@ Cursive:RegisterEvent("SPELL_DAMAGE_EVENT_SELF", end); ``` -#### Buff/Debuff Events +### Buff/Debuff Events New events fire whenever a buff or debuff is added or removed on you or any other unit that the client tracks. Events: @@ -145,7 +161,7 @@ for _, eventName in ipairs({"BUFF_ADDED_SELF", "BUFF_REMOVED_SELF", "DEBUFF_ADDE end ``` -#### AURA_CAST_ON_SELF and AURA_CAST_ON_OTHER +### AURA_CAST_ON_SELF and AURA_CAST_ON_OTHER Fire when a spell cast applies an aura. "Self" covers casts that land on the active player (including cases where the active player is the caster with no explicit target); "Other" covers all other targets. These events are gated behind the `NP_EnableAuraCastEvents` CVar (default 0). Set it to `1` to enable. @@ -164,7 +180,7 @@ Parameters: 8. int durationMs - spell duration in milliseconds (includes client modifiers if you are the caster) 9. int auraCapStatus - bitfield: 1 = buff bar full, 2 = debuff bar full (3 means both) -#### UNIT_DIED +### UNIT_DIED Fires when a unit death is recorded in the combat log. Parameters: diff --git a/SCRIPTS.md b/SCRIPTS.md index e7c5523..e78ac0e 100644 --- a/SCRIPTS.md +++ b/SCRIPTS.md @@ -8,10 +8,42 @@ For installation, configuration, and general usage information, see the main [RE - [Performance Optimization - Table References](#performance-optimization---table-references) - [Custom Lua Functions](#custom-lua-functions) - [Spell/Item/Unit Information](#spellitemunit-information) + - [GetItemStats](#getitemstatsitemid-copy) + - [GetItemStatsField](#getitemstatsfielditemid-fieldname-copy) + - [FindPlayerItemSlot](#findplayeritemslotitemid-or-itemname) + - [UseItemIdOrName](#useitemidornameitemidorname-target) + - [GetEquippedItems](#getequippeditemsunittoken) + - [GetEquippedItem](#getequippeditemunittoken-slot) + - [GetBagItems](#getbagitems) + - [GetBagItem](#getbagitembagindex-slot) + - [GetSpellRec](#getspellrecspellid-copy) + - [GetSpellRecField](#getspellrecfieldspellid-fieldname-copy) + - [GetSpellModifiers](#getspellmodifiersspellid-modifiertype) + - [GetUnitData](#getunitdataunittoken-copy) + - [GetUnitField](#getunitfieldunittoken-fieldname-copy) + - [GetSpellIdForName](#getspellidfornamenspellname) + - [GetSpellNameAndRankForId](#getspellnameandrankforidid) + - [GetSpellSlotTypeIdForName](#getspellslottypeidfornamenspellname) + - [GetNampowerVersion](#getnampowerversion) + - [GetItemLevel](#getitemlevelitemid) - [Spell Casting and Queuing](#spell-casting-and-queuing) + - [QueueSpellByName](#queuespellbynamespellname) + - [CastSpellByNameNoQueue](#castspellbynamenoqueuespellname) + - [QueueScript](#queuescriptscript-priority) + - [IsSpellInRange](#isspellinrangespellname-target-or-isspellinrangespellid-target) + - [IsSpellUsable](#isspellusablespellname-or-isspellusablespellid) + - [ChannelStopCastingNextTick](#channelstopcastingnexttick) - [Cast Information](#cast-information) + - [GetCurrentCastingInfo](#getcurrentcastinginfo) + - [GetCastInfo](#getcastinfo) - [Cooldown Information](#cooldown-information) + - [GetSpellIdCooldown](#getspellidcooldownspellid) + - [GetItemIdCooldown](#getitemidcooldownitemid) + - [GetTrinkets](#gettrinketscopy) + - [GetTrinketCooldown](#gettrinketcooldownslotitemidorname) + - [UseTrinket](#usetrinketslotitemidorname-target) - [Utility Functions](#utility-functions) + - [DisenchantAll](#disenchantallitemidorname-or-disenchantallquality) --- ## Performance Optimization - Table References diff --git a/nampower.map b/nampower.map index 3a5cccf..03d7eeb 100644 --- a/nampower.map +++ b/nampower.map @@ -1,6 +1,6 @@ nampower - Timestamp is 694eef4b (Fri Dec 26 12:25:47 2025) + Timestamp is 694ef97c (Fri Dec 26 13:09:16 2025) Preferred load address is 10000000 @@ -3464,7 +3464,7 @@ 0002:000073dc ??_C@_05EBCMBJBB@blues@ 1007c3dc misc_scripts.cpp.obj 0002:000073e8 __real@3ff0000000000000 1007c3e8 misc_scripts.cpp.obj 0002:000073f0 __real@4000000000000000 1007c3f0 misc_scripts.cpp.obj - 0002:000073f8 __real@4034000000000000 1007c3f8 misc_scripts.cpp.obj + 0002:000073f8 __real@4035000000000000 1007c3f8 misc_scripts.cpp.obj 0002:00007400 __real@408f400000000000 1007c400 misc_scripts.cpp.obj 0002:0000740c ??_C@_0CD@FAFLFIPA@Casting?5next?5spell?5without?5queu@ 1007c40c spell_scripts.cpp.obj 0002:00007430 ??_C@_0BO@KHCNJBCM@Force?5queuing?5next?5cast?5spell@ 1007c430 spell_scripts.cpp.obj