Camera and features

Punchy! Moves puts a shoulder camera behind your character and plays the animations of your resource pack on the whole body. This page shows you how to switch the camera on and frame it, what each feature switch does, and the moments of play that Moves can animate, with the settings each one reads. It is for players who want to tune their view and for pack makers who need to know what a feature expects.

Before you start

• Punchy! Moves is installed. Getting started covers the install.
• The camera works on its own. The animations come from a resource pack, because Moves ships no clips of its own. The clips on this page use the example pack provided by Crafto, Fluid & Foolish.
• Most feature cameras (fence, ladder, elytra, nearby block, aiming and riding) frame the view with numbers that a pack supplies. A pack that gives none leaves that camera on your own framing.

Turn on the camera and frame it

Video coming soon

The Camera page

F7 opens Moves’ own settings screen, titled Punchy Moves, with or without Punchy! installed. It has three pages on the left, under the heading SETTINGS: Camera, Features and Shortcuts. The face settings are elsewhere: with Punchy!‘s new menu installed, they are the Face tab of its Punchy Moves group, covered on Faces.

The Camera page has the Custom Camera button at the top and the six sliders under it, four at a time.

The buttons:

• Replay tutorial, in the left column, shows the seven-page quick guide again.
• Reset, at the bottom of the left column, puts every camera value, every feature switch and the Better Combat pack attacks and Spatial GUI panel choices back to their defaults and turns the custom camera on, whichever page is open.
• Done and the cross at the top (Close) save and close the screen.

Keys

You can change each one under Punchy Moves in Minecraft’s key binds. The Open Minecraft key binds button on the Shortcuts page takes you there. The page lists your current keys, one row each, and scrolls past ten rows. The emote wheel and the other keys are on Keys and emotes.

The orbit camera

The orbit camera lets you look around your character without turning it.

Video coming soon

Pressing B with the camera off shows “Enable the custom camera first”. Turning the custom camera off, or pressing Minecraft’s own perspective key, also ends the orbit.

How the camera behaves

• Turning it on takes about 0.9 seconds and turning it off about 0.7 seconds, so the view never jumps.
• The camera glides to its spot. When a feature camera changes the framing, the move is smooth too.
• Blocks push the camera in. It stops in front of a wall instead of sitting inside it.
• Your character fades as the camera comes close to its body, and disappears when the camera would be inside it.
• The camera works in Minecraft’s third-person back view. Minecraft’s own perspective key (F5 by default) turns the custom camera off on its way through first person and the front view.
• In first person you see Minecraft’s own view. Moves does not pose your character there.
• While you swim in a swim pose, the camera follows the swimming body, so the view stays at your character’s head.

The camera.json file

Moves saves the camera in config/punchy_moves/camera.json. It writes the file each time you let go of a slider, flip a switch, close Moves’ own screen or press V. You can also edit it by hand while the game is closed.

{
  "enabled": true,
  "horizontal": 1.17,
  "vertical": -0.11,
  "depth": 2.5,
  "fov": 70.0,
  "rotationYaw": 0.0,
  "rotationPitch": 0.0,
  "fenceCamera": true,
  "ladderCamera": true,
  "proximityCamera": true,
  "elytraCamera": true,
  "mapCamera": true,
  "bowAndCrossbowCameraFix": true,
  "spearAndTridentCameraFix": true,
  "ladderBodyLock": true
}

A key you leave out keeps its default. A file that is not a JSON object, a key set to null, or a number key written as text that is not a number resets every value in the file to its default, the switches and Custom Camera included. A switch written as text or a number counts as off unless the text reads true (capitals do not matter).

Feature switches and pack cameras

The Features page has ten rows and shows four at a time: scroll with the mouse wheel or drag the scrollbar to reach them all. The first eight rows are switches, all on by default. The ninth chooses the Better Combat mode and the tenth the Spatial GUI mode. Each change saves at once.

Video coming soon

A camera block

Every pack camera is one block of five numbers. They mean the same as the sliders on the Camera page.

