Troubleshooting
| Problem | Check | Fix |
|---|---|---|
| Tool doesn't work / no effects | Main hand, permission, tools.<tool>.enabled | Hold tool in main hand; grant sigmatools.use.<tool>; set enabled: true |
| Tool blocked in some worlds | tools.<tool>.worlds list | Add your world to the list |
| Economy costs/rewards not applied | economy.enabled, economy.currency, integration flag | Set economy.enabled: true; set currency to "vault" or "coins"; enable general.vault-integration or general.coinsengine-integration; confirm the economy plugin works (/balance or /coins) |
| "You cannot use this tool in this area!" | Protection integration flags, tools.<tool>.check-protection | Enable the relevant general.*-integration flag; verify you have build rights in the claim; or grant sigmatools.bypass.protection (trusted staff only) |
| Server lag / high TPS usage while using tools | per-tick-limit, global-concurrent-cap, max-blocks-per-use, dynamic throttle | Lower per-tick-limit and global-concurrent-cap; enable performance.dynamic-throttle; lower max-blocks-per-use; inspect /sigmatools debug queue and reduce max-player-queue-size if it's large |
| Plugin fails to load / config not applying | YAML syntax, file encoding | Validate YAML indentation/quotes; ensure UTF-8 encoding; delete config.yml to regenerate defaults, then reapply changes; check server logs |
Common Error Messages
| Message | Fix |
|---|---|
| "You don't have permission to use this tool!" | Grant sigmatools.use.<tool> |
| "No charges remaining!" | Wait to recharge, grant sigmatools.bypass.cooldown, or raise charges in config |
| "Your tool has no durability remaining!" | /sigmatools give <tool> <player>, grant sigmatools.bypass.durability, or raise durability in config |
| "This tool cannot be used in this world!" | Add the world to tools.<tool>.worlds |
| "You need X currency to use this tool!" | Get more currency, lower the cost, or grant sigmatools.bypass.economy |
Debug Logging
/sigmatools debug toggle all on # enable everything
/sigmatools debug toggle operations on
/sigmatools debug status
Console always shows debug output; also written to logs/sigmatools-debug.log if debug.log-to-file: true.
Diagnostic Commands
/sigmatools debug info # plugin status
/sigmatools debug queue # queue status
/sigmatools debug ops # active operations
/sigmatools debug status # debug category status
Getting Help
Enable debug logging, collect server/plugin version + error messages + logs, then report via Discord or a GitHub issue.