Skip to content



An Avatar is an unlockable and equippable reward given to players. It is similar to a profile picture and is intended to be shown next to a player's name on a Leaderboard.
It consists of an ID, Title, Source, and an Unlocked status. The Source field is where the identifier or file path of its asset is stored. If the source is a url, then you can use that url to download and display the player avatar. If it's the name of an asset in an asset database that's stored as an addressable, you can load that asset at runtime when you display a ui that requires avatars.

Avatars are contained within IAvatarCollections, which are used to separate avatars thematically and for easier management of a large amount of avatars.


IAvatarCollection is a collection of Avatars. The IAvatarCollection is responsible for locking and unlocking individual Avatars for a player. Once an IAvatarCollection is unlocked and obtained by the player, the individual Avatars within the collection can then be unlocked through various reward sources, or they can be set to be unlocked by default when the IAvatarCollection is unlocked. The IAvatarCollection also has additional functionality to check if an IAvatarCollection contains a specific Avatar, or to return a list of all unlocked Avatars.


The Avatar Service is used to access IAvatarCollections. The IAvatarService can be used to get all IAvatarCollections, all unlocked Collections, or check the unlock status of individual Avatars. Unlocking individual Avatars should generally be done through the IAvatarService, as that will also unlock the containing IAvatarCollection if that has not been already done.