Swing Hand (Entity Action Type)

Swings the specified hand.

Type ID: apoli:swing_hand

This action is purely cosmetic, and will not interact with the world in any way. This means you can’t use this to break, or place blocks, hit or use entities, or any other action that involves swinging your hand.

Fields#

Field	Type	Default	Description
hand	Hand	"main_hand"	Which hand is swung: "main_hand" or "off_hand". "mainhand"/"offhand" and the upper-case spellings are also accepted.

Examples#

"entity_action": {
    "type": "apoli:swing_hand",
    "hand": "off_hand"
}

This example will swing the entity’s off hand.

Swinging both hands at once#

Run the action twice in the same tick, once per hand, and both arms swing together:

"entity_action": {
    "type": "apoli:and",
    "actions": [
        { "type": "apoli:swing_hand", "hand": "main_hand" },
        { "type": "apoli:swing_hand", "hand": "off_hand" }
    ]
}

Minecraft only tracks one swing per entity, so before this the second call simply replaced the first and you saw a single arm move. Apoli now notices that the second swing arrived while the other arm was already swinging and animates both.

The two arms share one swing timer, so they move in perfect sync — this is a two-fisted swing, not two independent ones. It works in third person and, with apoli:show_both_arms, in first person as well; without that power vanilla only draws one first-person arm, so there is only one arm there to animate.

Both calls have to land in the same tick. A tick or more apart and Minecraft rejects the second swing outright, exactly as it does without Apoli, and you get one arm.