⭐ Advanced Player Stats Addon

An addon for NSR-AI that adds advanced player statistics and privacy controls.

---

✔ In-Depth Stats • ✔ Per-Player Privacy • ✔ AFK Tracker

---

⚙ Core Features

• In-Depth Player Statistics — Track a wide range of player stats, including playtime, kills, deaths, blocks mined, and more.
• Per-Player Privacy — A comprehensive privacy system that allows players to control who can see their stats.
• AFK Tracker — Automatically detects when a player is AFK and notifies administrators.
• Natural Language Commands — Use more natural and intuitive commands to interact with the addon.
• "Did you mean?" for Player Names — Corrects spelling mistakes in player names to make commands easier to use.

Available Stats

• playtime - Total time played
• health - Current health points
• hunger - Current hunger level
• deaths - Total number of deaths
• kills - Total number of kills
• kd - Kill-death ratio
• blocks_mined - Blocks mined by player
• blocks_placed - Blocks placed by player
• distance_traveled - Total distance traveled
• streak - Current PvP kill streak
• afk - Is the player AFK?
• afktime - Total time spent AFK
• location - World name & dimension (or last seen if offline)

How to Install

1. Download the latest version of the addon.
2. Place the NSR-AI-Advanced-Player-Stats.jar file in the plugins/NSR-AI/addons directory.
3. Restart your server. The addon will create its default configuration file and be ready to use.

Dependencies

• Required:
  • NSR-AI: This addon requires the main NSR-AI plugin to be installed and enabled.
• Optional:
  • PlaceholderAPI: Allows you to use the stats from this addon in other plugins.

Commands

/ai stats <player> - Shows all stats for a player.
/ai <stat> <player> - Shows a specific stat for a player.
/ai privacy <player> <feature> [on|off] - Toggles a privacy setting for a player.
/ai help stats - Shows a list of all player data commands.

# Irregular Command Examples
/ai kills by ansh
/ai ansh deaths
/ai what is the playtime of ansh
/ai show me the location of ansh

Permissions

nsr-ai.stats.view — Default: true
nr-ai.stats.view.others — Default: true
nsr-ai.privacy — Default: true
nsr-ai.admin.privacy — Default: OP
nsr-ai.admin.privacy.bypass — Default: OP

Example Configuration (privacy.yml)

default:
  health: true
  hunger: true
  deaths: true
  kills: true
  kd: true
  blocks_mined: true
  blocks_placed: true
  distance_traveled: true
  playtime: true
  afk: true
  streak: true
  location: true
  stats: true

afks:
  kick-timer: 8

Directory Tree

plugins/
└── NSR-AI/
    └── addons/
        ├── NSR-AI-Advanced-Player-Stats.jar
        └── NSR-AI-Advanced-Player-Stats/
            ├── playerprivacy/
            │   └── <player_name>-<uuid>.yml
            └── privacy.yml

Update delayed due to technical and hardware-related issues.

---

Need help or found a bug? Comment below & I’ll respond ASAP!