Modify Player Model (Power Type)

Replaces the holder's player model while the power is active. The new model can be one of Apoli's built-in models, a model registered by an addon mod, or a Figura avatar shipped in a resource pack.

Type ID: apoli:modify_player_model

Fields

Built-in models

Six models ship with Apoli itself, so model can name them without any addon:

They are real player models, so the holder's own skin is drawn on them (wide and slim are both baked), and armour, held items, the cape and every vanilla animation keep working.

The horse half of apoli:centaur is drawn from its own texture, apoli:textures/entity/centaur/horse.png. It is a standard 64 × 64 horse skin, so any horse texture drops straight in. Override it for everyone with a resource pack, or per power with texture_location.

The extra limbs each model adds can be targeted by name from apoli:modify_model_parts and from the body_parts list of apoli:custom_model_render:

apoli:digi_legs adds no new top-level parts. Its thigh, shin and paw live inside right_leg and left_leg, so hiding or colouring a leg covers the whole limb.

Textures

The parts of a model that come from the player (the head, body, arms and legs of every built-in model) always wear the holder's own skin, which is why a player keeps their identity while transformed. texture_location paints only the parts a model adds that aren't drawn from the skin, such as the horse half of apoli:centaur:

{
    "type": "apoli:modify_player_model",
    "model": "apoli:centaur",
    "texture_location": "example:textures/entity/zebra_centaur.png"
}

The texture only has to cover those parts. For the centaur, that is a standard 64 × 64 horse skin. Models without such parts (apoli:vanilla, apoli:four_arms, apoli:six_arms, apoli:stinkfly and apoli:digi_legs) have nothing for it to paint.

To give the player a different skin, pair the model with an apoli:custom_model_render in texture mode. It paints whichever model is being drawn, extra limbs included, and show_first_person carries it onto the first person hand:

{
    "type": "apoli:multiple",
    "model": {
        "type": "apoli:modify_player_model",
        "model": "apoli:four_arms"
    },
    "skin": {
        "type": "apoli:custom_model_render",
        "texture_location": "example:textures/entity/four_armed_yeti.png",
        "show_first_person": true
    }
}

custom_model_render also takes separate wide_texture_location and slim_texture_location textures, since the slim arms sample a narrower strip of the skin.

Animations

animations takes the same clips as apoli:custom_model_render, a Blockbench Bedrock export at assets/<namespace>/animations/<path>.animation.json, and plays them on the player's own body. Entries are read top to bottom and the first whose condition passes is the one that plays. See Model Animation for speed, loop and the rest.

{
    "type": "apoli:modify_player_model",
    "model": "apoli:vanilla",
    "animations": {
        "animation": "example:wings",
        "name": "hover"
    }
}

Bone names are the vanilla part names (head, body, right_arm, left_arm, right_leg, left_leg and the overlay names), matched ignoring case and underscores, so a clip written against RightArm binds without renaming. The extra limbs of apoli:four_arms, apoli:six_arms and apoli:stinkfly can be addressed by their own names too.

A pose that never changes is usually better baked into a model than animated. Use animations when the pose has to move or has to switch on a condition.

One extra name is recognised: a bone called root moves the whole model, which is how an avatar sits its wearer higher or further back. Only its position channel is read. Rotating every part around its own pivot isn't the same as rotating the model, so rotation and scale on root are ignored. The cape and ears don't follow it.

Keyframes are added to the pose the player already has, so an animated right_arm still swings as the player walks.

Vanilla animations already work

You don't need to port walking, running, swimming, flying, sneaking or sleeping. The built-in and addon models are real player models driven by the same vanilla code as an ordinary player, so every vanilla animation and pose already plays on them. animations is for the poses vanilla doesn't have.

Combining with custom_model_render

apoli:custom_model_render layers on top of whichever model is being drawn, so the two powers stack. In texture mode the replacement skin is painted onto the swapped model instead of the vanilla one, which is how you give apoli:digi_legs a texture other than the player's skin. In geometry mode the custom bones track the swapped model's live pose, so a geometry model bound to body or right_arm follows the new model.

Figura avatars

If Figura is installed on the client and model isn't a registered addon model, the ID is resolved to a compiled Figura avatar in the client resources. "model": "mymod:werewolf" loads assets/mymod/figura_avatars/werewolf.nbt.

The avatar is applied to that player exactly the way the Figura wardrobe equips one. The full avatar loads (models, textures, animations, scripts and sounds), so anything a wardrobe avatar can do works here too. On unequip, Figura's own reload path brings back whatever the player had before, either their local wardrobe avatar or their uploaded one.

To produce the .nbt file, build the avatar as usual in figura/avatars/, equip it in the wardrobe, then run Figura's export command:

/figura export avatar werewolf

This writes figura/werewolf.nbt. Copy it to assets/<namespace>/figura_avatars/<path>.nbt in your mod or resource pack.

Registered addon models

On the client, addon mods can register model factories with ApoliPlayerModels.register(id, factory). Wide and slim variants are baked per renderer, like vanilla. A registered ID takes priority over a Figura avatar of the same name and swaps the vanilla PlayerModel during rendering, keeping the player's skin texture.

Notes

• If several modify_player_model powers are active, the first active one wins.
• The built-in models need nothing installed. A Figura avatar needs Figura installed and the avatar in every client's resources (ship it in the mod or in a server resource pack). Without Figura, or if the .nbt is missing, the power does nothing and a warning is logged once.
• Reloading resources (F3+T) swaps in updated avatars, like Figura's own avatar hot swap.
• Figura's panic mode (its keybind is in Figura's settings) hides avatars as usual, and the power applies again once panic mode is off.

Examples

{
    "type": "apoli:modify_player_model",
    "model": "mymod:werewolf",
    "condition": {
        "type": "apoli:sneaking"
    }
}

This applies the assets/mymod/figura_avatars/werewolf.nbt avatar while the player sneaks, and restores the player's own model when they stop.

A built-in model needs nothing but the ID:

{
    "type": "apoli:modify_player_model",
    "model": "apoli:digi_legs"
}