Voxel Shop beta is live. Expect occasional bugs. Learn more  
Armature icon

Armature 2.0.0

Animated arms in first-person.

Page 1
2.0.0 14 days ago
Armature 2.0.0 : Native Model Rendering (Biggest Update)

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


First-person rendering

  • Independent hands and two-handed animations. The main hand and offhand can each have a model, item and animation. Use 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.
  • Smoother hotbar transitions. An outgoing model can finish its unequip animation while the new one equips. It keeps its own displayed item during the transition. Switching back mid-animation can blend from the current pose.
  • Player skins and equipment. Native rigs support classic and slim skins, skin outer layers, rigid or articulated limbs, and equipment overlays with leather dyes, armor trims and mapped custom armor. Skin changes from SkinsRestorer can refresh the presentation in game.
  • Animated camera and secondary motion. Drive visual camera rotation from a model bone and tune sway, bob, and spring motion. Players can set their own camera movement intensity with /arm settings. Camera movement leaves gameplay aim unchanged.
  • Held-item control. Keep the item's original look, select a fixed visual, or choose models based on use state and elapsed use time. Profiles can give a shield, bow or trident different poses and visuals as it is used. Movement and action rules can also control when the vanilla hand is hidden.

Animate a reload with both hands


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: 3t

Keep the bow's draw stages


Use 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

Models, profiles and animations

  • Native .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.
  • Legacy .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.
  • Reusable attachments and variants. Mount separate models on named bones and select them through conditions. Accessories can have their own animations, cooldowns, transforms and physics, so a scope or charm can be reused across profiles.
  • More control over animation rules. Configure blend-in and blend-out times and drive speed, cooldowns, blend times or additive weights with expressions. Shared variables.yml definitions can read constants, PlaceholderAPI, provider values or the Java API.
  • More precise input. Differentiate attacks aimed at air, blocks or entities. Trigger right-click animations in air and use mining start, stop and elapsed time to drive mining animations.

Mount a charm on a model


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: idle

Loop a pickaxe animation while mining


Hold 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_damage

Resource packs and performance

  • Minecraft Java 26.3 support. A dedicated pack overlay adapts rendering, transparency and camera shaders to 26.3 while retaining the 1.21.8 minimum. On 26.3, native skin, armor and ordinary held-item meshes preserve their visible texture colors when Iris bypasses Armature's core shaders. Use packet-mask for hand hiding with Iris. Shader-driven camera rotation, FOV lock, Y-lock and anti-clipping depend on Armature's shaders.
  • Shader-based hand hiding. New installations default to 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.
  • Updated CraftEngine, ItemsAdder and Nexo integrations. Pack merging preserves provider metadata and respects versioned overlays. Nexo builds held-item variants in its pack pipeline, with improved support for provider item states and special models.
  • More control over pack builds. Configure build triggers, version bounds, file exclusions, collision policies, validation and ZIP compression. A failed build can preserve the previous working pack. Compatible consoles show progress during generation.
  • Less work during generation and rendering. Pack builds reuse unchanged assets, generate body-part assets only for roles used by loaded models, and share identical 26.3 marker textures. The native renderer tracks changed display transforms so it can skip redundant updates.

Hide the vanilla hand on Minecraft 26.3


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

Server administration and integrations

  • Targeted reloads and diagnostics. Use /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.
  • Improved in-game editing and playback. The bone editor adds undo, redo, mirroring, exact numeric transforms and YAML export. Play a clip from any loaded model with /armature animation play <player> <model> <animation>. Set persistent per-player profile opt-outs through commands or permissions.
  • Expanded Java API. Open and close temporary player presentations, or play a clip from a loaded model without a matching item profile. Plugins can also register pack sources and exclusions, and inspect pack conflicts and publication state. WeaponMechanics and the bundled Skript, MythicMobs and Denizen integrations remain available.

