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¶

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