A fence, ladder, elytra, nearby-block or aiming camera needs all five numbers. A block with a missing number, or a response that is 0 or less, stays off, and the view keeps your own framing. Two cameras are the exceptions. A riding camera needs horizontal, vertical, depth and fov, and response is optional (4 when left out). The map camera fills in any number you leave out with its built-in value (horizontal 0, vertical 0.68, depth 1, fov 55, response 4.5), and a response of 0 or less counts as 0.1.

A pack with cameras

This file gives a pack seven cameras: fence, ladder, elytra, riding, nearby block, aiming and map. The numbers come from the example pack provided by Crafto. The clip names are placeholders for yours.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "fence": {
        "clip": "my_fence_hold",
        "camera": { "horizontal": 0, "vertical": 0.75, "depth": 2.94, "fov": 85, "response": 4 }
      },
      "climbing": {
        "clip": "my_climb",
        "camera": { "horizontal": 0, "vertical": 0.11, "depth": 2.34, "fov": 70, "response": 4 }
      },
      "elytra": {
        "normal": "my_glide",
        "camera": { "horizontal": 0.92, "vertical": 0.36, "depth": 3.63, "fov": 70, "response": 3.5 }
      },
      "passenger_state": {
        "entities": ["minecraft:nautilus"],
        "idle": "my_nautilus_idle",
        "moving": "my_nautilus_swim",
        "camera": { "horizontal": 0.88, "vertical": -0.65, "depth": 3.91, "fov": 68, "response": 3.5 }
      }
    }
  },
  "cameras": {
    "proximity": {
      "instant_distance": 1,
      "enter_distance": 2.2,
      "mining_hold_seconds": 2,
      "blend_in_response": 5,
      "blend_out_response": 3.2,
      "camera": { "horizontal": 0.44, "vertical": 0.33, "depth": 2.85, "fov": 80, "response": 4 }
    },
    "aiming": {
      "camera": { "horizontal": 0, "vertical": 0.75, "depth": 2.94, "fov": 85, "response": 4 }
    }
  },
  "item_groups": {
    "MAP": {
      "animations": {
        "map_view": {
          "pose": "my_map_pose",
          "look_down_enter": 55,
          "look_down_exit": 18,
          "camera": { "horizontal": 0, "vertical": 0.68, "depth": 1, "fov": 55, "response": 4.5 }
        }
      }
    }
  }
}

Save it as assets/punchy_moves/compat/cameras.json in your pack. After editing a pack, press F3+T to reload it. cameras takes only proximity and aiming. Any other key there drops the whole file.

When more than one camera applies

Cameras blend one over the other in this order: fence, nearby block, ladder, elytra, riding, map, aiming. When two apply together, the one lower in the list takes over, blending by its own response (the nearby-block camera uses its blend_in_response and blend_out_response). When none apply, the view returns to the framing of your sliders.

What Punchy! Moves animates

A pack tells Moves which clip belongs to which moment in its compat files, under assets/punchy_moves/compat/. The clips live in assets/punchy_moves/animations/. The sections below name each moment, its action key and its settings.

• Body moments (walking, falling, swimming, riding and more) go in defaults.animations. Writing them anywhere else does nothing.
• Held-item moments go in defaults, empty_hand, item_groups or items. For a held item, Moves looks at the exact item first, then its group, then defaults. An empty hand uses empty_hand, then defaults.
• A clip name that no animation file defines never plays, and nothing warns you.

Compat files is the full format. This page is the tour.

A small file shows the shape:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "idle": "my_idle",
      "walking": {
        "directions": {
          "forward": "my_walk_forward",
          "backward": "my_walk_backward",
          "left": "my_sidestep_left",
          "right": "my_sidestep_right"
        }
      },
      "jump": { "left": "my_jump_left", "right": "my_jump_right" }
    }
  }
}

Standing, idle moments and turning

idle is the standing loop. Everything else falls back to it when a pose has no idle of its own.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "idle_events": {
        "variants": ["my_look_around", "my_stretch"],
        "min_interval_seconds": 8,
        "max_interval_seconds": 15,
        "chance": 1
      }
    }
  }
}

Turn in place keeps your body still while you look around, then turns it with a clip.

