Skip to content

Troubleshooting

Common issues and solutions for SigmaTools.

Tool Not Working

Symptoms

  • Tool doesn't break blocks in area
  • No visual effects
  • No action bar updates

Solutions

  1. Check Tool in Main Hand
  2. Tool must be in main hand (not off-hand)

  3. Verify you're holding the correct tool

  4. Check Permissions 

    # Check if you have permission
/lp user YourName permission check sigmatools.use.pickaxe

# Grant permission if needed
/lp user YourName permission set sigmatools.use.pickaxe true

  5. Check Tool Enabled 

    # In config.yml
tools:
  pickaxe:
    enabled: true  # Must be true

  6. Check World Restrictions 

    # In config.yml
tools:
  pickaxe:
    worlds:
      - world  # Your world must be listed

  7. Enable Debug Logging 

    /sigmatools debug toggle operations on
# Try using tool, check logs

Economy Not Working

Symptoms

  • Costs not deducted
  • Rewards not given
  • "Economy unavailable" messages

Solutions

  1. Check Economy Enabled 

    economy:
  enabled: true  # Must be true

  2. Verify Economy Plugin

  3. Install Vault or CoinsEngine
  4. Verify economy plugin is working: /balance or /coins

  5. Check integration enabled in config

  6. Check Currency Setting 

    economy:
  currency: "vault"  # or "coins"

  7. Use "vault" for Vault economy

  8. Use "coins" for CoinsEngine

  9. Check Integration 

    general:
  vault-integration: true  # For Vault
  coinsengine-integration: true  # For CoinsEngine

  10. Check Server Logs

  11. Look for integration errors
  12. Verify economy plugin loaded correctly

Protection Blocking Tool

Symptoms

  • "You cannot use this tool in this area!" message
  • Tool works in some areas but not others

Solutions

  1. Check Protection Integration 

    general:
  lands-integration: true
  worldguard-integration: true
  griefprevention-integration: true

  2. Check Protection Plugin

  3. Verify protection plugin is installed
  4. Check if you have permission in the area

  5. Test with /sigmatools bypass.protection permission

  6. Check Tool Protection Setting 

    tools:
  pickaxe:
    check-protection: true  # Set to false to disable (not recommended)

  7. Use Bypass Permission 

    /lp user YourName permission set sigmatools.bypass.protection true
    Warning: Only grant to trusted administrators

Performance Issues

Symptoms

  • Server lag when using tools
  • Slow block breaking
  • High TPS usage

Solutions

  1. Reduce Per-Tick Limits 

    tools:
  pickaxe:
    per-tick-limit: 10  # Reduce from 20

  2. Reduce Global Concurrent Cap 

    general:
  global-concurrent-cap: 25  # Reduce from 50

  3. Enable Dynamic Throttling 

    performance:
  dynamic-throttle:
    enabled: true
    tps-threshold: 18.0
    reduction-factor: 0.5

  4. Reduce Max Blocks Per Use 

    tools:
  pickaxe:
    max-blocks-per-use: 40  # Reduce from 80

  5. Check Queue Sizes 

    /sigmatools debug queue

  6. If queue is large, reduce limits
  7. Consider reducing max-player-queue-size

Configuration Errors

Symptoms

  • Plugin fails to load
  • Configuration reload fails
  • Settings not applying

Solutions

  1. Check YAML Syntax
  2. Use online YAML validator
  3. Check for indentation errors

  4. Verify all quotes are closed

  5. Delete and Regenerate 

    # Stop server
# Delete config.yml
# Start server (regenerates default config)
# Re-apply your changes

  6. Check File Encoding

  7. Ensure files are UTF-8 encoded

  8. Avoid special characters in comments

  9. Check Server Logs

  10. Look for configuration errors
  11. Verify all required keys exist

Debug Logging

Enable Debug Logging

# Enable all debug logging
/sigmatools debug toggle all on

# Enable specific category
/sigmatools debug toggle operations on
/sigmatools debug toggle protection on

Check Debug Status

/sigmatools debug status

View Debug Logs

Console: - Debug messages appear in server console

File: 

debug:
  log-to-file: true
  log-file: "logs/sigmatools-debug.log"

Common Error Messages

"You don't have permission to use this tool!"

Solution: 

/lp user YourName permission set sigmatools.use.pickaxe true

"No charges remaining!"

Solution: - Wait for charges to recharge - Grant bypass permission: sigmatools.bypass.cooldown - Disable cooldown in config (not recommended)

"Your tool has no durability remaining!"

Solution: - Get a new tool: /sigmatools give pickaxe YourName - Grant bypass permission: sigmatools.bypass.durability - Increase durability in config

"This tool cannot be used in this world!"

Solution: 

tools:
  pickaxe:
    worlds:
      - world  # Add your world name

"You need X currency to use this tool!"

Solution: - Get more currency - Reduce tool cost in config - Grant bypass permission: sigmatools.bypass.economy

Integration Issues

Lands Not Working

  1. Verify Lands plugin installed
  2. Check integration enabled: 
    general:
  lands-integration: true
  3. Check server logs for Lands errors

WorldGuard Not Working

  1. Verify WorldGuard plugin installed
  2. Check integration enabled: 
    general:
  worldguard-integration: true
  3. Check server logs for WorldGuard errors

Vault Not Working

  1. Verify Vault plugin installed
  2. Verify economy plugin (EssentialsX, CMI, etc.) installed
  3. Check integration enabled: 
    general:
  vault-integration: true
  4. Test economy: /balance

Getting Help

If you're still experiencing issues:

  1. Enable Debug Logging 

    /sigmatools debug toggle all on

  2. Collect Information

  3. Server version
  4. SigmaTools version
  5. Error messages
  6. Debug logs

  7. Configuration files (remove sensitive data)

  8. Check Documentation

  9. Review relevant documentation pages

  10. Check FAQ for similar issues

  11. Report Issue

  12. Discord: Join Discord
  13. GitHub: Create an issue with collected information

Diagnostic Commands

# Check plugin status
/sigmatools debug info

# Check queue status
/sigmatools debug queue

# Check operations
/sigmatools debug ops

# Check debug status
/sigmatools debug status

Next Steps