Troubleshooting
| Problem | Likely Cause | Fix |
|---|---|---|
| Plugin won't load | Wrong MC version, or Vault missing | Requires 1.21+ and Vault installed |
| Loads but doesn't work | No shop plugin installed | Install ExcellentShop or EconomyShopGUI |
| No shops detected / prices not working | Shop plugin not yet scanned | Run /sigmasellaxe regenerate |
| Config changes don't persist | File is read-only, or edited while server running | Edit while stopped, or run /sigmasellaxe reload after saving |
| Player can't sell items | Missing sigmasellaxe.use permission | Grant sigmasellaxe.use |
| Admin commands rejected | Missing op or specific permission node | Grant the relevant sigmasellaxe.* node |
| Right-click does nothing | Not holding the Sell Axe, container has no sellable items, or blocked by a protection plugin | Check NBT-identified axe is held; check Lands/GriefPrevention/WorldGuard permissions |
| Wrong sell prices | Shop config out of sync, or a boost multiplier is active | Run /sigmasellaxe verifyConfig; check boost config |
| Durability not changing | sell-axe.durability.enabled: false, or wrong loss value | Check durability block in config.yml |
| Server lags on bulk sells | Transaction size too large | Lower the max-items-per-transaction config; consider Folia |
| Protection plugin not enforced | Integration disabled in config | Enable under integrations.<plugin>.enabled: true |
Debug Logging
debug:
enabled: true
level: DETAILED # BASIC, DETAILED, or VERBOSE
Useful Commands
/sigmasellaxe verifyConfig- check configuration for issues/sigmasellaxe verifyDupe- check for sell/buy price exploits/sigmasellaxe regenerate- re-detect shops/sigmasellaxe reload- reload configuration
Still Need Help?
When reporting an issue, include server/plugin version, console errors, and steps to reproduce.