Skip to main content

Avatar File Format

The basics on how avatars work

Avatars are stored in <minecraftDirectory>/figura/avatars. You can get to this folder quickly via the button in the Figura Menu.
A Figura Avatar consists of a named folder or a zip file containing an avatar.json file. That is everything needed for an avatar to appear in Wardrobe.

avatars└─ <AvatarName>   └─ avatar.json

An avatar.json file is just a renamed text file which contains Avatar Metadata in the form of a json object, but it can be empty. It's presence tells Figura that this folder is an Avatar.

Figura also looks for an image named avatar.png. This will be used as the avatar's icon which will appear next to it's name in the Wardrobe.

avatars└─ <AvatarName>   ├─ avatar.json   └─ avatar.png

Additional files go either in the same folder as the avatar.json, or within a subfolder.

  • All files with the extension .lua will be treated as script files and executed when your avatar is loaded.
  • All files with the extension .bbmodel will be treated as model files. The minimum BlockBench version supported is 4.0.
  • All files with the extension .ogg will be treated as sound files. They must be in Vorbis codec.

Stray texture files in the avatar folder will not be loaded by Figura. For a texture to be loaded by Figura, it must be registered as a texture in a bbmodel file.

ALL files that begin with a period (.) will be ignored when figura loads an avatar. Files that are not loaded by Figura are not accessible at all, so don't bother trying to get around the 100kb limit with this.