LuckPerms

Documents LPC Pro 4.0.0 · mirrored from the product wiki, updated 2026-02-07 · GitBook version

LPC Pro integrates with LuckPerms for group detection, prefixes, and suffixes in chat formats.

What It Enables

Group Detection — Determine player groups for per-group chat settings
Prefixes/Suffixes — Display rank prefixes and suffixes in chat formats
Permission Checks — All LPC Pro permissions are compatible with LuckPerms

Setup

Install LuckPerms on your server
LPC Pro automatically detects LuckPerms — no additional configuration needed
Set detection-mode: "LUCKPERMS_GROUP" in advanced/groups.yml for group-based settings

Group Detection

In advanced/groups.yml, set the detection mode:

detection-mode: "LUCKPERMS_GROUP"

Group names in advanced/groups.yml must exactly match your LuckPerms group names:

groups:
  owner:       # Must match LuckPerms group "owner"
    priority: 1000
    # ...
  admin:       # Must match LuckPerms group "admin"
    priority: 800
    # ...

Prefixes and Suffixes

Set prefixes in LuckPerms:

/lp group owner meta setprefix 100 "<red>[Owner]</red>"
/lp group admin meta setprefix 90 "<dark_red>[Admin]</dark_red>"
/lp group vip meta setprefix 50 "<gold>[VIP]</gold>"

Then use them in chat formats with the {prefix} and {suffix} placeholders:

player:
  text: "{prefix} {name} {suffix}"

Set chat-prefix: "" (empty) in advanced/groups.yml for any group to use the LuckPerms prefix instead of a custom one.

PlaceholderAPI

With both LuckPerms and PlaceholderAPI installed, you can use LuckPerms placeholders in chat formats:

Placeholder	Description
`%luckperms_prefix%`	Player's prefix
`%luckperms_suffix%`	Player's suffix
`%luckperms_primary_group_name%`	Primary group name
`%luckperms_groups%`	All groups

Ready to run it? Get LPC Pro — AI moderation, MiniMessage, Discord, chat bubbles, games & more — one chat plugin.