Returns information about a particular online toon tied to a RealID friend

See also functions.


hasFocus, toonName, client, realmName, realmId, faction, race, class, unknown, zoneName, level, gameText, broadcastText, broadcastTime = BNGetFriendToonInfo(friendIndex, toonIndex)



  • hasFocus - Whether or not this toon is the one currently being displayed in Blizzard's FriendFrame. (boolean)
  • toonName - The toon's name (string)
  • client - The name of the game the friend is currently playing, if any; Returns initialism for World of Warcraft ('WoW') (string)
  • realmName - The toon's realm name (string)
  • realmId - The toon's realm ID (number)
  • faction - The toon's faction. Returns -1 for offline, 0 for Horde, 1 for Alliance (number)
  • race - The toon's race (string)
  • class - The toon's class (string)
  • unknown - (string)
  • zoneName - The toon's zone (location) (string)
  • level - The toon's character level (string)
  • gameText - The zone and server of the active toon separated by a hyphen (string)
  • broadcastText - The user's RealID broadcast message (string)
  • broadcastTime - The time the broadcast message was first set (string)