Upgrading from 1.3.0


  1. Update the server dependencies. The supported baseline is Paper 1.21.8 through 26.3, Java 25 and PacketEvents 2.14.0. If you keep the optional BetterModel backend, use BetterModel 3.5.0.
  2. Choose your renderer and restart. The upgrade preserves an explicit backend selection. Set render.backend: native and restart to switch to the new engine.
  3. Install the assets you want to use. Default models and profiles are distributed separately in the Discord server. Extract it into plugins/Armature/ and keep your customized files. Existing compatible .bbmodel assets can still be used.
  4. Review configuration and profiles. Startup backs up and migrates known 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.
  5. Rebuild and redistribute the pack. Run /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.

Blockbench plugin


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.


Optional Fabric mod


Download here


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.

1.3.0 Sep 1, 2026
Triggers & Conditions

Fixed

  • Fixed Folia thread errors.
  • Fixed teleportation in different worlds breaking the plugin.
  • Fixed core-shader model marking.

Changes

  • Fully reworked the profiles structure, use `/armature migrate-config <profile> [--output <output_name>]` to update your old profile files.
  • Added Triggers and Conditions-driven animations.
  • Added full **Skript**, **MyhticMobs **and **Denizen **support.
  • Added complete public API.
  • Added a core-shader to stick the model position to the screen.
  • Added an in-game bone editor.
  • Added sounds and particles support in animations.
1.2.0 Aug 17, 2026
Additive Animations + Anti-Clipping Shader + Important Fixes

New

  • Added additive animation layers based on player state: idle, walk and sprint.
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: true
  • Added additive events with loop, hold and once modes.
  • Added automatic loading of additive animations from Blockbench `.bbmodel` files.
  • Added public animation API and `/armature play <player> <profile> <animation>`.
  • Added Skript animation integrations.
  • Added a core-shader that prevents hands model from clipping through blocks. (this can make your resource pack heavier)
  • Added a configuration fixed-FOV core-shader.

Configuration

  • Added the `additive` YAML section with:
    • reference animations
    • state-based layers
    • additive events
    • groups and priorities
    • blend-in and blend-out
    • speed and weight
    • position and rotation channels
    • per-axis gains
  • Added `can-be-cancelled` for actions that must finish before being replaced. (default to true)
  • Added structured item matching with `material`, `custom-model-data`, `item-model`, `pdc` and `tags`.
    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: base

  • Added `render.server-anchor-sync-interval-ticks`.

Skript

  • Added `play armature animation "inspect" for player`.
  • Added `play armature animation "inspect" from profile "m4a1" for player`.
  • Added `play armature action "fire" for player`.
  • Added `start armature loop "aim" for player`.
  • Added `stop armature action for player`.
  • Added `send armature signal "skript:weapon.pistol.fire" to player`.
  • Added the `on armature animation complete` lifecycle event.
1.1.3-Patch Aug 13, 2026
Patches from 1.1.3 changes
  • Fixed arms model not appearing when spawning in world
  • Fixed arms model visually detaching from player after unequip
1.1.3 Aug 13, 2026
Fixes
  • Armature models are now fully client-side
  • Fixed Armature preventing TP in some scenarios
1.1.2 Aug 11, 2026
Important patches + Animations Variations

New

  • Introduced animation variations per action: one action can support multiple animations.
swing:
name: [swing, swing_1, swing_2]
selection: sequence
# selection: random

sequence plays the animations in order.


random plays animations randomly.


Fixes

  • Fixed empty hands mask item override real items in inventory
  • Fixed vanilla hand reappearing when opening containers
  • Fixed empty hands mask item messing with some plugins
  • The arms are now invisible when the player is invisible or while doing a BetterModel player animation
1.1.0-Fix Aug 11, 2026
Nexo external pack + fix bbmodels
  • Added Nexo external pack support
  • Fixed some bones in default BBModel files
1.1.0 Aug 11, 2026
Paper-only + folia support
  • Made Armature a Paper-only plugin (won't work on Bukkit or Spigot servers)
  • Added Folia support
  • Fixed default assets not installing
1.0.0 Aug 10, 2026
1.0.0 RELEASE

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!

Page 1
Sign in
$9.99 USD
Sign in to purchase, save this product to your cart, and keep downloads tied to your account.
Stripe

armature

animations

item

advanced

better

fancy

fpv

first

person

smooth

viewmodel