This is the turn in place of the example pack provided by Crafto, with the clip names changed to placeholders. Its bindings keep the 60 degrees, set look_idle_seconds to 0.25 so the body follows soon after your view rests, and give each step a companion clip:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "turn_in_place": {
        "enabled": true,
        "left": "my_step_left",
        "right": "my_step_right",
        "minimum_turn_degrees": 60,
        "look_idle_seconds": 0.25,
        "fade_out_seconds": 0.12,
        "left_overlay": "my_step_add_left",
        "right_overlay": "my_step_add_right"
      }
    }
  }
}

The body turns when the view is far enough off, when you held it still long enough, or when you start an action. Both step clips must have tracks for left_leg and right_leg and be longer than 0 seconds, or the feature stays off. The root rotation of the clip paces the turn. A clip without a root rotation turns the body over the whole clip, easing in and out, so the body turns as the feet step. The step clips of the example pack have no root track, so it turns this way. A left_overlay or right_overlay that is empty or not text drops the whole file.

Walking, sprinting and crouching

walking gives a clip per direction. A direction can be a clip name, an object with a clip, or a list of candidates that play by their when and weight expressions.

A candidate is an object with clip, an optional when (an expression that must hold) and an optional weight (an expression, 1 when left out). Two candidates with weights that cross over make a smooth blend between a slow and a fast walk:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "walking": {
        "directions": {
          "forward": [
            { "clip": "my_walk_slow", "weight": "1 - smoothstep(0.35, 0.65, limb_speed)" },
            { "clip": "my_walk_fast", "weight": "smoothstep(0.35, 0.65, limb_speed)" }
          ],
          "backward": "my_walk_backward",
          "left": "my_sidestep_left",
          "right": "my_sidestep_right"
        }
      }
    }
  }
}

One walk for two directions

The object form of a direction, and each candidate in a list, takes two more keys:

• reverse (true or false, false when left out) plays the clip backward on the walk’s clock, at the same pace, so one forward walk can also be the backward walk.
• add is the name of an extra clip that plays with the direction’s clip: on the same clock (backward too when reverse is set) and with the same weight, added on top of the walk. Use it for a sway or an accent made as a change from the walk pose.

Both also work on directions.sprint.forward and on the directions of crawling. This is the walk of the example pack provided by Crafto: one forward clip with a sway on top, played backward for the backward walk, and a stride that scales with your speed. The reference speed of 0.215 blocks per tick is about the game’s walking speed.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "walking": {
        "directions": {
          "forward": { "clip": "normal_forward", "add": "nf_add" },
          "backward": { "clip": "normal_forward", "reverse": true, "add": "nf_add" },
          "left": { "clip": "sidestep_left" },
          "right": { "clip": "sidestep_right" },
          "sprint": { "forward": { "clip": "normal_forward", "add": "nf_add" } }
        },
        "amplitude_reference_speed": 0.215,
        "max_amplitude": 1.2,
        "sprint_overlay": "sprint_add"
      }
    }
  }
}

Sprint stages

The sprint object can hold stages:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "walking": {
        "directions": {
          "forward": "my_walk_forward",
          "sprint": {
            "entry_loop": { "clip": "my_run_start_loop", "duration": 2, "blend_to_second_stage": 0.4 },
            "second_stage": { "clip": "my_run" },
            "rare_loop": { "clip": "my_run_rare", "chance": 0.01 },
            "stop": { "to_idle": "my_run_stop", "to_walk": "my_run_stop_walk", "minimum_speed": 0.08 }
          }
        }
      }
    }
  }
}

Crouching and other poses

The pose moments sit beside walking. Each takes clip (or pose) and many take idle, the standing clip that plays under the pose when you stop.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "crouch": { "clip": "my_crouch", "enter": "my_crouch_in", "exit": "my_crouch_out", "timer_scale": 1.45 },
      "fence": { "clip": "my_fence_hold" },
      "walk_on_water": { "clip": "my_wade" },
      "creative_fly": { "clip": "my_fly" }
    }
  }
}

