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

Permission	Default	Notes
sigmatools.admin	op	Admin commands
sigmatools.bypass	op	All bypasses
sigmatools.bypass.cooldown	false	No bypass
sigmatools.bypass.durability	false	No bypass
sigmatools.bypass.protection	false	No bypass
sigmatools.bypass.economy	false	No bypass
sigmatools.use.*	true	All players
sigmatools.use.pickaxe	true	All players
sigmatools.use.axe	true	All players
sigmatools.use.bucket	true	All players
sigmatools.use.hoe	true	All 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

• Commands Reference - Learn all available commands
• Configuration Guide - Configure plugin settings
• Troubleshooting - Solve permission issues