🛡️ Debugger: The Ultimate StackTrace Analyzer
Stop guessing, start fixing. Debugger is a powerful, lightweight API and utility designed to translate cryptic Minecraft server errors into human-readable, actionable reports.
🚀 Key Features
Intelligent Root Cause Detection: Automatically traverses through nested exceptions to find the actual source of the crash.
Plugin Identification: Specifically identifies which plugin is likely responsible for the error, saving you hours of manual searching.
Contextual Analysis: Provides detailed explanations for common Java exceptions (NPE, IAE, CME, etc.) with specific recommendations for Spigot/Paper environments.
Error Fingerprinting: Generates a unique Error ID for every distinct stacktrace, making it easy to track recurring issues.
Server State Snapshot: Includes real-time data such as online player count, loaded worlds, and active plugins at the exact moment of the error.
Exploit Prevention: Detects potential StackOverflow or OutOfMemory patterns that might indicate malicious activity or infinite loops.
🛠️ How it Works
When an exception occurs, the StackTraceAnalyzer dissects the error's anatomy:
Locates the exact line and class where the failure happened.
Scans the stack for known plugin package patterns.
Matches the exception type against a built-in knowledge base.
Generates a clean, organized report ready for Discord, Pastebin, or in-game logs.
📋 Example Output
ERROR TYPE: NullPointerException
POSSIBLE RESPONSIBLE PLUGIN: EssentialsX v2.20.1
ERROR LOCATION: com.earth2me.essentials.User:142
ERROR ID: -140293847
DETAILED ANALYSIS: A NullPointerException means an object was used before being initialized. Check if the Player or Config value you are trying to access actually exists.
