Skip to main content

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​