> For the complete documentation index, see [llms.txt](https://corvus.gitbook.io/armature-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://corvus.gitbook.io/armature-docs/introduction.md).

# Introduction

Armature 1.3.0 is a first-person presentation engine for Paper and Folia. It binds a BetterModel rig to the item held by a player, evaluates movement and event rules, and renders finite actions, persistent loops, and additive pose layers.

Armature controls presentation only. It does not own item stacks, ammo, reloads, damage, projectiles, cooldowns, mana, or gameplay cancellation. Those responsibilities stay with Minecraft and the gameplay/provider plugin.

## Requirements

* Paper or Folia using the 1.21.8 API line or newer, with a Java 25 runtime.
* [BetterModel](https://modrinth.com/plugin/bettermodel), required for model rendering.
* [PacketEvents](https://modrinth.com/plugin/packetevents), required by the first-person input and client presentation path.
* A client that accepts the generated Armature resource pack.

Optional providers and integrations are detected at startup:

* Item identity: WeaponMechanics, QualityArmory, ItemsAdder, CraftEngine, and Nexo.
* Action provider: WeaponMechanics.
* Automation/API integrations: Skript, MythicMobs, and Denizen.

Install the optional plugin before starting Armature when its item identities, events, or scripting syntax are required. Armature remains presentation-only when an optional plugin is absent.

## Start here

1. Import a model into `plugins/Armature/models/`.
2. Create a modern profile in `plugins/Armature/profiles/`.
3. Match the real item identity and set `model.name`.
4. Bind movement, action, and additive rules under `animations`.
5. Run `/armature reload` and apply the generated resource pack.

The [Profiles](/armature-docs/getting-started/profiles.md) page contains the complete modern YAML shape. [Built-in conditions](/armature-docs/getting-started/profiles/conditions.md) and [Built-in triggers](/armature-docs/getting-started/profiles/triggers.md) list the full runtime vocabulary.

## What changed in 1.3.0

The 1.3.0 line adds:

* modern anonymous profile rules with typed variables, conditions, variants, movement transitions, additive blending, and provider namespaces;
* a channel-aware public Java API with lifecycle events, handles, snapshots, catalogs, and bounded typed signal data;
* bundled Skript, MythicMobs, and Denizen adapters;
* expanded WeaponMechanics fire, aim, reload, firearm-state, and fire-mode signals;
* deterministic and optional AI-assisted legacy-profile migration;
* live Paper Dialog bone editing with persistent profile/item overrides;
* generated anti-clipping, viewmodel FOV lock, viewmodel Y lock, and optional camera-rotation resource-pack paths;
* safer Folia/player lifecycle recovery while keeping the BetterModel carrier mounted on the owning client.

See [Supported plugins](/armature-docs/advanced/supported-plugins.md) for provider details and [Public API](/armature-docs/advanced/public-api.md) for integration code.

<div align="left"><figure><img src="https://3676679775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcWT3onsbt69DlAqumqZ%2Fuploads%2FZNI1ayFXay2GtZUssKg2%2FMinecraftNeoForge_1.21.11-Multiplayer3rd-partyServer2026-08-1111-59-57-ezgif.com-optimize.gif?alt=media&amp;token=2fa24cce-17f9-462d-87f9-02b5f8690e97" alt=""><figcaption></figcaption></figure> <figure><img src="https://3676679775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcWT3onsbt69DlAqumqZ%2Fuploads%2FzeD6YLMXkNT2UctS2irk%2FMinecraftNeoForge_1.21.11-Multiplayer3rd-partyServer2026-08-1111-59-37-ezgif.com-optimize.gif?alt=media&amp;token=c3b969ec-c12c-4489-9afb-a4882e98dca8" alt=""><figcaption></figcaption></figure></div>