ModelPart Indexing

For technical documentation on ModelParts, see ModelPart.

When Figura loads your avatar, all the model files in your avatar are organized into a tree. The starting point of this tree is called models. All of the parts of your model, including cubes, meshes, and groups from your Blockbench models, as well as folders in your avatar and the model files themselves are converted to ModelParts and part of this tree.

The name models does not refer to any specific model file in your avatar. Instead, model files are created as children of the models folder. If your Blockbench model is inside a subfolder of your avatar, that folder becomes a child of models, and the model file becomes a child of the subfolder.

model.bbmodel

root

Head

Head

HeadLayer

RightArm

RightArm

RightArmLayer

Cool Name

Cool Group

cube

To access a child part, index the parent part with the name of the child part.

There are two ways to index something in Lua. The first way is by using dots:

models.model.root.Head

This code sample first gets the model part (a file named model.bbmodel) and then the Head group inside it. The name of the cube, mesh, group, folder, or file needs to be within the quotes. To access deeper parts (for example, a HeadLayer cube within the Head group), add more dots and names:

models.model.root.HeadLayer

The second way to index is longer, and uses square brackets and quotes ([""]) to separate the names. This method is required if the name of a part contains characters that aren't letters, numbers, or underscores; this includes names with spaces, like Right Arm.

When using brackets to index, place the name between the quotes, and don't include a period before it:

• models["model"]["root"]["Cool Name"] ✓ Correct
• models.model.root["Cool Name"] ✓ Correct - both brackets and dots can be mixed together!
• models.model.root.["Cool Name"] ✗ Incorrect: don't put a dot . before the bracket [.
• models.model.root[Cool Name] ✗ Incorrect: name in brackets is missing a set of quotes

To return to using dots for indexing after using brackets, place the dot after the closing bracket:

• models.model.root["Cool Group"].cube ✓ Correct
• models.model.root["Cool Group"]cube ✗ Incorrect: missing dot . after bracket

A note on model files in folders

If your Blockbench model file is within a folder in your avatar, the folder will become a part of the ModelPart tree. That means that if a model file named player.bbmodel is located in a folder named models, the model file has to be accessed with models.models.player (or models["models"]["player"].)

If you later want to use animations from a model, folders affect the indexing into the animations table too - but the system is a little different.

Instead of indexing the folder and then the file, combine each folder name and the file name with a period . and index with the combined name, even if the names of the folders and files contain special characters. For example, to get the animations from the model 2.bbmodel file in the main models folder:

main models

model 2.bbmodel

animations["main models.model 2"]