Simply LuckPerms

A plugin designed to easily manage chat, tab and team display using only meta-fields.
It 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.

Download

You may download the latest (release) version from Modrinth.
Make sure to always use the latest version to ensure stability, functionality and security.

Required Plugins

• LuckPerms 5.4 (or newer)

Supported platforms and versions

• Paper Versions: 1.21.10 - 26.2
• PurpurMC Versions: 1.21.10 - 26.2

Recommended Version: Paper 1.21.11 (or newer)
Although simple-maintenance-plugin may work on other platforms or versions, I do not guarantee for their stability or functionality.

Setup

Prefix Setup

prefix (builtin) - Sets the holder's global prefix. Supports MiniMessage.

Suffix Setup

suffix (builtin) - Sets the holder's global suffix. Supports MiniMessage.

Scoreboard Coloring

color-team (meta field) - Sets the holder's global team color (above player color). Limited to NamedTextColor.
Defaults to WHITE if not set.



(1.21.11+) color-waypoint (meta field) - Sets the holder's waypoint color in the locator bar. Limited to NamedTextColor.
Inherits from color-team if not set.

Name Coloring

color-chat (meta field) - Sets the holder's name color. Supports MiniMessage, Name-Placeholder (%s).
Inherits from prefix if not set.

Chat Setup

color-chat (meta field) - Sets the holder's chat color. Supports MiniMessage, Message-Placeholder (%s).
Defaults to WHITE if not set.

color-chat-rich (meta field) - Sets whether the holder is allowed to use MiniMessage.
Defaults to false if not set.

Configuration file

SimplyLuckPerms uses a configuration file to enable/disable features.
If you want to make any changes to the config, create one at plugins/simply-luckperms/config.json.
By default, all features are enabled, you can disable them by setting the corresponding option to false in the configuration file.

REMOVE COMMENTS BEFORE APPLYING CONFIG

{
  "config": {
    "_node": {
      "awaitTick": 5 // The delay (in ticks) to wait after luckperms recalculates the holder's permissions.
    },
    "display": {
      "chat": {
        "use": true, // Toggles chat formatting.
        "format": "%prefix%%username%%suffix%<dark_gray>: %message%" // Format to be parsed in chat.
      },
      "name": {
        "use": true // Toggles display name formatting.
      },
      "tab": {
        "use": true, // Toggles playerlist name (tab) formatting.
        "format": "%prefix%%username%%suffix%" // Format to be parsed in the playerlist (tab).
      },
      "teams": {
        "use": true // Toggles scoreboard team creation & formatting.
      },
      "waypoints": {
        "use": true // Toggles waypoint coloring.
      }
    },
    "scoreboard": {
      "private": {
        "use": true // Toggles wether to use a private scoreboard for the holder or the bukkit default.
      },
      "prefix": {
        "use": true // Toggles wether to display prefixes on scoreboard teams.
      },
      "suffix": {
        "use": true // Toggles wether to display suffixes on scoreboard teams.
      }
    }
  }
}

REMOVE COMMENTS BEFORE APPLYING CONFIG

Commands

/slp-config reload - Reloads the configuration file. (Permission slp.config)
/slp-reload <field> - Reloads the provided display field. (Permission slp.reload)
/slp-docs - Displays a link to the latest documentation for simply-luckperms. (No permission required)

Builtin Fields & Meta Fields

LuckPerm's fields are based on holders, which are either players or groups.
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.
This works the same for all builtin fields.

When working with meta-fields, LuckPerms will choose the first field it finds. (player -> group (descending weight))
If a player has multiple meta-fields with the same key, a random one will be chosen.

Setup overrides

Overrides can be used to modify specific fields for a holder such as their chat prefix without modifying the global prefix.

Prefix Overrides

prefix-chat (meta field) - Overrides the holder's chat prefix. Supports MiniMessage.
prefix-tab (meta field) - Overrides the holder's tab (playerlist) prefix. Supports MiniMessage.
prefix-team (meta field) - Overrides the holder's scoreboard team prefix. Supports MiniMessage.

Suffix Overrides

suffix-chat (meta field) - Overrides the holder's chat suffix. Supports MiniMessage.
suffix-tab (meta field) - Overrides the holder's tab (playerlist) suffix. Supports MiniMessage.
suffix-team (meta field) - Overrides the holder's scoreboard team suffix. Supports MiniMessage.

Developer API

Only available for version 1.4.0 or newer!

Simply-LuckPerms supports modifications through external plugins using this provided library.

• Learn more the library
• Learn more about version 1.4.0

Maven

Repository:

<repository>
    <id>simply-luckperms</id>
    <url>https://repo.flauschigesalex.at/repository/maven-public/</url>
</repository>

Dependency:

<dependency>
    <groupId>at.flauschigesalex.lucko</groupId>
    <artifactId>simply-luckperms</artifactId>
    <version>VERSION</version>
</dependency>