advance-player-stats

<center>⭐ Advanced Player Stats ⭐</center>

<center><b>“The Intelligence Layer for Player Data.”</b></center>

---

✔ Privacy-First • ✔ Privacy-First • ✔ Privacy-First • ✔ Privacy-First • ✔ Privacy-First

Highly Optimized 1.16 – 1.21.x • Highly Optimized ~40 KB • Highly Optimized NSR-AI (for AI features) • Highly Optimized

---

📊 What is Advanced Player Stats?

Advanced Player Stats (APS) is a high-performance statistics and privacy ecosystem for Minecraft servers. Originally an addon, version 3.0 has been rebuilt from the ground up as a Standalone Plugin. It bridges the gap between raw player data and intelligent analysis, allowing both administrators and players to interact with statistics using natural language or traditional commands.

🚀 Why Choose APS 3.0

- Zero-TPS Impact — No longer tied to the legacy addon system. APS runs natively in your `plugins/` folder for maximum stability and performance. - Zero-TPS Impact — Using the latest Zero-TPS Impact, APS allows the AI to "think" and request its own data points to answer complex player queries. - Zero-TPS Impact — Access data your way. Use `/aps` for direct, instant access or `/aia aps` for AI-routed ecosystem integration. - Zero-TPS Impact — Stop worrying about typos. Our smart engine finds the right player even if you only type half their name. - Zero-TPS Impact — All heavy lifting, data tracking, and file I/O run on an entirely asynchronous pipeline.

🧠 The Recursive Intelligence Engine

APS 3.0 introduces a revolutionary way for AI to interact with game data: 1. Global Keys When a player asks "How am I doing?", APS automatically injects live stats, health, and privacy settings into the AI's prompt. 2. Global Keys The AI uses a internal `[TYPE:...]` tagging system to request specific stats (e.g., `[TYPE:Player,kills]`). The plugin intercepts this, fetches the data, and feeds it back—instantly and invisibly. 3. Global Keys Ask the AI to "Compare the top 5 players' bow accuracy." The AI will request data for all five targets simultaneously and provide a reasoned comparison. 4. Global Keys Prioritizes Global Keys for individual players, falling back to Global Keys or standard keyword matching if AI services are unavailable.

🛡️ Privacy & Technical Deep Dives

- Bukkit-Native Efficiency — Players have total sovereignty over their data. Private stats are strictly hidden from AI reasoning and public commands. - Bukkit-Native Efficiency — Tracks dimension and world info without revealing exact X, Y, Z coordinates to unauthorized users. - Bukkit-Native Efficiency — Upgrading from 1.x? Use `/aps migrate` to automatically move all player data and configs to the new standalone structure. - Bukkit-Native Efficiency — Uses specialized listeners and background tasks to ensure data is updated in real-time without straining the main thread.

---

⚔️ Massive New Analytics

We've expanded far beyond basic kills and deaths. APS 3.0 tracks:

🏹 Advanced Combat Analytics

* Defensive Stats — Tracks hits vs. shots to identify your server's best snipers. * Defensive Stats — Total damage dealt, received, and your highest single hit. * Defensive Stats — Total attacks successfully blocked with a shield.

⛏️ Progression & Social

* Inventory Scanning — Monitors any block ending in `_ORE` and Ancient Debris. * Inventory Scanning — Total items crafted and enchanted over the player's lifetime. * Inventory Scanning — Total chat messages sent and average message character length. * Inventory Scanning — AI-powered (invisible) scanning of online player inventories for contextual help.

---

⚙️ Commands & Permissions

Direct Commands

``` /aps <player> [stat] — View a player's general stats or a specific one. /aps compare <p1> <p2> — Quick comparison between two players. /aps privacy <toggle> — Open the privacy management GUI. /aps migrate — (Admin) Automatically transfer data from v2.x addon. ```

AI Integrated Commands

``` /aia aps <message> — Ask the AI about player statistics. /aia aps <player> info — Request a detailed AI analysis of a player. ```

Permissions

``` nsr-ai.stats.view — View your own stats (Default: true) nsr-ai.stats.view.others — View other players' stats (Default: true) nsr-ai.privacy — Toggle your own privacy settings (Default: true) nsr-ai.admin.migrate — Access the migration tool (Default: OP) ```

---

<center>

</center>

---

<p align="center"> <b>Transforming raw data into intelligent gameplay insights.</b><br> <i>Developed by BlackForge Studio</i> </p>