> 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.md).

# BehaviorWatch

:thumbsup: **Download this plugin on** [**BuiltByBit**](https://builtbybit.com/members/chris-graph.151148/)

#### ✅ Features

* Behavior profiles per player with dominant type + % breakdown
* Session/Week/Month periods with automatic rotation
* Change detection vs previous week/month
* Staff GUIs: main list + player profile
* Offline support (last known name/UUID + heads when possible)
* PlaceholderAPI expansion (soft‑depend)
* bStats included (id 29277; opt‑out via bStats config)
* Async saves with snapshot safety, no heavy tick loops

#### ⚙️ How it works

* Tracks events: block place/break, combat, pickups, container opens, movement, chunk visits, AFK time.
* Scores are added per category and converted into percentages.
* Dominant type is chosen by highest % (configurable thresholds).
* Period rotation uses stored week/month keys to survive restarts.
* Tracking is skipped for ignored gamemodes or [behaviorwatch.ignore](https://file+.vscode-resource.vscode-cdn.net/c%3A/Users/chris/.vscode/extensions/openai.chatgpt-0.4.69-win32-x64/webview/#) permission.