Frequently Asked Questions
What is SigmaTools? A plugin adding four tools: Pickaxe (3x3 area mining), Axe (tree chopping), Bucket (infinite liquids), Hoe (auto-replanting crops).
Supported versions? Minecraft 1.17+ (Spigot/Paper), Java 17+.
Is it free? See License.
Do I need other plugins? No - it works standalone. Optional: Vault or CoinsEngine (economy), Lands/WorldGuard/GriefPrevention (protection).
Does it work with other tool plugins? Yes, independently - no interaction between plugins' tools.
Does it work with Folia? No, it uses the Bukkit scheduler.
Does it work with Purpur? Yes.
How do I install it / change settings / reload? See Installation, Configuration. Reload with /sigmatools reload.
How do I give a tool to a player? /sigmatools give <tool> <player> (requires sigmatools.admin).
Why isn't my tool working? See Troubleshooting.
Can I use tools in protected areas? Only if you have build rights there, or hold sigmatools.bypass.protection.
How do I read my tool's stats? The action bar shows charges (⚡), durability (⛏), and economy costs/rewards (💰) while holding the tool.
Which economy plugins are supported? Vault (works with EssentialsX, CMI, etc.) and CoinsEngine - set via economy.currency.
Will it lag my server? It's built for async operations with per-tick limits, dynamic throttling, and queue management; tune these in configuration/performance.md if needed.
What permissions do players/admins need? See Permissions.
How are tools identified? Via NBT (PersistentDataContainer), not item name or display name - prevents duplication/spoofing.
Can I customize tool appearance? Yes - item-material and display-name per tool in config.
Can I add custom tool types? Not via config; the API supports integrations but new tool types require code changes - see API.
Which protection plugins are supported? Lands, WorldGuard, GriefPrevention. Others may work if they use standard Bukkit events.
Where can I get help / report a bug? Discord or a GitHub issue - include server/plugin version, error messages, and debug logs.
Can I contribute? Yes, see Contributing.