Skip to main content

Frequently Asked Questions

Common questions about SigmaTools.

General Questions​

What is SigmaTools?​

SigmaTools is a Minecraft plugin that adds four specialized tools:

  • Pickaxe - Area mining (3x3)
  • Axe - Tree chopping
  • Bucket - Infinite liquids
  • Hoe - Auto-replanting crops

What Minecraft versions are supported?​

SigmaTools supports Minecraft 1.17+ (Spigot/Paper). Java 17+ is required.

Is SigmaTools free?​

Check the license and distribution terms. See License for details.

Where can I download SigmaTools?​

Download from the GitHub releases page or your distribution channel.

Installation Questions​

How do I install SigmaTools?​

  1. Download the JAR file
  2. Place it in plugins/ folder
  3. Start/restart your server
  4. Configure in plugins/SigmaTools/config.yml

See Installation Guide for details.

Do I need other plugins?​

No, SigmaTools works standalone. Optional dependencies:

  • Vault or CoinsEngine - For economy features
  • Lands, WorldGuard, or GriefPrevention - For protection integration

Can I use SigmaTools with other tool plugins?​

Yes, but tools from different plugins won't interact. Each plugin manages its own tools independently.

Configuration Questions​

How do I change tool costs?​

Edit config.yml:

economy:
  enabled: true
  costs:
    pickaxe: 10.0  # Cost per use

How do I disable a tool?​

Edit config.yml:

tools:
  bucket:
    enabled: false

How do I change cooldown duration?​

Edit config.yml:

tools:
  pickaxe:
    cooldown:
      max-charges: 5  # Number of charges
      charge-duration: 1  # Seconds per charge

How do I reload configuration?​

/sigmatools reload

Usage Questions​

How do I get a tool?​

Admins can give tools:

/sigmatools give pickaxe YourName

Why isn't my tool working?​

Common issues:

  1. Tool not in main hand
  2. Missing permission: sigmatools.use.pickaxe
  3. Tool disabled in config
  4. World not allowed
  5. Protection blocking

See Troubleshooting for details.

Can I use tools in protected areas?​

By default, tools respect protection plugins. Admins can bypass:

/lp user YourName permission set sigmatools.bypass.protection true

How do I see my tool stats?​

Check the action bar while holding the tool. It shows:

  • Charges (⚡ 3/3)
  • Durability (⛏ 1500/1500)
  • Economy costs/rewards (💰 -$10.00 | 💰 +$50.00)

Economy Questions​

How do I enable economy?​

Edit config.yml:

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

Which economy plugins are supported?​

  • Vault - Works with EssentialsX, CMI, etc.
  • CoinsEngine - Alternative economy system

How do I set tool costs?​

Edit config.yml:

economy:
  costs:
    pickaxe: 10.0  # Cost per use
    axe: 5.0
    bucket: 1.0
    hoe: 2.0

How do I set tool rewards?​

Edit config.yml:

economy:
  rewards:
    pickaxe: 1.0  # Reward per block
    axe: 0.5  # Reward per log
    bucket: 0.1  # Reward per operation
    hoe: 0.3  # Reward per crop

Performance Questions​

Will SigmaTools lag my server?​

SigmaTools is optimized for performance:

  • Async operations
  • Per-tick limits
  • Dynamic throttling
  • Queue management

If experiencing lag, reduce limits in config.

How do I reduce server load?​

  1. Reduce per-tick-limit in tool configs
  2. Reduce global-concurrent-cap in general config
  3. Enable dynamic throttling
  4. Reduce max-blocks-per-use

Permission Questions​

What permissions do players need?​

Default players need:

  • sigmatools.use.* or specific tool permission (default: true)

Admins need:

  • sigmatools.admin (default: op)

How do I give players tool access?​

# LuckPerms
/lp group default permission set sigmatools.use.* true

How do I restrict tool access?​

# Only allow pickaxe
/lp group default permission set sigmatools.use.pickaxe true
# Don't grant other tool permissions

Technical Questions​

How are tools identified?​

Tools use NBT data (PersistentDataContainer), not item names. This prevents duplication and ensures proper identification.

Can I customize tool appearance?​

Yes, edit config.yml:

tools:
  pickaxe:
    item-material: DIAMOND_PICKAXE  # Change material
    display-name: "&6My Custom Pickaxe"  # Change name

Can I add custom tools?​

Not currently. The API allows integration, but new tool types require code changes.

How do I integrate with other plugins?​

Use the SigmaTools API. See API Documentation for details.

Debug Questions​

How do I enable debug logging?​

/sigmatools debug toggle all on

Or edit config.yml:

debug:
  enabled: true

Where are debug logs?​

Console: Server console
File: logs/sigmatools-debug.log (if enabled)

How do I check plugin status?​

/sigmatools debug status
/sigmatools debug info

Compatibility Questions​

Does it work with Folia?​

No, SigmaTools uses Bukkit scheduler which Folia doesn't support.

Does it work with Purpur?​

Yes, SigmaTools works with Purpur (Paper fork).

Does it work with other protection plugins?​

SigmaTools supports:

  • Lands
  • WorldGuard
  • GriefPrevention

Other protection plugins may work if they use standard Bukkit events.

Support Questions​

Where can I get help?​

  • Discord: Join Discord
  • GitHub Issues: Report bugs and request features
  • Documentation: Browse this documentation

How do I report a bug?​

  1. Enable debug logging
  2. Collect error messages and logs
  3. Create GitHub issue or post in Discord
  4. Include: server version, SigmaTools version, error details

Can I contribute?​

Yes! See Contributing Guide for details.

Next Steps​