> For the complete documentation index, see [llms.txt](https://wiki.chrisgraph.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.chrisgraph.fr/how-to-install/behaviorwatch/getting-start.md).

# Getting start

### Requirements

* **Paper/Purpur:** 1.21.4+
* **Java:** 21

### Installation

1. **Install**
   * Drop **BehaviorWatch-\<version>.jar** into /plugins/.
   * Restart the server.
2. **First start**
   * config.yml is created automatically.
   * Data is stored in /plugins/BehaviorWatch/data/ (one file per player).
3. **Permissions**
   * Only staff with behaviorwatch.admin can use commands or GUIs.
   * Optional: give behaviorwatch.ignore to exclude a player from tracking.
4. **Use**
   * Run /behavior to open the main GUI.
   * Click a player to open their profile.
5. **PlaceholderAPI (optional)**
   * If PlaceholderAPI is installed, BehaviorWatch registers its placeholders automatically.
6. **Reload config**
   * Use /behavior reload after editing config.yml.\
     Missing keys are merged without overwriting your values.

### Generated files

```
plugins/BehaviorWatch/
config.yml
data/
bStats/
```

**Details**

* config.yml → main configuration (auto‑created on first start)
* data/ → one YAML file per player (behavior data)
* bStats/ → bStats configuration (can be opted out)