Debug System
Configuration
debug:
enabled: true # master switch
protection: true # protection integration checks
performance: true # performance metrics, throttling events
operations: true # tool operations (block breaking, results)
cooldown: true # charge usage/recharge
durability: true # durability drain/checks/breaking
integration: true # plugin integration loading/status/errors
log-to-file: true
log-file: "logs/sigmatools-debug.log"
log-level: "INFO" # DEBUG, INFO, WARN, ERROR
show-timestamps: true
show-thread-info: false
Debug messages print to console when enabled, and optionally to the configured log file.
Categories
| Category | Logs |
|---|---|
protection | Protection checks, permission verification, integration status |
performance | Operation counts, queue sizes, throttling events |
operations | Block breaking, tool usage, operation results |
cooldown | Charge usage, recharge, cooldown checks |
durability | Durability drain, checks, tool breaking |
integration | Integration loading, status, errors |
Commands
/sigmatools debug toggle all on
/sigmatools debug toggle <category> on
/sigmatools debug status
/sigmatools debug info
/sigmatools debug queue
/sigmatools debug ops
Enable the relevant category (e.g. operations for tool issues, integration for economy/protection issues, performance for lag) before reproducing the issue, then check console/log output.