pfUI/libs/libunitscan.lua

-- load pfUI environment
setfenv(1, pfUI:GetEnvironment())

--[[ libunitscan ]]--
-- A pfUI library that remembers the level of every player it sees: in the
-- friends, guild, raid and party rosters, in /who results, and as target,
-- mouseover or nameplate. The levels are persisted within pfUI_playerDB, for
-- the places that only have a player's name, such as chat links and offline
-- friends. Anything with a unit reads the unit itself instead. A player's
-- class comes from C_PlayerCache.GetPlayerInfoByName, not from here.
--
-- External functions:
--   GetPlayerLevel(name)
--     Returns the last seen level of the given player name, or nil if it was
--     never seen.
--

-- return instantly when another libunitscan is already active
if pfUI.api.libunitscan then return end

local players = {}

-- Feed a unit into ClassicAPI's persistent name cache. Roster-style packets
-- (party / raid / inspect on glance) carry class inline, so the engine often
-- doesn't issue a separate name query and the DLL's NameCache hook never
-- fires for them — this is where we close that gap.
local function RememberByUnit(unit)
  local guid = UnitGUID(unit)
  if not guid then return end
  local _, race = UnitRace(unit)
  C_PlayerCache.RememberPlayer(guid, UnitName(unit), UnitClassBase(unit), race, UnitSex(unit) - 2)
end

function GetPlayerLevel(name)
  local entry = players[name]
  return entry and entry.level
end

-- UnitLevel returns -1 for unknown levels, don't overwrite known values
local function AddLevel(name, level)
  if not name or not level or level <= 0 then return end
  local entry = players[name]
  if entry then
    entry.level = level
  else
    players[name] = { level = level }
  end
end

local libunitscan = CreateFrame("Frame", "pfUnitScan", UIParent)
libunitscan:RegisterEvent("PLAYER_ENTERING_WORLD")
libunitscan:RegisterEvent("FRIENDLIST_UPDATE")
libunitscan:RegisterEvent("GUILD_ROSTER_UPDATE")
libunitscan:RegisterEvent("RAID_ROSTER_UPDATE")
libunitscan:RegisterEvent("PARTY_MEMBERS_CHANGED")
libunitscan:RegisterEvent("PLAYER_TARGET_CHANGED")
libunitscan:RegisterEvent("WHO_LIST_UPDATE")
libunitscan:RegisterEvent("CHAT_MSG_SYSTEM")
libunitscan:RegisterEvent("UPDATE_MOUSEOVER_UNIT")
libunitscan:RegisterEvent("NAME_PLATE_UNIT_ADDED")
libunitscan:SetScript("OnEvent", function()
  if event == "PLAYER_ENTERING_WORLD" then

    -- load pfUI_playerDB
    players = pfUI_playerDB

    -- update own character details
    AddLevel(UnitName("player"), UnitLevel("player"))
    RememberByUnit("player")

  elseif event == "FRIENDLIST_UPDATE" then
    for i = 1, GetNumFriends() do
      local info = C_FriendList.GetFriendInfoByIndex(i)
      if info then
        AddLevel(info.name, info.level)
      end
    end

  elseif event == "GUILD_ROSTER_UPDATE" then
    local name, level, _
    for i = 1, GetNumGuildMembers() do
      name, _, _, level = GetGuildRosterInfo(i)
      AddLevel(name, level)
    end

  elseif event == "RAID_ROSTER_UPDATE" then
    local name, level, _
    for i = 1, GetNumRaidMembers() do
      name, _, _, level = GetRaidRosterInfo(i)
      AddLevel(name, level)
      RememberByUnit("raid" .. i)
    end

  elseif event == "PARTY_MEMBERS_CHANGED" then
    local unit
    for i = 1, GetNumPartyMembers() do
      unit = "party" .. i
      AddLevel(UnitName(unit), UnitLevel(unit))
      RememberByUnit(unit)
    end

  elseif event == "WHO_LIST_UPDATE" or event == "CHAT_MSG_SYSTEM" then
    for i = 1, C_FriendList.GetNumWhoResults() do
      local info = C_FriendList.GetWhoInfo(i)
      if info then
        AddLevel(info.fullName, info.level)
      end
    end

  elseif event == "UPDATE_MOUSEOVER_UNIT" or event == "PLAYER_TARGET_CHANGED" or event == "NAME_PLATE_UNIT_ADDED" then
    local scan = event == "PLAYER_TARGET_CHANGED" and "target"
              or event == "NAME_PLATE_UNIT_ADDED" and arg1
              or "mouseover"
    if UnitIsPlayer(scan) then
      AddLevel(UnitName(scan), UnitLevel(scan))
      RememberByUnit(scan)
    end
  end
end)

pfUI.api.libunitscan = libunitscan