Troubleshooting
Common issues, causes, and fixes.
Installation
| Symptom | Fix |
|---|---|
Plugin doesn't load / missing from /plugins | Check Java version (java -version, must be 21+), verify JAR isn't corrupted, check server logs, ensure Paper/Spigot 1.21+ |
| Database initialization failed | Ensure plugins/SigmaOrders/ is writable, check disk space and filesystem permissions, review full error in console |
| Vault not found | Install Vault, install an economy plugin (EssentialsX, CMI, etc.), restart, ensure Vault loads before SigmaOrders |
Configuration
| Symptom | Fix |
|---|---|
| Plugin fails to load, config errors in console | Check YAML syntax (use a validator), verify indentation uses spaces not tabs, restore from backup if needed |
| Config changes don't take effect | Run /orders reload; some settings require a full restart; check console for errors |
Orders
| Symptom | Fix |
|---|---|
| "Order limit reached" / "Cooldown active" | Check /orders myorders, cancel old orders, wait for cooldown, review max-orders-per-player and creation-cooldown in config |
| "Order #X not found" | Verify the ID; order may be deleted or expired/cleaned up; check /orders list for active orders |
| "Cannot deliver" / order not found on delivery | Verify with /orders view <id>, check status (can't deliver to cancelled/completed), confirm not expired, confirm not your own order |
| "Payment failed" / "Insufficient funds" | Verify Vault and the economy plugin are working, check player balance, confirm economy plugin is connected to Vault, check transaction logs |
Performance
| Symptom | Fix |
|---|---|
| Server lag / TPS drops | Async database ops are on by default; reduce cache size if memory-constrained; switch to MySQL for large servers; check SQLite file size; monitor with /orders debug on |
| Slow command execution | Check database performance, consider MySQL, reduce order expiration time, clean up old orders, vacuum SQLite |
See Performance Guide for tuning details.
Database
| Symptom | Fix |
|---|---|
| "Failed to connect to database" (MySQL) | Verify the DB server is running, check host/port, verify credentials, check firewall rules, test with a MySQL client |
| "Database locked" (SQLite) | Ensure only one server instance is running, check for stale file locks, restart, switch to MySQL for multi-server setups |
Permissions
| Symptom | Fix |
|---|---|
| "You don't have permission" | Check the node with /lp user <player> info, verify group membership, confirm the permission plugin is loaded, test with an OP player |
| Commands not working | Check command registration in console, verify the plugin is enabled, check for conflicting plugins, review server logs |
See Permissions Overview.
Economy
| Symptom | Fix |
|---|---|
| "Economy plugin not found" | Install Vault and a Vault-compatible economy plugin (EssentialsX, CMI, etc.), ensure Vault loads first |
| Incorrect balances or payments | Check the economy plugin directly, verify Vault integration, review transaction logs, check for duplicate economy plugins |
GUI
| Symptom | Fix |
|---|---|
| GUI doesn't open | Confirm InventoryFramework is bundled, verify player permission, check for conflicting plugins, review console errors |
| Empty GUI / missing items | Check gui.update-interval in config, verify orders exist with /orders list, check console for errors, try /orders reload |
Debug Mode
/orders debug on
# reproduce the issue, check console for detailed logs
/orders debug off
Getting Help
When reporting an issue, include: plugin version, server version (Paper/Spigot), Java version, console error messages, steps to reproduce, and a sanitized config file.
Logs: server logs at logs/latest.log, plugin logs in console output, transaction logs at plugins/SigmaOrders/transactions.log.