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

   • Tool must be in main hand (not off-hand)
   • Verify you're holding the correct tool

2. 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

3. Check Tool Enabled

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

4. Check World Restrictions

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

5. 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

   • Install Vault or CoinsEngine
   • Verify economy plugin is working: /balance or /coins
   • Check integration enabled in config

3. Check Currency Setting

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

   • Use "vault" for Vault economy
   • Use "coins" for CoinsEngine

4. Check Integration

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

5. Check Server Logs

   • Look for integration errors
   • 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

   • Verify protection plugin is installed
   • Check if you have permission in the area
   • Test with /sigmatools bypass.protection permission

3. Check Tool Protection Setting

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

4. 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

   • If queue is large, reduce limits
   • Consider reducing max-player-queue-size

Configuration Errors

Symptoms

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

Solutions

1. Check YAML Syntax

   • Use online YAML validator
   • Check for indentation errors
   • Verify all quotes are closed

2. Delete and Regenerate

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

3. Check File Encoding

   • Ensure files are UTF-8 encoded
   • Avoid special characters in comments

4. Check Server Logs

   • Look for configuration errors
   • 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

   • Server version
   • SigmaTools version
   • Error messages
   • Debug logs
   • Configuration files (remove sensitive data)

3. Check Documentation

   • Review relevant documentation pages
   • Check FAQ for similar issues

4. Report Issue

   • Discord: Join Discord
   • 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

• FAQ - Frequently asked questions
• Configuration Guide - Configuration help
• Best Practices - Recommended setups