`EVENT_FRIEND_PLAYER_STATUS_CHANGED`

ESO Lua API function — used by 40 of the 3,030 addons we indexed (combined 15,432,011 downloads). Signature from the official ESOUIDocumentation.txt, API version 101050.

Official signature

EVENT_FRIEND_PLAYER_STATUS_CHANGED(string displayName, string characterName, [PlayerStatus|#PlayerStatus] oldStatus, [PlayerStatus|#PlayerStatus] newStatus)

Real usage — from Bandits User Interface

	if BUI.Vars.FriendStatus then
		EVENT_MANAGER:UnregisterForEvent("ChatRouter", EVENT_FRIEND_PLAYER_STATUS_CHANGED)
	end

Short excerpt from the shipping addon Bandits User Interface — its ESOUI page; the code belongs to its author. Shown because documentation without a working example is half a reference.

Most-downloaded addons using it

Addon	Total downloads
Bandits User Interface	6,130,317
BeamMeUp - Teleporter (Fast Travel)	2,770,107
LibChatMessage	2,433,233
pChat (Chat customization & help: look/notification/sound/automation/history)	1,832,805
OdySupportIcons - Group Role Icons & More	484,590
EasyTravel	293,327