Permissions

Permissions

Glamour integrates with LuckPerms to provide granular control over which particles players can use.

Permission System

LuckPerms Integration

Glamour automatically detects LuckPerms if installed and uses it for permission checks. If LuckPerms is not installed, all players with appropriate operator levels can access all features.

Permission Format

Permissions follow a hierarchical pattern:

glamour.particles.<particle_id>

Command Permissions

Permission	Description
glamour.command.particles	Access to /particles commands
glamour.command.particles.gui	Open particle selection GUI
glamour.command.particles.apply	Apply particles to Pokemon
glamour.command.particles.remove	Remove particles from Pokemon
glamour.command.particles.list	List available particles
glamour.command.particles.reload	Reload configurations (admin)
glamour.command.persistentparticles	Access persistent particle commands

Particle Access Permissions

Individual Particles

Grant access to specific particles:

glamour.particles.confetti_burst
glamour.particles.sparkle_aura
glamour.particles.fire_trail

Wildcard Access

Grant access to all particles:

glamour.particles.*

Category-Based Permissions

Grant access to entire categories:

glamour.particles.category.celebration.*
glamour.particles.category.elemental.*
glamour.particles.category.magical.*

Rarity-Based Permissions

Grant access by rarity level:

glamour.particles.rarity.common.*
glamour.particles.rarity.uncommon.*
glamour.particles.rarity.rare.*
glamour.particles.rarity.epic.*
glamour.particles.rarity.legendary.*
glamour.particles.rarity.mythical.*

Example Permission Setups

Free-to-Play Players

lp group default permission set glamour.command.particles true
lp group default permission set glamour.command.particles.gui true
lp group default permission set glamour.particles.rarity.common.* true

VIP/Donor Ranks

# VIP gets uncommon and rare particles
lp group vip permission set glamour.particles.rarity.common.* true
lp group vip permission set glamour.particles.rarity.uncommon.* true
lp group vip permission set glamour.particles.rarity.rare.* true

# Premium gets everything up to epic
lp group premium parent add vip
lp group premium permission set glamour.particles.rarity.epic.* true

Admin/Staff

lp group admin permission set glamour.particles.* true
lp group admin permission set glamour.command.particles.reload true
lp group admin permission set glamour.command.persistentparticles true

Event Rewards

Grant specific rare particles as event rewards:

lp user PlayerName permission set glamour.particles.celestial_burst true
lp user PlayerName permission set glamour.particles.dragon_aura true

Permission Inheritance

Permissions follow LuckPerms inheritance rules:

Admin (all permissions)
  └── Moderator (common, uncommon, rare, epic)
       └── VIP (common, uncommon, rare)
            └── Default (common only)

Checking Permissions

In-Game

Players can check which particles they have access to:

/particles list

This command shows only particles the player has permission to use.

LuckPerms Editor

Use LuckPerms web editor for visual permission management:

/lp editor

Permission Caching

Glamour caches permission checks for performance. If permissions don’t update immediately:

1. Player can rejoin the server
2. Admin can run /particles reload
3. LuckPerms handles its own cache refresh

Default Behavior (No LuckPerms)

Without LuckPerms installed:

• Regular Players: No access to particle commands
• Operators: Full access based on operator level
• Op Level 2+: Can use particle GUI and apply particles
• Op Level 3+: Can reload configurations

Combining Permission Types

You can combine different permission types:

# Grant category access + specific high-tier particles
lp group vip permission set glamour.particles.category.celebration.* true
lp group vip permission set glamour.particles.legendary_sparkle true

Best Practices

1. Start Restrictive: Begin with minimal permissions and expand based on feedback
2. Use Rarity Tiers: Structure permissions around rarity for clear progression
3. Category Groups: Group thematically similar particles for easier management
4. Document Changes: Keep track of custom permission grants
5. Test First: Test permission setups on a test server before production

Troubleshooting

Players Can’t Access Particles

1. Verify LuckPerms is installed and working
2. Check permission grants with /lp user <name> permission info
3. Ensure the particle ID matches exactly (case-sensitive)
4. Check for permission conflicts or negations

GUI Shows Locked Particles

This is intentional - the GUI shows all particles but marks ones without permission as locked. Players can see what’s available but can’t apply restricted particles.

Permissions Not Updating

1. Run /particles reload to refresh Glamour’s cache
2. Check LuckPerms cache with /lp reloadconfig
3. Have the player rejoin the server

Next Steps

• Particle Configuration
• Commands Reference
• Pokemon Particle System