SigmaSellAxe Wiki

Complete documentation for SigmaSellAxe

Troubleshooting

Common issues and their solutions. If you can't find your issue here, join our Discord Server for help.

Installation Issues

Plugin Won't Load

Symptoms:

  • Plugin doesn't appear in /plugins
  • Error in console on startup
  • Plugin fails to enable

Solutions:

  1. Verify you're using the correct Minecraft version (1.21+)
  2. Check that Vault is installed (required dependency)
  3. Verify the JAR file isn't corrupted (re-download if needed)
  4. Check server console for specific error messages
  5. Ensure you're using Spigot, Paper, or Folia (not CraftBukkit)
  6. Check Java version (requires Java 17+)

Missing Dependencies

Symptoms:

  • Plugin loads but doesn't function
  • Errors about missing dependencies
  • Economy not working

Solutions:

  1. Install Vault (required)
  2. Install shop plugin (ExcellentShop or EconomyShopGUI) for full functionality
  3. Check server console for missing dependency warnings
  4. Verify dependencies are enabled in /plugins

Configuration Issues

Shop Plugin Not Detected

Symptoms:

  • No shops detected on startup
  • Prices not working
  • Using fallback prices only

Solutions:

  1. Verify shop plugin is installed and enabled
  2. Check shop plugin is working correctly
  3. Run /sigmasellaxe regenerate to re-detect shops
  4. Check debug logs: 
    debug:
  enabled: true
  level: DETAILED
  5. Verify shop plugin has shops configured
  6. Check that shop plugin version is compatible

Configuration Not Saving

Symptoms:

  • Changes to config don't persist
  • Config reverts on restart
  • Config file appears empty

Solutions:

  1. Check file permissions (ensure server can write to config file)
  2. Verify config file isn't read-only
  3. Check server console for save errors
  4. Try /sigmasellaxe reload after making changes
  5. Check disk space on server
  6. Verify YAML syntax is correct (use online YAML validator)

Permission Issues

Player Can't Use Sell Axe

Symptoms:

  • Player can't sell items
  • No error message
  • Right-click does nothing

Solutions:

  1. Check player has sigmasellaxe.use permission
  2. Verify permission plugin is working
  3. Check server console for permission errors
  4. Try giving player sigmasellaxe.* temporarily to test
  5. Check if player is holding the Sell Axe (not a regular axe)
  6. Verify the Sell Axe was given using /sigmasellaxe give

Admin Commands Not Working

Symptoms:

  • Admin can't use /sigmasellaxe reload
  • Commands return "no permission"
  • OP status not recognized

Solutions:

  1. Verify admin has op status or specific permission
  2. Check permission plugin recognizes the permission node
  3. Try using sigmasellaxe.* permission
  4. Check for conflicting permission groups
  5. Verify permission plugin is loaded before SigmaSellAxe

Selling Issues

Items Not Selling

Symptoms:

  • Right-click does nothing
  • No items sold
  • No error message

Solutions:

  1. Verify player is holding the Sell Axe
  2. Check container has sellable items
  3. Verify player has permission in protection plugin (Lands/GriefPrevention/WorldGuard)
  4. Check debug logs for specific errors
  5. Verify items exist in shop plugin
  6. Check if items are disabled in shop config
  7. Ensure Vault economy is working

Wrong Prices

Symptoms:

  • Items selling for wrong prices
  • Prices not matching shop plugin
  • Prices seem too high or too low

Solutions:

  1. Run /sigmasellaxe verifyConfig to check configuration
  2. Verify shop plugin prices are correct
  3. Check for boost multipliers in shop configs
  4. Regenerate shop configs: /sigmasellaxe regenerate
  5. Check if global boost is affecting prices
  6. Verify correct shop plugin is selected

Durability Not Working

Symptoms:

  • Sell Axe doesn't lose durability
  • Durability loss too high/low
  • Sell Axe breaks too quickly

Solutions:

  1. Check durability is enabled in config: 
    sell-axe:
  durability:
    enabled: true
    lose-per-sell: 1
  2. Verify the Sell Axe is the correct item (identified by NBT, not name)
  3. Check if durability loss is set too high (reduce lose-per-sell)
  4. Verify durability is only lost on successful sells

Performance Issues

Server Lag When Selling

Symptoms:

  • Server freezes when selling large amounts
  • TPS drops during transactions
  • Players experience lag

Solutions:

  1. Check transaction limits (max 5,000 items per transaction)
  2. Reduce max items per transaction if needed
  3. Enable debug logging to identify bottlenecks
  4. Consider using Folia for better performance
  5. Check if shop plugin is causing lag
  6. Verify economy plugin performance

High Memory Usage

Symptoms:

  • Server using too much memory
  • Out of memory errors
  • Server crashes

Solutions:

  1. Check log file rotation is enabled
  2. Limit transaction sizes
  3. Review debug logging level (VERBOSE uses more memory)
  4. Check for memory leaks in other plugins
  5. Clean up old log files regularly
  6. Increase server memory allocation if needed

Integration Issues

Protection Plugin Not Working

Symptoms:

  • Players can sell in protected areas
  • Protection checks not working
  • No protection validation

Solutions:

  1. Verify protection plugin is installed and enabled
  2. Check integration is enabled in config: 
    integrations:
  lands-integration: true
  3. Check server console for integration messages
  4. Verify protection plugin is working correctly
  5. Test protection plugin independently
  6. Check protection plugin version compatibility

Shop Plugin Integration Issues

Symptoms:

  • Prices not updating
  • Shops not detected
  • Integration errors in console

Solutions:

  1. Verify shop plugin is installed and enabled
  2. Check shop plugin is working correctly
  3. Run /sigmasellaxe regenerate to re-detect shops
  4. Check debug logs for integration errors
  5. Verify shop plugin version is compatible
  6. Check shop plugin API compatibility

Debug Information

Enabling Debug Logging

Enable debug logging to get detailed information:

debug:
  enabled: true
  level: DETAILED  # BASIC, DETAILED, or VERBOSE

Debug Levels:

  • BASIC - Essential debug information
  • DETAILED - More detailed debugging
  • VERBOSE - Maximum verbosity (use only when troubleshooting)

Getting Help

When reporting issues, provide:

  1. Server Version - e.g., Paper 1.21.6
  2. Plugin Version - e.g., SigmaSellAxe 2.0.7
  3. Error Messages - From console/logs
  4. Steps to Reproduce - What you did to cause the issue
  5. Installed Plugins - List of all plugins
  6. Configuration - Relevant config sections (remove sensitive data)

Useful Commands

  • /sigmasellaxe verifyConfig - Check configuration
  • /sigmasellaxe verifyDupe - Check for dupe exploits
  • /sigmasellaxe reload - Reload configuration
  • /sigmasellaxe regenerate - Regenerate shop configs

Performance Tips

  1. Use Folia - Better performance on multi-threaded servers
  2. Limit Transaction Size - Keep transactions reasonable
  3. Enable Log Rotation - Prevents log files from growing too large
  4. Disable Verbose Debug - Only enable when troubleshooting
  5. Regular Maintenance - Clean up old log files
  6. Optimize Shop Configs - Remove unused items from shop configs

Still Need Help?