IMPORTANT
I (Deathbetray) am no longer actively maintaining this addon as I don't play World of WarCraft anymore (for now, the database will still be being updated: I just won't be adding new features or fixing any bugs).
Summary
This addon will specify a player's covenant in their tooltip.
NOTICE: this addon uses a similar method as some others (like Raider.IO) which requires the database of players to be regularly updated as there's no in-game method of reliably obtaining a player's covenant. If people show enough interest in the addon then I may try to find additional ways of expanding my existing player list.
API
If you're wanting to have your own addon/code directly interact with WhatsYourCovenant, the following functions are available:
GetCovenantId
Arguments
- realm - the realm name of the player (e.g. "Twisting Nether")
- player - the name of the player (e.g. "Deathbetray")
Returns
- id - the covenant ID of the given player
- timestamp - the UNIX time (in seconds) the player's covenant was last acquired (personal database uses GetServerTime())
- fromPersonalDb - true if the data was found in the personal database (rather than the data packaged with the addon)
All return values are nil if the player isn't found
Usage
local id, timestamp, fromPersonalDb = _G.WhatsYourCovenant.GetCovenantId("Twisting Nether", "Deathbetray")
GetCovenantName
Arguments
- realm - the realm name of the player (e.g. "Twisting Nether")
- player - the name of the player (e.g. "Deathbetray")
Returns
- name - the name of the player's covenant (e.g. "Necrolord", "Night Fae", etc.) as retrieved by C_Covenants.GetCovenantData(). I believe the name should be localised.
- colour - the hex colour the addon uses to colourise the covenant name (this return nil if a player has the colourisation disabled).
All return values are nil if the player isn't found
Usage
local covenantName, covenantColour = _G.WhatsYourCovenant.GetCovenantName("Twisting Nether", "Deathbetray")