In the example pack provided by Crafto, the crouch is one held pose: enter is its sneaking clip, additive is true and timer_scale is 1.45.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "crouch": { "enter": "my_sneak", "additive": true, "timer_scale": 1.45 }
    }
  }
}

The other sprint clips can also stand on their own as the actions run_start, run_stop, run_stage_transition and run_second_stage. run_stop takes the same to_idle, to_walk and additive as stop above. The example pack provided by Crafto gives both stops one clip and sets additive to true:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "run_stop": { "to_idle": "my_run_stop", "to_walk": "my_run_stop", "additive": true }
    }
  }
}

Expressions

A candidate’s when and weight, and the timer and blending fields of held actions, take a small expression written as text, such as "limb_speed <= 0.30". The functions are sin, cos (in radians), abs, sqrt, round, random(x), min(a, b), max(a, b), clamp(x, low, high), smoothstep(edge0, edge1, x) and lerp(t, a, b). A walking candidate can read limb_speed, crouch_modifier, sprint_weight, rare_run, sprint_elapsed, locomotion_phase, stride_distance, forward, backward, left, right and direction_weight. A file can also declare its own var.<name> numbers and varb.<name> switches under a root key variables. Compat files says what each one is.

Jumping, falling and landing

A jump tries a family of clips, best first. A sprinting jump tries running, then moving, then the plain left and right. A walking jump tries moving, then the plain sides. A standing jump tries idle, then the plain sides. In each family Moves tries the side that is due first, then the other side.

With a contact clip, the jump clip plays up to the moment whose pose is nearest the contact’s first frame (no later than landing_before_seconds) and waits there while you stay in the air. When you land before landing_before_seconds into the jump, the contact clip plays on top of what plays underneath, at full strength, in place of the landing clips, and the jump stops. A dive never plays it. Without any contact clip, the jump clip plays on and holds its last frame until you land, and then the landing clips play.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "jump": {
        "left": "my_jump_left",
        "right": "my_jump_right",
        "running": { "left": "my_hop_left", "right": "my_hop_right" },
        "moving": { "left": "my_walk_jump", "right": "my_walk_jump", "landing": "my_walk_jump_contact" },
        "landing": "my_jump_contact",
        "landing_before_seconds": 0.7
      }
    }
  }
}

The example pack provided by Crafto gives a sprinting jump its own hop clips, and gives the walking and the standing jump a contact clip, with landing_before_seconds at 0.7.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "falling": { "normal": "my_fall", "free_fall": "my_free_fall", "effect": "my_fall_effect", "trigger_distance": 5, "blend_in_response": 1.2 },
      "landing": { "light": "my_land", "medium": "my_land_medium", "heavy": "my_land_heavy", "heavy_distance": 8 }
    }
  }
}

The example pack provided by Crafto uses one squash clip for all three landings and adds it on top, so a small drop gives a small squash:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "landing": { "light": "my_squash", "medium": "my_squash", "heavy": "my_squash", "additive": true, "full_strength_distance": 5 }
    }
  }
}

Gliding and flying

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "elytra": {
        "normal": "my_glide",
        "high_speed": "my_glide_fast",
        "rotate": "my_glide_rotate",
        "firework_use": "my_firework_use",
        "firework_hold": "my_firework_hold",
        "high_speed_threshold": 0.9,
        "bank_degrees": 30
      }
    }
  }
}

Creative flight is the creative_fly pose in the section above.

Swimming and diving

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "swimming": {
        "surface": "swimming_overwater",
        "underwater": "swimming_underwater",
        "vertical": "swimming_vertical",
        "surface_body_depth": 0.12,
        "sprint_playback_multiplier": 1.25
      },
      "water_dive": { "air": "my_dive", "contact": "my_dive_pose", "loop": "my_dive_loop", "alternate_air": "my_cannonball", "alternate_loop": "my_cannonball_loop", "alternate_chance": 0.5, "trigger_distance": 3 },
      "lava_dive": { "pose": "lava_dive", "air_effect": "lava_dive_air_effect", "contact_effect": "lava_dive_effect" }
    }
  }
}

Sneaking in a dive

