# Simply LuckPerms
\nA plugin designed to easily manage chat, tab and team display using only meta-fields.
\nIt provides a simple and intuitive way to configure player prefixes, suffixes, team colors and more without the need for complex configuration files, just luckperms builtin- and meta-fields.<\/p>\n
### Required Plugins
\n– LuckPerms 5.4 (or newer)<\/p>\n
### Supported platforms and versions
\n– Paper Versions: 1.21.10 – 26.1.2<\/p>\n
Recommended Version: Paper 1.21.11 (or newer)
\n
Although simple-maintenance-plugin may work on other platforms or versions, I do not guarantee for their stability or functionality.<\/p>\n
## Setup
\n### Prefix Setup
\n
\n`prefix` *(builtin)* – Sets the holder’s global prefix. Supports MiniMessage.<\/p>\n
### Suffix Setup
\n
\n`suffix` *(builtin)* – Sets the holder’s global suffix. Supports MiniMessage.<\/p>\n
### Scoreboard Coloring
\n
\n
\n`color-team` *(meta field)* – Sets the holder’s global team color (above player color). Limited to NamedTextColor.
\n
Defaults to `WHITE` if not set.<\/p>\n
\n
\n**(1.21.11+)** `color-waypoint` *(meta field)* – Sets the holder’s waypoint color in the locator bar. Limited to NamedTextColor.
\n
Inherits from `color-team` if not set.<\/p>\n
### Name Coloring
\n
\n
\n`color-chat` *(meta field)* – Sets the holder’s name color. Supports MiniMessage, Name-Placeholder (%s).
\n
Inherits from `prefix` if not set.<\/p>\n
### Chat Setup
\n
\n
\n`color-chat` *(meta field)* – Sets the holder’s chat color. Supports MiniMessage, Message-Placeholder (%s).
\n
Defaults to `WHITE` if not set.<\/p>\n
\n
\n`color-chat-rich` *(meta field)* – Sets whether the holder is allowed to use MiniMessage.
\n
Defaults to `false` if not set.<\/p>\n
## Configuration file ## Commands ## Builtin Fields & Meta Fields When working with meta-fields, LuckPerms will choose the first field it finds. (`player` -> `group (descending weight)`) ## Setup overrides ### Prefix Overrides ### Suffix Overrides Highly customizable solution for Chat, Tab & Scoreboard Teams using LuckPerms.<\/p>\n","protected":false},"featured_media":141570,"template":"","meta":{"_minecraft_slug":"simply-luckperms","_minecraft_project_id":"F3jvgleG","_minecraft_author":"FlauschigesAlex","_minecraft_license":"MIT","_minecraft_downloads":19,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simply-luckperms.zip","_minecraft_size_bytes":70340,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:33:34.100147Z","_minecraft_date_created":"2026-05-07T21:12:10.661811Z","_minecraft_date_modified":"2026-04-30T00:06:57.892302Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simply-luckperms","_minecraft_icon_attachment_id":141570,"_minecraft_imported_at":"2026-06-08T09:59:34+00:00","_minecraft_import_hash":"11726c707ac4f45dd72affdacf37434a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,126,127,867,123,92],"mod_loader":[132],"minecraft_version":[40,41,83,167,163],"class_list":["post-141569","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-management","mod_category-paper","mod_category-social","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nSimplyLuckPerms uses a configuration file to enable\/disable features.
\n
**If you want to make any changes to the config, create one at `plugins\/simply-luckperms\/config.json`.**
\n
By default, all features are enabled, you can disable them by setting the corresponding option to `false` in the configuration file.
\n### REMOVE COMMENTS BEFORE APPLYING CONFIG
\n“`json
\n{
\n “config”: {
\n “_node”: {
\n “awaitTick”: 5 \/\/ The delay (in ticks) to wait after luckperms recalculates the holder’s permissions.
\n },
\n “display”: {
\n “chat”: {
\n “use”: true, \/\/ Toggles chat formatting.
\n “format”: “%prefix%%username%%suffix%
\n },
\n “name”: {
\n “use”: true \/\/ Toggles display name formatting.
\n },
\n “tab”: {
\n “use”: true, \/\/ Toggles playerlist name (tab) formatting.
\n “format”: “%prefix%%username%%suffix%” \/\/ Format to be parsed in the playerlist (tab).
\n },
\n “teams”: {
\n “use”: true \/\/ Toggles scoreboard team creation & formatting.
\n },
\n “waypoints”: {
\n “use”: true \/\/ Toggles waypoint coloring.
\n }
\n },
\n “scoreboard”: {
\n “private”: {
\n “use”: true \/\/ Toggles wether to use a private scoreboard for the holder or the bukkit default.
\n },
\n “prefix”: {
\n “use”: true \/\/ Toggles wether to display prefixes on scoreboard teams.
\n },
\n “suffix”: {
\n “use”: true \/\/ Toggles wether to display suffixes on scoreboard teams.
\n }
\n }
\n }
\n}
\n“`
\n### REMOVE COMMENTS BEFORE APPLYING CONFIG<\/p>\n
\n`\/slp-config reload` – Reloads the configuration file. (Permission `slp.config`)<\/p>\n
\nLuckPerm’s fields are based on `holders`, which are either players or groups.
\n
The inheritance of a field is ordered by `player` -> `group (descending weight)`, this means a group’s prefix can be overridden for a player by setting player’s prefix at a higher weight.
\n
This works the same for all builtin fields.<\/p>\n
\n
If a player has multiple meta-fields with the same key, a random one will be chosen.<\/p>\n
\nOverrides can be used to modify specific fields for a holder such as their chat prefix without modifying the global prefix.<\/p>\n
\n`prefix-chat` *(meta field)* – Overrides the holder’s chat prefix. Supports MiniMessage.
\n
`prefix-tab` *(meta field)* – Overrides the holder’s tab (playerlist) prefix. Supports MiniMessage.
\n
`prefix-team` *(meta field)* – Overrides the holder’s scoreboard team prefix. Supports MiniMessage.<\/p>\n
\n`suffix-chat` *(meta field)* – Overrides the holder’s chat suffix. Supports MiniMessage.
\n
`suffix-tab` *(meta field)* – Overrides the holder’s tab (playerlist) suffix. Supports MiniMessage.
\n
`suffix-team` *(meta field)* – Overrides the holder’s scoreboard team suffix. Supports MiniMessage.<\/p>\n","protected":false},"excerpt":{"rendered":"