> For the complete documentation index, see [llms.txt](https://malbersanimations.gitbook.io/animal-controller/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://malbersanimations.gitbook.io/animal-controller/super-item/super-item-system/how-to.md).

# How To

Practical walkthroughs. Each one builds something end to end and names the mistakes people actually make.

Start with the melee weapon even if you want a gun — the first steps are the same, and the other guides assume you have read it.

***

## Building items

{% content-ref url="/pages/LMMfZJOuDUE176l3H3z1" %}
[Create a Melee Weapon](/animal-controller/super-item/super-item-system/how-to/create-a-melee-weapon.md)
{% endcontent-ref %}

{% content-ref url="/pages/8j0PCUkmtzujx0aEaECM" %}
[Create a Shootable Weapon](/animal-controller/super-item/super-item-system/how-to/create-a-shootable-weapon.md)
{% endcontent-ref %}

{% content-ref url="/pages/coGK935NMgweHpkUSMFY" %}
[Create a Charged Bow](/animal-controller/super-item/super-item-system/how-to/create-a-charged-bow.md)
{% endcontent-ref %}

{% content-ref url="/pages/rEwSb2lgYn09znYQE5oU" %}
[Block and Parry with a Shield](/animal-controller/super-item/super-item-system/how-to/block-and-parry-with-a-shield.md)
{% endcontent-ref %}

***

## Features

{% content-ref url="/pages/6KTZEGkBS99CJt6H98h3" %}
[Set up Dual Wielding](/animal-controller/super-item/super-item-system/how-to/set-up-dual-wielding.md)
{% endcontent-ref %}

***

## Fixing things

{% content-ref url="/pages/R0B4nbJ20PbpXESA9vzF" %}
[Fix Item Offsets](/animal-controller/super-item/super-item-system/how-to/fix-item-offsets.md)
{% endcontent-ref %}

***

## The four things that go wrong most often

**The item drops instead of holstering.** Its `Holster` ID has no matching holster on the character's Manager. The console names the missing ID in red.

**The item is inside the hand.** There is no offset entry for that (Item Type + Equip Point) pair, so the identity offset is used. See [Fix Item Offsets](/animal-controller/super-item/super-item-system/how-to/fix-item-offsets.md).

**A dual-wielded weapon does everything twice.** Enable **Primary Hand Only** on the Action. See [Set up Dual Wielding](/animal-controller/super-item/super-item-system/how-to/set-up-dual-wielding.md).

**A charge or a wait fills in steps.** The Action's **Update Rate** is not `0`. It throttles the `On Action Updated` processors, and time-based ones need every frame.

{% hint style="info" %}
Before pressing Play, use the **Validate** button on the Super Item. It walks every processor and reports missing references, impossible ranges and conflicting settings — including a few subtle ones, like a Delay on a Fire processor whose Power Stat is cleared on release.
{% endhint %}