IMPORTANT

I (Deathbetray) am no longer actively maintaining this addon as I don't play World of WarCraft anymore. As I understand it, Covenants are no longer a feature in Dragonflight so I doubt this addon is useful anymore so the database will not be updated anymore either.

Summary

This addon will specify a player's covenant in their tooltip.

Mouseover 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")

What's Your Covenant