Advanced Player Stats v3.0 - Changelog & Description

🚀 Overview

Version 3.0 is a complete ground-up refactor of Advanced Player Stats (APS). This update transforms APS from a simple addon into a Standalone Plugin Integration, offering deep compatibility with the NSR-AI API 3.0-pre architecture while providing its own direct command system.

---

🆕 What's New in 3.0

1. New Plugin Architecture

APS is now a standalone plugin. It no longer relies on the legacy addon.yml system and can be installed directly into your server's main plugins folder. This ensures better stability, faster loading, and native support for all Bukkit/Spigot features.

2. Dual-Command System

You now have two powerful ways to access statistics:

• Direct Access: Use /aps <player> [stat] (or aliases like /playerstats) to view data instantly.
• AI Integration: Use /aia aps <player> [stat] for native routing through the NSR-AI ecosystem.
• Both methods feature a new Fuzzy Matching Engine that finds players even if you only type part of their name!

3. Smart AI Injection & Recursive Reasoning (Requires NSR-AI)

The /aps command now supports natural language queries with a powerful new recursive querying system!

[!IMPORTANT] NSR-AI is strictly required for all AI-based tasks. Natural language generation and automated context processing will not function without the core NSR-AI plugin and a valid API key.

• Recursive AI Reasoning: The AI is equipped with a hidden [TYPE:...] tagging system. If it needs more context to answer your question, it will internally request specific stats (like [TYPE:PlayerName,kills]). The plugin intercepts this, fetches the live data, and feeds it back to the AI—all instantly and invisibly to the user!
• Multi-Player Comparisons: Thanks to multi-tag support, the AI can effortlessly compare multiple players (5, 10, 20+) at once by requesting data for multiple targets simultaneously in a single thought process.
• Contextual Awareness: When you ask a question like /aps am I doing well?, the plugin automatically injects your live stats and privacy settings into the AI's prompt.
• Intelligent Fallback: It attempts to use your Personal API Key first, then falls back to the Global Key. If NSR-AI is not present or configured, the plugin will fallback to standard keyword matching.

4. Modern API 3.0-pre Integration

• Native Registration: Automatically syncs with NSR-AI using the latest v3.0-pre programmatic standard.
• Smart Versioning: Built-in safety guards that automatically detect and adapt to your server's NSR-AI version.
• Optimized Performance: All data tracking and file operations now run in the background, ensuring zero impact on server TPS.

5. Enhanced Privacy & Features

• Complete Privacy Overhaul: Players now have total control over their data visibility. Private stats are strictly hidden from /aps and /aia commands.
• New Stats Tracked: Full support for real-time Health, Hunger, Playtime, AFK records, and PvP Kill Streaks.
• Smart Location: Privacy-safe location tracking that intelligently shows world info without revealing exact coordinates.

---

📊 New Stats Added in v3.0!

We've massively expanded our tracking capabilities. In addition to the classic stats (Health, Playtime, K/D, etc.), the AI can now track and analyze:

⚔️ Advanced Combat Analytics

• 🏹 Bow Accuracy (Tracks Hits vs Shots to find the best sniper!)
• 🎯 Crossbow Accuracy (Tracks Hits vs Shots specifically for crossbows)
• 💥 Total Damage Dealt (Total amount of damage dealt to other entities)
• 🤕 Total Damage Taken (Total amount of damage received)
• 🔥 Highest Single Hit (The highest damage dealt in a single strike)
• 🛡️ Shield Blocks (Total number of attacks successfully blocked with a shield)

⛏️ Expanded Progression

• 💎 Valuable Ores Mined (Tracks any block ending in _ORE and Ancient Debris)
• 🛠️ Items Crafted (Total number of items crafted in a crafting table)
• ✨ Items Enchanted (Total number of items enchanted)

☠️ PvE & Movement

• 🧟 Mob Kills (Kills specifically against monsters, separated from PvP)
• ☠️ Death By Player (Times killed by another player)
• ☠️ Death By Mob (Times killed by a monster)
• ☠️ Death By Environment (Times killed by lava, fall damage, void, drowning, etc.)
• 🦘 Total Jumps (Total times the player has jumped)
• 🥷 Sneak Time (Total time spent sneaking/crouching)

💬 Social & AI

• 💬 Total Chat Messages (Total number of messages sent in chat)
• 📝 Average Chat Characters (Average length of their chat messages)
• 🎒 Live Inventory Viewing (AI can invisibly scan all items in an online player's inventory)

---

📝 Installation & Upgrading

Simply place the NSR-AI-Advanced-Player-Stats-3.0.jar in your server's plugins/ folder.

Upgrading from v1.x

If you are upgrading from the old v1.x addon version, your old player data is stored in the NSR-AI folder. To transfer this data to the new standalone structure, you can either:

1. Use the in-built system (Recommended): Simply run the /aps migrate command in-game (requires OP or admin permission) to automatically transfer all data, privacy settings, and configs!
2. Manually copy and paste: Move the contents of plugins/NSR-AI/addons/NSR-AI-Advanced-Player-Stats/ directly into the new plugins/Advanced-Player-Stats/ folder.

Note: For full AI functionality, ensure that the NSR-AI Core Plugin is also installed and properly configured with an API provider (Gemini, OpenAI, etc.).

Developed by BlackForgeStudio