LPC Pro · Configuration

Groups

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

Groups allow you to apply different chat settings per rank tier — different cooldowns, message lengths, color permissions, and moderation bypasses. Configuration is in advanced/groups.yml.

Detection Modes

LPC Pro supports three ways to determine a player's group:

Mode	Description
`LUCKPERMS_GROUP`	Uses the player's primary LuckPerms group (recommended)
`VAULT_GROUP`	Uses the player's primary Vault group
`PERMISSION`	Checks for `lpcpro.group.<name>` permissions

detection-mode: "LUCKPERMS_GROUP"

When using LUCKPERMS_GROUP, the group names in advanced/groups.yml must exactly match your LuckPerms group names.

Default Settings

Applied to players who don't match any group:

default:
  message-cooldown: 3      # Seconds between messages
  command-cooldown: 1       # Seconds between commands
  max-mentions: 3           # Max @mentions per message
  max-message-length: 256   # Max characters per message
  can-use-colors: false     # Use & color codes in chat
  can-use-formatting: false # Use &l, &o, &n formatting
  can-use-gradients: false  # Use gradient formatting
  chat-prefix: ""           # Leave empty to use LuckPerms prefix

Group Properties

Each group supports these settings:

Property	Type	Description
`priority`	integer	Higher priority takes precedence (first match)
`permission`	string	Permission node for PERMISSION detection mode
`message-cooldown`	double	Seconds between messages (0 = no cooldown, supports decimals like `1.5`)
`command-cooldown`	double	Seconds between commands (0 = no cooldown, supports decimals like `0.5`)
`max-mentions`	integer	Max @mentions per message (-1 = unlimited)
`max-message-length`	integer	Max characters per message (-1 = unlimited)
`can-use-colors`	boolean	Allow `&` color codes in messages
`can-use-formatting`	boolean	Allow bold, italic, etc.
`can-use-gradients`	boolean	Allow gradient formatting
`bypass-moderation`	boolean	Skip all chat filters (not currently enforced — use individual bypass permissions)
`bypass-slowmode`	boolean	Ignore channel slowmode
`bypass-mute`	boolean	Chat even when server is muted (not currently enforced — use `lpcpro.bypass.mute` permission)
`chat-prefix`	string	Custom prefix (empty = use LuckPerms/Vault)
`max-quick-replies`	integer	Max saved quick replies for this group (default: 5)
`max-mail`	integer	Max mail messages in inbox for this group (default: 20)

Example Configuration

groups:
  # Staff Groups
  owner:
    priority: 1000
    permission: "lpcpro.group.owner"
    message-cooldown: 0
    command-cooldown: 0
    max-mentions: -1
    max-message-length: -1
    can-use-colors: true
    can-use-formatting: true
    can-use-gradients: true
    bypass-moderation: true
    bypass-slowmode: true
    bypass-mute: true
    chat-prefix: ""

  admin:
    priority: 800
    permission: "lpcpro.group.admin"
    message-cooldown: 0
    max-mentions: -1
    max-message-length: 1000
    can-use-colors: true
    can-use-formatting: true
    can-use-gradients: true
    bypass-moderation: true

  mod:
    priority: 700
    permission: "lpcpro.group.mod"
    message-cooldown: 0
    max-mentions: 15
    max-message-length: 512
    can-use-colors: true
    can-use-formatting: true

  # Donator Groups
  mvp_plus:
    priority: 400
    permission: "lpcpro.group.mvpplus"
    message-cooldown: 0
    max-mentions: 10
    max-message-length: 500
    can-use-colors: true
    can-use-formatting: true
    can-use-gradients: true

  vip:
    priority: 250
    permission: "lpcpro.group.vip"
    message-cooldown: 2
    max-mentions: 5
    max-message-length: 350
    can-use-colors: true

  # Regular Players
  member:
    priority: 100
    permission: "lpcpro.group.member"
    message-cooldown: 3
    max-mentions: 3
    max-message-length: 256
    can-use-colors: false

Using with LuckPerms Prefixes

Set chat-prefix to "" (empty) for any group to use prefixes from LuckPerms instead:

/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>"

The {prefix} placeholder in your chat format will then display these LuckPerms prefixes automatically.

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