Skip to main content

Permissions

Complete permission reference for SigmaTools, including all permission nodes, default values, and role-based examples.

Permission Overview​

SigmaTools uses a hierarchical permission system that allows fine-grained control over tool usage, administration, and bypass capabilities.

Permission Nodes​

Admin Permissions​

sigmatools.admin​

Default: op
Description: Access to all SigmaTools admin commands

Grants:

  • /sigmatools give - Give tools to players
  • /sigmatools reload - Reload configuration
  • /sigmatools debug - Debug commands

Example (LuckPerms):

/lp group admin permission set sigmatools.admin true

sigmatools.bypass​

Default: op
Description: Bypass all SigmaTools restrictions

Grants:

  • Bypass cooldown restrictions
  • Bypass durability drain
  • Bypass protection checks
  • Bypass economy costs

Note: This is a wildcard permission. Individual bypass permissions provide more granular control.

Bypass Permissions​

sigmatools.bypass.cooldown​

Default: false
Description: Bypass cooldown/charge restrictions

Effect: Player can use tools without waiting for charges to recharge

Example (LuckPerms):

/lp user PlayerName permission set sigmatools.bypass.cooldown true

sigmatools.bypass.durability​

Default: false
Description: Bypass durability drain

Effect: Tools never lose durability when used

Example (LuckPerms):

/lp user PlayerName permission set sigmatools.bypass.durability true

sigmatools.bypass.protection​

Default: false
Description: Bypass protection plugin checks

Effect: Can use tools in protected areas (use with caution)

Example (LuckPerms):

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

Warning: This allows breaking blocks in protected areas. Only grant to trusted administrators.

sigmatools.bypass.economy​

Default: false
Description: Bypass economy costs and restrictions

Effect: Tools are free to use, no costs deducted, no rewards given

Example (LuckPerms):

/lp user PlayerName permission set sigmatools.bypass.economy true

Tool Usage Permissions​

sigmatools.use.*​

Default: true
Description: Use all SigmaTools

Grants: Access to all tools (pickaxe, axe, bucket, hoe)

Example (LuckPerms):

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

sigmatools.use.pickaxe​

Default: true
Description: Use SigmaTools pickaxe

Example (LuckPerms):

/lp group default permission set sigmatools.use.pickaxe true

sigmatools.use.axe​

Default: true
Description: Use SigmaTools axe

Example (LuckPerms):

/lp group default permission set sigmatools.use.axe true

sigmatools.use.bucket​

Default: true
Description: Use SigmaTools bucket

Example (LuckPerms):

/lp group default permission set sigmatools.use.bucket true

sigmatools.use.hoe​

Default: true
Description: Use SigmaTools hoe

Example (LuckPerms):

/lp group default permission set sigmatools.use.hoe true

Permission Hierarchy​

sigmatools.*
├── sigmatools.admin (commands)
├── sigmatools.bypass (all bypasses)
│   ├── sigmatools.bypass.cooldown
│   ├── sigmatools.bypass.durability
│   ├── sigmatools.bypass.protection
│   └── sigmatools.bypass.economy
└── sigmatools.use.* (all tools)
    ├── sigmatools.use.pickaxe
    ├── sigmatools.use.axe
    ├── sigmatools.use.bucket
    └── sigmatools.use.hoe

Role-Based Permission Examples​

Default Player​

Goal: Allow all players to use all tools with normal restrictions

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

Result:

  • ✅ Can use all tools
  • ❌ Cannot use admin commands
  • ❌ Cannot bypass restrictions
  • ✅ Subject to cooldowns, durability, economy, protection

VIP Player​

Goal: Give VIP players unlimited durability and cooldown bypass

# LuckPerms
/lp group vip permission set sigmatools.use.* true
/lp group vip permission set sigmatools.bypass.cooldown true
/lp group vip permission set sigmatools.bypass.durability true

Result:

  • ✅ Can use all tools
  • ✅ No cooldown restrictions
  • ✅ No durability drain
  • ❌ Still pays economy costs
  • ❌ Still respects protection

Moderator​

Goal: Give moderators admin commands and tool usage

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

Result:

  • ✅ Can use admin commands
  • ✅ Can use all tools
  • ❌ Cannot bypass restrictions (unless granted separately)

Administrator​

