> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurinfer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Choose which Minecraft game events your character is told about, such as chat, damage, players nearby, blocks broken and weather changes.

Events are the things that happen around your character in the game, like a player chatting, a mob attacking or night falling. Your character uses them to understand what's going on and decide how to react.

Open **Player → Behavior → Events** to see the **Event Listeners**. All events are on by default. When you turn an event off, your character isn't told when it happens. The page header shows how many events are disabled.

Changes save automatically and the page shows **Saving** and then **Saved**.

## Priority

Each event has a priority number from 1 to 8. When several events happen at once, lower numbers are handled first. The page groups events by priority:

* **High** (1): damage, chat and the character's own spawn and death.
* **Important** (3): failed actions.
* **Normal** (4 and 5): things nearby and finished actions.
* **Low** (6): regular scans and block changes.
* **Passive** (7 and 8): environment and background information.

You can't change an event's priority, only turn it on or off.

## All events

| Priority | Event | When it happens |
| - | - | - |
| 1 · High | **Player Chat** | A player sends a message in chat |
| 1 · High | **Player Interact** | A player right-clicks or interacts with the character |
| 1 · High | **Player Damage** | A player attacks the character |
| 1 · High | **Mob Attack** | A mob damages the character |
| 1 · High | **Bot Spawn** | The character spawns or respawns |
| 1 · High | **Bot Death** | The character dies |
| 3 · Important | **Action Failed** | An action the character tried fails |
| 4 · Normal | **Player Approach** | A player comes within range |
| 5 · Normal | **Item Nearby** | A dropped item is spotted nearby |
| 5 · Normal | **Mob Nearby** | A mob is spotted in range |
| 5 · Normal | **Action Success** | An action finishes successfully |
| 6 · Low | **Vision Update** | A regular scan of its surroundings, inventory, nearby entities and blocks |
| 6 · Low | **Block Broken** | A block is mined nearby |
| 6 · Low | **Block Placed** | A block is placed nearby |
| 7 · Passive | **Player Leave** | A player moves out of range |
| 8 · Passive | **Time Change** | Day turns to night, or night to day |
| 8 · Passive | **Weather Change** | Rain, thunder or clear weather starts |

## Tips

* **Keep the High events on.** Without **Player Chat**, your character can't see what players say to it. Without the damage events, it may not notice it's under attack.
* **Keep Vision Update on** unless you have a reason to turn it off. It's how your character keeps track of its surroundings and inventory.
* **Turn off Passive events** if your character comments on the time or weather more than you'd like.
* **Turn off Block Broken and Block Placed** on busy servers where lots of building happens around your character.

To control what your character does in response, use [Actions](https://docs.aurinfer.com/Integrations/Minecraft/actions.md) and your [Player Engine instructions](https://docs.aurinfer.com/Integrations/Minecraft/player-engine.md#instructions).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.