Skip to main content

Troubleshooting

Common issues and their solutions.

Installation Issues​

Plugin Doesn't Load​

Symptoms: Plugin not in /plugins list, no initialization messages

Solutions:

  1. Check Java version: java -version (must be 21+)
  2. Verify JAR file is not corrupted
  3. Check server logs for errors
  4. Ensure Paper/Spigot version is 1.21+

Database Initialization Failed​

Symptoms: Error messages about database, plugin disabled

Solutions:

  1. Check folder permissions: plugins/SigmaOrders/ must be writable
  2. Verify disk space available
  3. Check file system permissions
  4. Review full error in console logs

Vault Not Found​

Symptoms: Warning about economy plugin, economy features don't work

Solutions:

  1. Install Vault plugin
  2. Install an economy plugin (EssentialsX, CMI, etc.)
  3. Restart server
  4. Verify Vault loads before SigmaOrders

Configuration Issues​

Config File Errors​

Symptoms: Plugin fails to load, config errors in console

Solutions:

  1. Check YAML syntax (use online validator)
  2. Verify indentation (spaces, not tabs)
  3. Check for invalid values
  4. Restore from backup if needed

Settings Not Applying​

Symptoms: Changes to config don't take effect

Solutions:

  1. Run /orders reload after editing config
  2. Some settings require server restart
  3. Check console for errors
  4. Verify config file is saved correctly

Order Issues​

Can't Create Order​

Symptoms: "Order limit reached" or "Cooldown active"

Solutions:

  1. Check active orders: /orders myorders
  2. Cancel old orders if at limit
  3. Wait for cooldown to expire
  4. Check config limits: max-orders-per-player, creation-cooldown

Order Not Found​

Symptoms: "Order #X not found"

Solutions:

  1. Verify order ID is correct
  2. Order may have been deleted
  3. Order may have expired and been cleaned up
  4. Check with /orders list for active orders

Can't Deliver to Order​

Symptoms: "Cannot deliver" or "Order not found"

Solutions:

  1. Verify order exists: /orders view <id>
  2. Check order status (can't deliver to cancelled/completed)
  3. Ensure order hasn't expired
  4. Check if trying to deliver to own order

Payment Not Working​

Symptoms: "Payment failed" or "Insufficient funds"

Solutions:

  1. Verify Vault and economy plugin are working
  2. Check player balance
  3. Verify economy plugin is connected to Vault
  4. Check transaction logs

Performance Issues​

Server Lag​

Symptoms: Server TPS drops, lag spikes

Solutions:

  1. Enable async database operations (default)
  2. Reduce cache size if memory issues
  3. Consider MySQL for large servers
  4. Check database file size (SQLite)
  5. Monitor with /orders debug on

Slow Operations​

Symptoms: Commands take long to execute

Solutions:

  1. Check database performance
  2. Consider MySQL for large datasets
  3. Reduce order expiration time
  4. Clean up old orders
  5. Optimize database (SQLite vacuum)

Database Issues​

Connection Errors (MySQL)​

Symptoms: "Failed to connect to database"

Solutions:

  1. Verify database server is running
  2. Check host/port settings
  3. Verify username/password
  4. Check firewall rules
  5. Test connection with MySQL client

Database Locked (SQLite)​

Symptoms: "Database locked" errors

Solutions:

  1. Ensure only one server instance is running
  2. Check for file locks
  3. Restart server
  4. Consider MySQL for multi-server setups

Permission Issues​

Permission Denied​

Symptoms: "You don't have permission"

Solutions:

  1. Check permission node: /lp user <player> info
  2. Verify player is in correct group
  3. Check permission plugin is loaded
  4. Test with OP player first
  5. Review Permissions

Commands Not Working​

Symptoms: Commands don't execute

Solutions:

  1. Check command registration in console
  2. Verify plugin is enabled
  3. Check for conflicting plugins
  4. Review server logs for errors

Economy Issues​

Economy Not Detected​

Symptoms: "Economy plugin not found"

Solutions:

  1. Install Vault
  2. Install economy plugin (EssentialsX, CMI, etc.)
  3. Verify Vault loads before SigmaOrders
  4. Check economy plugin is Vault-compatible

Balance Issues​

Symptoms: Incorrect balances or payments

Solutions:

  1. Check economy plugin directly
  2. Verify Vault integration
  3. Review transaction logs
  4. Check for duplicate economy plugins

GUI Issues​

GUI Not Opening​

Symptoms: GUI doesn't open when using commands

Solutions:

  1. Check InventoryFramework is included
  2. Verify player has permission
  3. Check for conflicting plugins
  4. Review console for errors

GUI Items Not Showing​

Symptoms: Empty GUI or missing items

Solutions:

  1. Check GUI update interval in config
  2. Verify orders exist: /orders list
  3. Check for errors in console
  4. Try reloading: /orders reload

Debug Mode​

Enable Debug​

/orders debug on

Check Debug Output​

  1. Enable debug mode
  2. Reproduce the issue
  3. Check console for detailed logs
  4. Disable when done: /orders debug off

Getting Help​

Information to Provide​

When reporting issues, include:

  1. Plugin version
  2. Server version (Paper/Spigot)
  3. Java version
  4. Error messages from console
  5. Steps to reproduce
  6. Config file (sanitized)

Logs Location​

  • Server logs: logs/latest.log
  • Plugin logs: Check console output
  • Transaction logs: plugins/SigmaOrders/transactions.log