Variants

Variants allow you to hot-swap textures on your Rig in-game.

This can be used to hide or reveal details on your model, change the color of your model, or even change the model entirely based on which Variant is applied.

The Variants Panel

Variants Panel

The Variants Panel is where you can create, edit, and delete Variants.

It's only visible in Edit mode and by default is located in the lower left corner of the UI.

The Default Variant

The default Variant just that, default. It's essentially the textures your Rig has when no variants are applied. It's marked with a little star in the Variants panel.

The default Variant can be renamed, but cannot deleted, or have it's texture map changed.

Variant Properties

Variant Properties

Name

The name of the Variant. This should be unique!

Affected Bones is a Whitelist

If this is checked, then the Affected Bones list is a whitelist of bones that will be affected by the Variant. If this is unchecked, then the Affected Bones list is a blacklist of bones that will not be affected by the Variant.

Affected Bones

This is a list of bones that will either be affected or uneffected by the Variant based on the Affected Bones is a Whitelist setting.

Texture Map

The texture map defines which textures are replaced when swapping to a Variant.

The texture on the left is the texture that will be replaced, and the texture on the right is the texture that will replace it.

You can change the replacing texture by clicking on it and selecting a new texture.

Scoreboard Data

Global variables and constants are stored in fake players on the aj.i scoreboard.

Globals

Global variables and constants are stored in fake players.

  • Variant ID

    • $aj.<project_name>.variant.<variant_name> aj.id

    Each variant creates a scoreboard constant with the variant ID.

    Internally this is the index of the variant in the Variants panel.