Sneaking during a dive picks a tuck, once per dive. Sneak within sneak_window_seconds of the dive’s start and the dive turns into sneak_air (a cannonball), with sneak_loop as its loop. Sneak later and it turns into late_sneak_air (a belly flop), with late_sneak_loop. A tuck plays no contact clip. If the tuck you picked has no air clip, the dive stays the plain dive.

A pack with sneak_air or late_sneak_air starts every dive as the plain dive, so it needs air (without air no dive plays), and it never uses alternate_air, alternate_loop or alternate_chance. The example pack provided by Crafto does this:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "water_dive": {
        "air": "my_dive",
        "loop": "my_dive_loop",
        "entry_blend_seconds": 0.45,
        "swim_blend_seconds": 0.6,
        "sneak_air": "my_cannonball",
        "sneak_loop": "my_cannonball_loop",
        "late_sneak_air": "my_belly_flop",
        "late_sneak_loop": "my_belly_flop_loop",
        "sneak_window_seconds": 0.3
      }
    }
  }
}

Video coming soon

The swimming recipe builds these from the first clip.

Climbing

climbing plays on ladders, vines and other climbable blocks. With timer_effect set to vertical_delta, one clip follows your vertical speed: it pauses when you stop, runs backward when you go down, and speeds up with your speed.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "climbing": {
        "clip": "climbing_up",
        "timer_effect": "vertical_delta",
        "timer_scale": 8,
        "camera": { "horizontal": 0, "vertical": 0.11, "depth": 2.34, "fov": 70, "response": 4 }
      }
    }
  }
}

Two different clips for up and down are their own actions, climb_up and climb_down, written beside each other and without a shared clip:

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "climb_up": "my_climb_up",
      "climb_down": "my_climb_down"
    }
  }
}

The Face the ladder switch, on by default, keeps the body on the ladder while you climb a ladder block.

Riding and sitting

passenger_state, mount_state and sitting_state read the same keys. They pick a pose by the vehicle or mount you sit on.

A file can hold many rules. passenger_state and sitting_state can be a list of rules. When two rules match one vehicle, the last one wins.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "passenger_state": {
        "entities": ["minecraft:nautilus", "minecraft:zombie_nautilus"],
        "idle": "idle_nautilus",
        "moving": "sprint_nautilus",
        "speed_threshold": 0.12,
        "camera": { "horizontal": 0.88, "vertical": -0.65, "depth": 3.91, "fov": 68, "response": 3.5 },
        "dynamics": { "rider_vertical_offset": 10, "bank_degrees": 28, "bank_sensitivity": 1.5, "vertical_tilt_degrees": 22, "response": 6 }
      },
      "sitting_state": {
        "entities": ["minecraft:boat", "minecraft:*_boat", "minecraft:*minecart"],
        "pose": "sit",
        "idle": "sit_idle"
      }
    }
  }
}

Video coming soon

The riding recipe walks through a full pack.

Held items

Held-item clips play for the arm that does the action. The main hand uses your main arm and the off hand your other arm. When a clip named <name>_left or <name>_right exists for that arm, Moves plays it, and otherwise the plain name. Clips are not mirrored for you. Only the music listening and map view poses mirror themselves for a left hand.

Each item belongs to the first group it matches. The group keys are MACE, FLINT, SHEARS, FISHING_ROD, EMPTY_BUCKET, FILLED_BUCKET, SWORD, PICKAXE, AXE, SHOVEL, HOE, TRIDENT, SPEAR, LANTERN, TORCH, HORNS, BOW, CROSSBOW, SHIELD, MAP, SPYGLASS, BRUSH, THROWABLE, CONSUMABLE and BUNDLE. Write a key in any case. Items outside every group match the key _. Exact items go under items with the full id, such as minecraft:trident. An id without its namespace never matches.

This is the sword group of the example pack provided by Crafto, with two attack clips that play as a combo:

{
  "format_version": 2,
  "item_groups": {
    "SWORD": {
      "animations": {
        "attack": {
          "variants": ["sword_attack_1", "sword_attack_2"],
          "retrigger_progress": 10,
          "locomotion_influence": { "walk": 0, "sprint": 0, "jump": 0 }
        },
        "mining": { "clip": "mine", "retrigger_progress": 50 },
        "hand_in": { "clip": "default_hand_in", "retrigger_progress": 50 }
      }
    }
  }
}

