ItemLimiter Permissions

Permission nodes and access control for ItemLimiter.

Permission Nodes

Permission	Description	Default
limitless.admin	Access to /ilimit GUI and admin features	op
limitless.bypass.*	Bypass all item limits (full wildcard)	op

Admin Permission

limitless.admin

Grants:

• Access to /ilimit command
• Ability to view configuration GUI
• Ability to modify item limits
• Ability to remove limits

Grant With LuckPerms:

# Individual player
/lp user <player> permission set limitless.admin true

# Group
/lp group admin permission set limitless.admin true

Bypass Permission

limitless.bypass.*

Grants:

• Ignore all configured item limits
• Stack items to vanilla maximum
• Useful for VIPs, donators, staff

Grant With LuckPerms:

# VIP group
/lp group vip permission set limitless.bypass.* true

# Individual player
/lp user <player> permission set limitless.bypass.*  true

Usage Examples

Staff Setup

# Admins get full access
/lp group admin permission set limitless.admin true
/lp group admin permission set limitless.bypass.* true

# Moderators can configure but respect limits when playing
/lp group mod permission set limitless.admin true

VIP/Donator Perks

# VIPs bypass limits as a perk
/lp group vip permission set limitless.bypass.* true

# Regular players have no permissions (limits enforced)

Permission Hierarchy

Recommended structure:

Default Players
└─ No permissions → Limits enforced

VIP/Donators  
└─ limitless.bypass.* → Can exceed limits

Moderators
└─ limitless.admin → Can configure limits

Admins
├─ limitless.admin → Can configure limits
└─ limitless.bypass.* → Can exceed limits

Configuration

Permissions are defined in plugin.yml:

permissions:
  limitless.admin:
    description: Allows access to the admin GUI
    default: op
  
  limitless.bypass.*:
    description: Bypass all limits
    default: op

Checking Permissions

Via LuckPerms

# Check if player has permission
/lp user <player> permission check limitless.admin

# List all permissions for player
/lp user <player> permission info

In-Game Testing

1. Test admin access:

   /ilimit
   # Should open GUI if has limitless.admin

2. Test bypass:

   • Stack items beyond configured limit
   • Should work if has limitless.bypass.*

Best Practices

1. Separate Concerns: Don't give bypass to all admins
2. VIP Perks: Use bypass as donator reward
3. Staff Testing: Create test account without permissions
4. Documentation: Keep list of who has what permissions
5. Regular Audit: Review permissions periodically

---

Next: Configuration options