SmartDebugis a handy Minecraft plugin that helps you catch and fix issues on your server. It monitors various aspects such as player damage, movement, and overall server performance. SmartDebug also scans other plugins for potential conflicts, helping you keep your server running smoothly and identify problems before they become serious
Commands and Permissions
/setdebug <category> Description: Set the debug category. Permission: smartdebug.setdebug
/resetdebug Description: Reset all debug data. Permission: smartdebug.resetdebug
/feedback <true|false> <issueId> Description: Provide feedback on detected issues. Permission: smartdebug.feedback
/reportissue <playerName> <details> Description: Report an issue with a player. Permission: smartdebug.reportissue
Categories
DAMAGE: Detects abnormal player damage values.
MOVEMENT: Monitors excessive player movements.
JOIN: Tracks and logs player join events.
QUIT: Logs player quit events and session durations.
CONNECTION: Monitors player connection and login times.
LAG: Detects server lag issues.
CRASH: Identifies potential server crashes.
GLITCH: Detects unusual in-game behavior.
PERFORMANCE: Monitors overall server performance.
SECURITY: Tracks security-related events like player kicks.
COMPATIBILITY: Checks for plugin compatibility issues.
USER_FEEDBACK: Logs issues reported by users.
Features:
Comprehensive Debugging: Monitors various aspects of player and server behavior.
Real-time Detection: Identifies issues as they happen and logs them to the console immediately.
Admin Feedback Loop: Allows admins to mark issues as true or false positives to improve accuracy.
Detailed Logs: Maintains detailed records of all detected issues to assist with troubleshooting.
Config.yml
Code (Text):
# Configuration file for SmartDebug plugin
# Enable or disable debugging
debug:
enable: true
# Set the default debug category (Options: DAMAGE, MOVEMENT, JOIN, QUIT, CONNECTION, LAG, CRASH, GLITCH, PERFORMANCE, SECURITY, COMPATIBILITY, ALL)
category: PERFORMANCE
# Performance monitoring settings
performance:
enable: true
# Interval in seconds for performance checks
interval: 60
# Issue detection thresholds (Adjust these values to fine-tune detection sensitivity)
thresholds:
# Threshold for detecting abnormal damage values
damage: 2.5 # Detects when player damage exceeds the mean by a factor of 2.5
# Threshold for detecting excessive movement
movement: 1500 # Detects when player movement exceeds 1500 steps
# Threshold for player join events (usually set to 0 to log all joins)
join: 30 # Logs player join events if a player joins more than once within 30 minutes
# Threshold for player quit events (logging frequency in minutes)
quit: 30 # Logs player quit events if a player quits more than once within 30 minutes
# Threshold for connection-related events
connection: 500 # Detects when connection issues exceed 500ms latency
# Threshold for detecting lag issues
lag: 1000 # Detects server tick lag exceeding 1000ms
# Threshold for detecting potential crashes
crash: 5 # Detects 5 or more crash instances
# Threshold for detecting glitches
glitch: 3 # Detects 3 or more glitch instances
# Threshold for monitoring overall performance
performance: 500 # Detects performance drops when TPS (ticks per second) drops below 500ms
# Threshold for security-related events (e.g., kicks)
security: 1 # Logs all security-related events
# Threshold for plugin compatibility issues
compatibility: 1 # Logs all compatibility issues
Example Logs
Potential issue detected (ID: 1): Player1 has unusual damage behavior. Base Value: 5.0, Current Value: 15.0 Details: High damage detected.
Potential issue detected (ID: 2): Player2 has unusual movement behavior. Base Value: 1000, Current Value: 2000 Details: Excessive movement detected.
Example Feedback
Feedback provided: Issue 1 marked as true positive. This means the issue was real and the detection was correct. Feedback provided: Issue 2 marked as false positive. This means the issue was not real and the detection was incorrect.