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?¶

Download the JAR file
Place it in plugins/ folder
Start/restart your server
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?¶

Reduce per-tick-limit in tool configs
Reduce global-concurrent-cap in general config
Enable dynamic throttling
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?¶

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

Can I contribute?¶

Yes! See Contributing Guide for details.

Next Steps¶

Troubleshooting - Solve common issues
Configuration Guide - Configure settings
Best Practices - Recommended setups