⭐ Advanced Player Stats ⭐

“The Intelligence Layer for Player Data.”

✔ Standalone Plugin • ✔ Recursive AI Reasoning • ✔ Dual-Command System • ✔ Deep Analytics • ✔ Privacy-First

MC Versions: 1.16 – 1.21.x • JAR Size: ~40 KB • Requires: 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

Standalone Freedom — No longer tied to the legacy addon system. APS runs natively in your plugins/ folder for maximum stability and performance.
Recursive AI Reasoning — Using the latest NSR-AI API 3.0-pre, APS allows the AI to "think" and request its own data points to answer complex player queries.
Dual-Command Routing — Access data your way. Use /aps for direct, instant access or /aia aps for AI-routed ecosystem integration.
Fuzzy Matching Engine — 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:

Dynamic Data Injection: When a player asks "How am I doing?", APS automatically injects live stats, health, and privacy settings into the AI's prompt.
Hidden Tagging System: 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.
Multi-Player Comparisons: 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.
Intelligent Fallback: Prioritizes Personal API Keys for individual players, falling back to Global Keys or standard keyword matching if AI services are unavailable.

🛡️ Privacy & Technical Deep Dives

Granular Privacy Control — Players have total sovereignty over their data. Private stats are strictly hidden from AI reasoning and public commands.
Privacy-Safe Location — Tracks dimension and world info without revealing exact X, Y, Z coordinates to unauthorized users.
Self-Healing Migration — 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

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

⛏️ Progression & Social

Valuable Ore Tracking — Monitors any block ending in _ORE and Ancient Debris.
Crafting & Enchanting — Total items crafted and enchanted over the player's lifetime.
Social Metrics — 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)