Goal: Full access with all bypasses

# LuckPerms
/lp group admin permission set sigmatools.* true

Result:

  • ✅ All permissions
  • ✅ All bypasses
  • ✅ Admin commands

Restricted Tool Access​

Goal: Only allow pickaxe and axe, block bucket and hoe

# LuckPerms
/lp group default permission set sigmatools.use.pickaxe true
/lp group default permission set sigmatools.use.axe true
# Don't grant bucket or hoe permissions

Result:

  • ✅ Can use pickaxe
  • ✅ Can use axe
  • ❌ Cannot use bucket
  • ❌ Cannot use hoe

LuckPerms Configuration Examples​

Complete Setup​

# Default players - basic tool access
/lp group default permission set sigmatools.use.* true

# VIP players - enhanced access
/lp group vip permission set sigmatools.use.* true
/lp group vip permission set sigmatools.bypass.cooldown true
/lp group vip permission set sigmatools.bypass.durability true

# Moderators - admin access
/lp group moderator permission set sigmatools.admin true
/lp group moderator permission set sigmatools.use.* true

# Admins - full access
/lp group admin permission set sigmatools.* true

Permission Inheritance​

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

# VIP inherits from default
/lp group vip parent set default
/lp group vip permission set sigmatools.bypass.cooldown true

# Moderator inherits from default
/lp group moderator parent set default
/lp group moderator permission set sigmatools.admin true

# Admin inherits from moderator
/lp group admin parent set moderator
/lp group admin permission set sigmatools.bypass.* true

Permission Checking Logic​

Tool Usage​

  1. Check sigmatools.bypass - If true, allow (skip all checks)
  2. Check sigmatools.use.<tool> or sigmatools.use.* - If false, deny
  3. Continue with normal checks (cooldown, durability, economy, protection)

Admin Commands​

  1. Check sigmatools.admin - If false, deny
  2. Check command-specific permissions (if any)

Bypass Permissions​

Bypass permissions are checked individually:

  • sigmatools.bypass.cooldown - Skips cooldown check
  • sigmatools.bypass.durability - Skips durability drain
  • sigmatools.bypass.protection - Skips protection check
  • sigmatools.bypass.economy - Skips economy costs

Default Permissions Summary​

PermissionDefaultNotes
sigmatools.adminopAdmin commands
sigmatools.bypassopAll bypasses
sigmatools.bypass.cooldownfalseNo bypass
sigmatools.bypass.durabilityfalseNo bypass
sigmatools.bypass.protectionfalseNo bypass
sigmatools.bypass.economyfalseNo bypass
sigmatools.use.*trueAll players
sigmatools.use.pickaxetrueAll players
sigmatools.use.axetrueAll players
sigmatools.use.buckettrueAll players
sigmatools.use.hoetrueAll players

Testing Permissions​

Check Player Permissions​

# LuckPerms
/lp user PlayerName permission list

# Check specific permission
/lp user PlayerName permission check sigmatools.use.pickaxe

Test Tool Usage​

  1. Give player a tool: /sigmatools give pickaxe PlayerName
  2. Have player try to use the tool
  3. Check for permission denied messages
  4. Verify tool behavior matches permissions

Common Permission Issues​

Player Can't Use Tools​

Problem: Player receives "You don't have permission" message

Solutions:

  • Check sigmatools.use.* or specific tool permission
  • Verify permission plugin is working
  • Check for negative permissions (-sigmatools.use.*)
  • Reload permission plugin

Admin Commands Not Working​

Problem: Admin can't use /sigmatools commands

Solutions:

  • Check sigmatools.admin permission
  • Verify player has op or permission node
  • Check permission plugin configuration
  • Reload permission plugin

Bypass Not Working​

Problem: Bypass permission granted but restrictions still apply

Solutions:

  • Check specific bypass permission (not just sigmatools.bypass)
  • Verify permission plugin loaded correctly
  • Check for conflicting permissions
  • Reload permission plugin

Best Practices​

  1. Principle of Least Privilege - Only grant necessary permissions
  2. Use Groups - Organize permissions by role, not individual players
  3. Test Permissions - Verify permissions work as expected
  4. Document Changes - Keep track of permission modifications
  5. Regular Audits - Review permissions periodically

Next Steps​