Particle Commands

Particle Commands

Complete reference for all particle-related commands in Glamour.

Command Overview

Glamour provides two main command groups:

• /particles - Regular particle management
• /persistentparticles - Persistent particle administration

/particles

Main command for regular particle effects.

/particles gui

Opens the particle selection GUI.

Usage:

/particles gui

Permission: glamour.command.particles.gui

Description: Opens an interactive chest-based GUI where players can:

• Browse particles by category
• Filter by rarity
• Preview particle effects
• Apply particles to Pokemon
• View particle descriptions

/particles manage

Opens the particle management GUI.

Usage:

/particles manage

Permission: glamour.command.particles.manage

Description: Opens a GUI showing:

• All your Pokemon with active effects
• Current sendout and ambient particles
• Options to remove specific effects
• Quick access to reapply different effects

/particles apply

Applies a particle effect to a Pokemon.

Usage:

/particles apply <type> <particle_id> [slot]

Parameters:

• <type>: Effect type - sendout or ambient
• <particle_id>: ID of the particle configuration
• [slot]: Pokemon party slot (1-6), defaults to currently selected Pokemon

Permission: glamour.command.particles.apply

Additional Permission: glamour.particles.<particle_id>

Examples:

/particles apply sendout confetti_burst
/particles apply ambient sparkle_aura 1
/particles apply sendout dragon_breath 3

Notes:

• Requires permission for the specific particle
• Overwrites existing particle of that type
• Pokemon must be in your party

/particles remove

Removes particle effects from a Pokemon.

Usage:

/particles remove <type> [slot]

Parameters:

• <type>: Effect type - sendout or ambient
• [slot]: Pokemon party slot (1-6), defaults to currently selected Pokemon

Permission: glamour.command.particles.remove

Examples:

/particles remove sendout
/particles remove ambient 1
/particles remove sendout 6

/particles list

Lists all available particles.

Usage:

/particles list [category] [rarity]

Parameters:

• [category]: Optional filter by category
• [rarity]: Optional filter by rarity level

Permission: glamour.command.particles.list

Examples:

/particles list
/particles list elemental
/particles list celebration epic

Output: Shows particles you have permission to use with:

• Particle ID
• Display name
• Type (sendout/ambient)
• Category
• Rarity

/particles reload

Reloads particle configurations from disk.

Usage:

/particles reload

Permission: glamour.command.particles.reload (admin only)

Description:

• Reloads all files from config/glamour/particles/
• Does not require server restart
• Clears particle cache
• Updates GUI dynamically

Note: Does not affect already-applied particles, only new applications.

/persistentparticles

Administrative commands for persistent particle system.

/persistentparticles reload

Reloads persistent particle configurations.

Usage:

/persistentparticles reload

Permission: glamour.command.persistentparticles.reload (admin only)

Description:

• Reloads all files from config/glamour/persistent_particles/
• Clears condition matching cache
• Reapplies conditions to all active Pokemon
• No server restart needed

/persistentparticles stats

Displays performance statistics.

Usage:

/persistentparticles stats

Permission: glamour.command.persistentparticles.stats (admin only)

Shows:

• Active persistent particle configs loaded
• Pokemon currently being tracked
• Renders per tick (current)
• Max renders per tick (limit)
• Max renders per config (limit)
• LOS tests performed
• Cache hit/miss ratios

Example Output:

=== Persistent Particle Stats ===
Loaded Configs: 12
Active Pokemon: 47
Renders This Tick: 28
Max Renders/Tick: 100
Max Renders/Config: 50
LOS Tests: 15/50
Cache Hits: 142
Cache Misses: 23

/persistentparticles debug

Shows detailed information about a configuration.

Usage:

/persistentparticles debug <config_id>

Parameters:

• <config_id>: ID of the persistent particle configuration

Permission: glamour.command.persistentparticles.debug (admin only)

Example:

/persistentparticles debug shiny_sparkle

Shows:

• Configuration ID and priority
• Particle resource ID
• All settings (intervals, counts, distances, etc.)
• All conditions (species, shiny, biomes, etc.)
• Active matches (how many Pokemon currently match)

Permission Summary

Player Permissions

Permission	Command	Description
glamour.command.particles	Base	Access to particles command
glamour.command.particles.gui	/particles gui	Open selection GUI
glamour.command.particles.manage	/particles manage	Open management GUI
glamour.command.particles.apply	/particles apply	Apply particles
glamour.command.particles.remove	/particles remove	Remove particles
glamour.command.particles.list	/particles list	List particles
glamour.particles.<id>	N/A	Access specific particle

Admin Permissions

Permission	Command	Description
glamour.command.particles.reload	/particles reload	Reload configs
glamour.command.persistentparticles	Base	Access to persistent commands
glamour.command.persistentparticles.reload	/persistentparticles reload	Reload persistent configs
glamour.command.persistentparticles.stats	/persistentparticles stats	View statistics
glamour.command.persistentparticles.debug	/persistentparticles debug	Debug configurations

Common Use Cases

Player: Applying a Particle

1. Browse available particles:

   /particles gui

2. Or apply directly if you know the ID:

   /particles apply sendout confetti_burst

Player: Changing Particles

1. Open management GUI:

   /particles manage

2. Select Pokemon and remove/change effects

Player: Finding Specific Particles

/particles list elemental epic

Shows only epic-rarity elemental particles you can access.

Admin: Adding New Particles

1. Create JSON file in config/glamour/particles/

2. Reload configurations:

   /particles reload

3. Test in GUI or apply directly

Admin: Debugging Persistent Particles

1. Check if config loaded:

   /persistentparticles debug shiny_sparkle

2. View performance:

   /persistentparticles stats

3. Reload after changes:

   /persistentparticles reload

Troubleshooting

”You don’t have permission to use this particle”

Cause: Missing particle-specific permission

Solution: Admin needs to grant glamour.particles.<particle_id>

”No Pokemon in that slot”

Cause: Specified slot is empty or invalid

Solution: Check party slot (1-6) or omit slot parameter

”Particle configuration not found”

Cause: Invalid particle ID or config not loaded

Solution:

• Check spelling of particle ID
• Run /particles list to see valid IDs
• Admin: check if config file exists and /particles reload

Commands Not Working

Cause: Missing base permission

Solution: Ensure you have glamour.command.particles permission

Persistent Particles Not Showing

Cause: Conditions not matching or config not loaded

Solution:

• Admin: Run /persistentparticles debug <id> to verify conditions
• Check “Active Matches” in debug output
• Verify Pokemon meets all specified conditions

Next Steps

• Particle Configuration Reference
• Permissions Setup
• Pokemon Particles Guide