One of Scribe’s most powerful features is its native integration with LuckPerms. Instead of fighting with complex Vault hooks, Scribe natively reads your LuckPerms tracks and groups.

Group Formats

In formats.yml, you can define custom chat layouts depending on what rank the player has.

groups:
  enabled: true
  priority:
    - owner
    - admin
    - moderator
    - vip
    - default

[!IMPORTANT] The priority list is checked from top to bottom. If a player has both the admin and vip groups, Scribe will assign them the admin format because it is listed higher in the priority array.

Defining the Layouts

For each group listed in your priority array, you must create a corresponding layout under formats:

  formats:
    owner: "<hover:show_text:'<muted><time></muted>'><gray>[<red>Owner</red>]</gray> <click:suggest_command:'/msg <player> '>{display_name}</click><gray>: </gray><white>{message}</white></hover>"
    
    admin: "<hover:show_text:'<muted><time></muted>'><red>[Admin]</red> <click:suggest_command:'/msg <player> '>{display_name}</click><gray>: </gray><white>{message}</white></hover>"
    
    default: "<hover:show_text:'<muted><time></muted>'>{prefix}<gray><click:suggest_command:'/msg <player> '>{display_name}</click>: </gray><white>{message}</white></hover>"

LuckPerms Prefixes

Notice how the default format uses the {prefix} placeholder? This placeholder automatically fetches the active prefix assigned to the player via LuckPerms (/lp user Steve meta addprefix 100 "[Member] ").

This means you don’t have to create 50 different group formats. You can just have one default format that dynamically injects the LuckPerms {prefix} and {suffix}!