Debug System¶

SigmaTools provides comprehensive debugging capabilities for troubleshooting and monitoring.

Debug Categories¶

Master Debug Toggle¶

Enable/disable all debug logging:

debug:
  enabled: true  # Master switch

Category-Specific Debugging¶

Enable specific categories:

debug:
  protection: true  # Protection integration
  performance: true  # Performance monitoring
  operations: true  # Tool operations
  cooldown: true  # Cooldown system
  durability: true  # Durability system
  integration: true  # Plugin integrations

Debug Output¶

Console Output¶

Debug messages appear in server console when enabled.

File Logging¶

Save debug logs to file:

debug:
  log-to-file: true
  log-file: "logs/sigmatools-debug.log"
  log-level: "INFO"

Output Settings¶

debug:
  show-timestamps: true  # Show timestamps
  show-thread-info: false  # Show thread information

Debug Commands¶

Enable Debug¶

# Enable all debug
/sigmatools debug toggle all on

# Enable specific category
/sigmatools debug toggle operations on

Check Status¶

/sigmatools debug status

Debug Information¶

/sigmatools debug info
/sigmatools debug queue
/sigmatools debug ops

Debug Categories Explained¶

Protection Debug¶

Logs protection plugin integration: - Protection checks - Permission verification - Integration status

Performance Debug¶

Logs performance metrics: - Operation counts - Queue sizes - Throttling events

Operations Debug¶

Logs tool operations: - Block breaking - Tool usage - Operation results

Cooldown Debug¶

Logs cooldown system: - Charge usage - Charge recharge - Cooldown checks

Durability Debug¶

Logs durability system: - Durability drain - Durability checks - Tool breaking

Integration Debug¶

Logs plugin integrations: - Integration loading - Integration status - Integration errors

Using Debug for Troubleshooting¶

Tool Not Working¶

1. Enable operations debug:

   /sigmatools debug toggle operations on
   

2. Try using tool

3. Check logs for errors

Economy Not Working¶

1. Enable integration debug:

   /sigmatools debug toggle integration on
   

2. Check integration status

3. Review logs

Performance Issues¶

1. Enable performance debug:

   /sigmatools debug toggle performance on
   

2. Monitor queue sizes:

   /sigmatools debug queue
   

3. Review performance logs

Log Levels¶

• DEBUG - Detailed information
• INFO - General information
• WARN - Warnings
• ERROR - Errors

Best Practices¶

1. Enable When Needed - Only enable when troubleshooting
2. Use Specific Categories - Don't enable all categories
3. Review Logs Regularly - Check for errors
4. Disable When Done - Reduce log spam

Next Steps¶

• Debug Configuration - Debug settings
• Troubleshooting - Using debug for troubleshooting
• Configuration Guide - Configuration