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

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)

Last updated