> 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/basic-setup-instructions/creating-a-new-item/adding-buffs-debuffs-to-items.md).

# Adding Buffs/Debuffs to Items

## Overview

Introduced in v1.3, buffs/debuffs on items are a great way to expand the use of your items, and it's all done via reactions:\ <br>

<figure><img src="/files/9qvB6vFp2wyH5DwlgOqD" alt=""><figcaption></figcaption></figure>

Out of the box, it supports any reaction that comes via Animal Controller + there are a few additional ones added into the Inventory Add-On such as Increase Weapon Damage, Crit Chance Increase etc.

To use the buffs/debuffs, you need to ensure you set them up in the correct order.

Let's take the axe above as an example. \
\
In the equip reaction, you **MUST** equip first, THEN add your buffs on equip. This is because the buffs cannot apply before you have equipped.\
\
For the other reactions like Remove/Drop - you need to use your debuffs **FIRST** then call your Remove/Drop Reactions. See the image above for examples.

Also introduced in v1.3 is a way to display these buffs/debuffs to the player:<br>

<figure><img src="/files/NxpaND6enx0i0QL5RC24" alt=""><figcaption></figcaption></figure>

At the bottom of the Reactions Tab on the item, there is now a Buff/Debuff Description text area. You can add in your additional buff/debuff information here:\ <br>

<figure><img src="/files/66PHDaE5T193VCuSXIbR" alt=""><figcaption></figcaption></figure>

As you can see in the example, this supports basic text formatting such as \<color> tags. \
You may want to use \<color=red> for debuffs for example.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://malbersanimations.gitbook.io/animal-controller/basic-setup-instructions/creating-a-new-item/adding-buffs-debuffs-to-items.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
