Voxel Shop beta is live. Expect occasional bugs. Learn more
Animated arms in first-person.
Armature now has its own first-person rendering and animation engine. Animate each hand independently, build two-handed poses, or give a weapon charm its own motion. The native renderer is the default on new installations and runs without BetterModel or a client mod.
To enable the native renderer, open config.yml and replace backend: bettermodel by backend: native.
PLEASE READ THE DOCS FOR MIGRATION.
The examples below use the native renderer. File paths are relative to plugins/Armature/. If you already have a profile for the item, merge the example fields into that profile. Model names refer to files in models/ without the extension, and animation names must match clips in the model. Apply profile and model changes with /armature reload all
arms: both for actions like a two-handed reload, and add a _offhand clip when the pose should differ in the other hand. The main hand takes priority when both request control of both arms./arm settings. Camera movement leaves gameplay aim unchanged.This profile uses a WeaponMechanics weapon titled m4a1 and a custom rifle_demo.armature model with an idle loop and a reload clip. The reload takes over both arms. To author a different offhand pose, add reload_offhand to the model and keep name: reload in the profile.
# profiles/rifle-demo.yml
rifle_demo:
match:
item: weaponmechanics:m4a1
model:
name: rifle_demo
animations:
movement:
- animation: idle
actions:
- trigger: weaponmechanics:reload-start
animation:
name: reload
arms: both
blend-in: 2t
blend-out: 3tUse mode: source to keep the active resource pack's bow draw stages while Armature animates the arm. This example uses generic.armature from the default assets. Switching to mode: static keeps the resting bow visual throughout the draw.
# profiles/bow-demo.yml
bow_demo:
match:
item: minecraft:bow
model:
name: generic
held-item:
mode: source
animations:
movement:
- when: item.using == true
animation:
name: bow_draw
start: bow_draw_start
- animation: bow_idle.armature v2 format for Blockbench. Assign body, held-item and camera roles directly to bones. Flag individual bones or chains for spring motion driven by acceleration and turns. The separate Blockbench extension provides a starter rig and previews for items from vanilla assets or a resource-pack ZIP..bbmodel support. Load compatible models alongside .armature assets. Native profiles can use clip names such as idle, walk and jump as ordinary animation names. Legacy .bbmodel models retain automatic offhand mirroring.variables.yml definitions can read constants, PlaceholderAPI, provider values or the Java API.Create star_charm.armature and a charm_socket bone in charm_sword.armature. The sword model needs an idle clip. The star_charm attachment profile can be mounted by other item profiles. This mount shows the charm only to players with cosmetics.charm.star. Mark a bone in the charm model for physics to make it swing.
# profiles/charm-demo.yml
star_charm:
type: attachment
model:
name: star_charm
physics:
damping: 0.8
charm_sword:
match:
item: minecraft:diamond_sword
model:
name: charm_sword
attachments:
charm:
profile: star_charm
attach-to:
bone: charm_socket
when:
permissions:
all: [cosmetics.charm.star]
animations:
movement:
- animation: idleHold the pickaxe in your main hand. block.mining switches between idle and mining, and block:mining-start plays the first swing. The mining-speed variable controls the loop's playback speed. All three clips are in the default generic.armature model.
# variables.yml
variables:
mining-speed:
type: number
source: constant
value: 1.25# profiles/mining-demo.yml
mining_demo:
match:
item: minecraft:diamond_pickaxe
model:
name: generic
animations:
movement:
- when: block.mining == true
animation:
name: pickaxe_mining
speed: variable.mining-speed
- animation: tool_idle
actions:
- trigger: block:mining-start
animation: pickaxe_block_damagepacket-mask for hand hiding with Iris. Shader-driven camera rotation, FOV lock, Y-lock and anti-clipping depend on Armature's shaders.core-shaders, which hides the vanilla first-person hand and item while keeping the real item in the client slot. packet-mask remains available for servers that need packet-based hiding.Minecraft 26.3 changed first person hand projection depth core-shaders, so only packet-mask would work.
# config.yml
render:
vanilla-hiding:
mode: packet-mask/armature reload with config, profiles, models, pack, providers or all. Inspect live profile selection, run preflight checks with /armature diagnostics doctor, view startup and pack timings, or export a sanitized support bundle./armature animation play <player> <model> <animation>. Set persistent per-player profile opt-outs through commands or permissions.render.backend: native and restart to switch to the new engine.plugins/Armature/ and keep your customized files. Existing compatible .bbmodel assets can still be used.config.yml settings. Move profile-local variable declarations into variables.yml. Legacy profiles remain loadable, and /armature config migrate <file> creates a validated modern copy locally. Update scripts to use the new command paths and pass a model ID to /armature animation play./armature reload all after installing models or profiles, or /armature reload pack for a pack-only rebuild. If a provider delivers the pack, regenerate its final pack too so players receive the updated assets and shaders together.Download the latest Blockbench plugin in the discord channel.
You can now import models and animations from Punchy and TACZ from their official JARs and use them inside your Armature profiles.
Use Armature Client 0.9.5-preview for optional local rendering with Armature 2.0.0. This client uses protocol 10, supports the server's camera movement intensity setting and opens its rendering options from /arm settings.
Fixed
Changes
empty_hands:
additive:
enabled: true
reference:
animation: base
time: 0.0
disable-procedural-bob: true
layers:
idle:
animation: add_breathing
mode: loop
group: locomotion
blend-in: 0.08
blend-out: 0.12
channels: [position, rotation]
when:
moving: false
sneaking: false
walk:
animation: add_bobbing
mode: loop
group: locomotion
speed: 1.0
weight: 1.0
blend-in: 0.08
blend-out: 0.12
channels: [position, rotation]
when:
moving: true
sprinting: false
sprint:
animation: add_bobbing
mode: loop
group: locomotion
speed: 1.2
weight: 1.0
blend-in: 0.08
blend-out: 0.12
channels: [position, rotation]
when:
moving: true
sprinting: truetrue)m4a1:
item:
material: minecraft:paper
data:
custom-model-data: 12001
item-model: "myplugin:rifle"
pdc:
"myplugin:weapon-id": m4a1
"myplugin:rarity":
type: string
value: legendary
tags:
CustomTag: m4a1
"@weapon.type": rifle
model: fp_rifle
animations:
idle: baseswing:
name: [swing, swing_1, swing_2]
selection: sequence
# selection: randomsequence plays the animations in order.
random plays animations randomly.
This is the first version of Armature, the best it has ever been since the start of development, and it will never stop getting better.
Thank you for your patience and support!