How to Use LuckPerms Track System (Promotions and Demotions)

What Is a LuckPerms Track?

A track in LuckPerms is an ordered list of groups that represents a rank ladder. When you promote a player on a track, they move from their current group to the next one in the sequence. Demoting moves them back. The luckperms track system promotions workflow replaces manual group swapping with a single command, which reduces admin errors and makes rank progression consistent.

Creating Your First Track

Before creating a track, you need the groups that will form the ladder. We will use a simple staff track as an example.

# Create the groups
/lp creategroup helper
/lp creategroup moderator
/lp creategroup admin

# Create the track
/lp createtrack staff

# Append groups in order (lowest to highest)
/lp track staff append helper
/lp track staff append moderator
/lp track staff append admin

The order matters. LuckPerms treats the first appended group as the entry point and the last as the top rank.

Promoting and Demoting

With the track in place, luckperms track system promotions are a single command away.

# Promote a player along the staff track
/lp user Notch promote staff

# Demote a player along the staff track
/lp user Notch demote staff

If Notch is currently a helper, promoting moves them to moderator. Promoting again moves them to admin. Attempting to promote past the end of the track returns an error, which prevents accidental over-promotion.

What Happens to the Old Group?

By default, promotion removes the player from their current group on the track and adds them to the next one. The player is only in one group on the track at a time. Groups outside the track are unaffected, so a player can be on a staff track and a donor track simultaneously.

Multiple Tracks

Most servers need at least two tracks: one for staff ranks and one for player or donor ranks.

# Player progression track
/lp createtrack ranks
/lp track ranks append member
/lp track ranks append veteran
/lp track ranks append elite

# Donor track
/lp createtrack donor
/lp track donor append vip
/lp track donor append mvp
/lp track donor append legend

Each track operates independently. Promoting on the donor track does not affect the player's position on the ranks track.

Automating Promotions

You can wire luckperms track system promotions to in-game events using plugins like DeluxeMenus or a custom Skript. For example, a playtime-based promotion script might run /lp user %player% promote ranks when a player reaches 50 hours. Pair this with How to Set Up PAPI (PlaceholderAPI) to display the player's current rank in chat or on a scoreboard.

Viewing Track Info

# List all tracks
/lp listtracks

# View groups in a specific track
/lp track staff info

The info command shows every group in order, which is useful for verifying the ladder before running promotions.

Common Mistakes

• Forgetting to create groups before appending them to a track. The append command fails silently if the group does not exist.
• Appending groups in the wrong order. Use /lp track staff insert <group> <position> to fix ordering without recreating the track.
• Using promote/demote without specifying the track name when multiple tracks exist. Always include the track argument.

For permission setup within each group, read our guide and the LuckPerms Advanced Guide, Contexts, Weights & Meta deep dive.

See these configs in action: Astroworld MC, IP play.astroworldmc.com, Java + Bedrock.