A tool can have a one-handed swing with its own overlays. In the example pack provided by Crafto, the axes use a pickaxe swing when your other hand holds something, with overlays to match:

{
  "format_version": 2,
  "item_groups": {
    "AXE": {
      "animations": {
        "attack": {
          "clip": "my_axe_swing",
          "one_handed": "my_axe_swing_one_hand",
          "overlays": [{ "clip": "my_axe_swing_add" }],
          "one_handed_overlays": [{ "clip": "my_axe_swing_one_hand_add" }]
        }
      }
    }
  }
}

A combo goes back to its first clip after more than a second without a swing, or when you change item.

Item sequences

A sequence gives an item a full cycle of phases that Moves runs from what you do. Sequences go on item groups and items, never on empty_hand.

The phases are equip, idle, charge, hold, release, slam, attack, use, cast, fishing and reel. Only attack takes variants. Anything unknown on a phase drops the file. A sequence combo goes back to its first attack after one and a half seconds. A bow looks like this:

{
  "format_version": 2,
  "item_groups": {
    "BOW": {
      "sequence": { "behavior": "bow", "charge_ticks": 20, "defaults": { "transition_seconds": 0.12 } },
      "animations": {
        "equip": "my_bow_equip",
        "idle": "my_bow_idle",
        "charge": "my_bow_draw",
        "hold": { "clip": "my_bow_hold", "hold_last_frame": true },
        "release": "my_bow_release"
      }
    }
  }
}

The item sequence recipe builds one step by step.

Combat

Plain swings use attack: in empty_hand for bare hands, in a group such as SWORD as above or an exact item, and in defaults for any item and for bare hands that have none of their own. More weapons have their own actions.

{
  "format_version": 2,
  "item_groups": {
    "SPEAR": {
      "static_when_using": true,
      "animations": {
        "spear": { "charge": "spear", "attack": "spear_lunge_var_1", "attack_ready_threshold": 0.9 }
      }
    }
  }
}

The mace uses a sequence. This is the mace of the example pack provided by Crafto, with a clip for the charge, the slam and two attacks. Each has its own one-handed clip. The sequence’s defaults set over_idle to true, so the charge, the slam and the attacks play on top of the last frame of the idle clip, the raised mace, and do not drop that pose:

{
  "format_version": 2,
  "item_groups": {
    "MACE": {
      "static_when_using": true,
      "sequence": { "behavior": "mace", "charge_height": 3, "smash_distance": 1.5, "defaults": { "over_idle": true } },
      "animations": {
        "equip": { "clip": "mace_idle" },
        "idle": { "clip": "mace_idle", "hold_last_frame": true },
        "charge": { "clip": "mace_charge", "one_handed": "mace_charge_alt" },
        "slam": { "clip": "mace_slam", "one_handed": "mace_slam_alt", "retrigger_progress": 85 },
        "attack": {
          "variants": [
            { "clip": "mace_attack_1", "one_handed": "mace_attack_alt_1" },
            { "clip": "mace_attack_2", "one_handed": "mace_attack_alt_2" }
          ]
        }
      }
    }
  }
}

Better Combat

With Better Combat installed, a pack can give its weapons’ attacks their own clips, with Better Combat’s timing. The Better Combat pack attacks row on the Features page chooses when that happens: each click steps through Automatic, On and Off. The choice is saved in config/punchy_moves/better_combat.json as mode.

The row shows Automatic as Automatic (ON) or Automatic (OFF), for what it is doing now.

A better_combat block goes in defaults, an item group or an item:

{
  "format_version": 2,
  "defaults": {
    "better_combat": {
      "attacks": ["my_slash_1", { "clip": "my_slash_2", "impact_time": 0.25 }],
      "animations": { "bettercombat:one_handed_slash_horizontal_right": "my_slash_wide" },
      "transition_seconds": 0.08
    }
  }
}

Timing belongs to Better Combat, so keys such as retrigger_progress do not belong in this block. An unknown key, a number written as text, or an id without a namespace drops the file.

Music listening

When a jukebox plays nearby and you stand still, your character listens. The pose ends when you keep walking on the ground for the movement stop delay (1 second by default), when you jump twice, swing twice or mine twice, or when you leave the jukebox’s range.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "music_listening": {
        "loop": "listening_song",
        "source": "active_jukebox",
        "radius": 12,
        "scan_interval_ticks": 10,
        "start_delay_seconds": 1,
        "movement_stop_delay_seconds": 1,
        "item_hand": "main_hand"
      }
    }
  }
}

Video coming soon

Map view

Hold a filled map in your main hand and look down, and your character lifts the map while the camera moves over it. The camera also moves over a filled map in your off hand, but the pose plays only for a map in your main hand. The Map third-person camera switch turns this on and off.

It sits in the MAP group. The map is not raised while you glide, swim, climb or ride. The example pack provided by Crafto starts the pose at 55 degrees and ends it at 18:

{
  "format_version": 2,
  "item_groups": {
    "MAP": {
      "animations": {
        "map_view": {
          "pose": "my_map_pose",
          "look_down_enter": 55,
          "look_down_exit": 18,
          "locomotion_influence": { "walk": 0, "sprint": 0, "jump": 0 }
        }
      }
    }
  }
}

Video coming soon

The world around you

These moments play from what happens to your character or where it stands. They all go in defaults.animations.

{
  "format_version": 2,
  "defaults": {
    "animations": {
      "cold": { "clip": "cold", "trigger_progress": 0.05, "reset_progress": 0.01 },
      "low_hunger": { "clip": "belly_loop", "food_level_at_most": 6 },
      "nausea": "my_dizzy_idle",
      "hurt_forward": "hurt_forward",
      "hurt_backward": "hurt_backward",
      "armor_helmet": "armor_in_helmet",
      "armor": "armor_in",
      "biome": {
        "temperature_max": 0.15,
        "pose": "cold_effect",
        "pose_layer": "fullbody",
        "event": "cold",
        "event_layer": "upperbody",
        "min_interval_seconds": 12,
        "max_interval_seconds": 28,
        "event_while_moving": true
      }
    }
  }
}

Emotes are clips that you start from the emote wheel or their own keys. They are on Keys and emotes, and a face can go with each one, as Face reactions shows.

Things that go wrong

• A feature camera does nothing. Its block needs all five numbers, with response above 0. A riding camera needs four, and a map camera fills in what you leave out. Check the switch on the Features page too.
• Orbit says “Enable the custom camera first”. Press V, then B.
• The custom camera is off in first person or in the front view. Minecraft’s perspective key (F5 by default) turns the custom camera off on its way through those views. The camera works in the back view.
• A whole compat file does nothing. One field the format does not accept drops the whole file. The game log has a line that contains Could not load animation compat and names the field. The reason at the end of that line is written in Portuguese, for example campo desconhecido for an unknown field. The usual causes: a format_version that is not 2, an action name that is not lower case letters, digits and underscores or does not start with a letter, a root key outside the allowed list, cameras with a key other than proximity and aiming, clip together with variants, turn_in_place with only one of left and right, or with a left_overlay or right_overlay that is empty or not text, overlays or one_handed_overlays that is not a list, a sequence on empty_hand or with an unknown behavior, and an unknown key in a better_combat block.
• A body moment never plays. Body actions are read from defaults only. A group or item that names one is not read for it.
• A held item never plays its clip. Item ids in items need their namespace, as in minecraft:trident.
• A clip never plays. Clip names are case-sensitive, and a name that no animation file defines is skipped without a message. An animation file with a root that is not an object is lost whole.
• Your changes to a pack do not show. Press F3+T to reload.

Related pages

• Getting started to install Moves and add a pack
• Keys and emotes for the emote wheel and every key
• Compat files for the whole format
• Animation files for the clips themselves
• Studio Game view to see a clip on your own player while you make it
• The walk cycle recipe, the swimming recipe, the riding recipe and the item sequence recipe
• Faces for the faces that react to all of this
• Troubleshooting and the FAQ