SimplePrefix

# SimplePrefix SimplePrefix is a modern, minimalistic Minecraft plugin for managing and displaying player prefixes and groups with **LuckPerms** integration. It focuses on clean YAML configuration, fast iteration (auto-reload), and reliable tab/nametag handling using scoreboard teams. --- ## Features - **LuckPerms Integration** – Seamless synchronization with LuckPerms groups. - **Team Management** – Scoreboard teams for tab list and nametags with priorities. - **Prefix, Suffix & Name Color** – Full control per group. - **Chat & Tab Format** – Custom formats with placeholders. - **Auto-Reload** – Reload config files automatically without server restart. - **LuckPrefix Migration** – Easy migration with automatic conversion. - **Lightweight** – Minimal performance impact and simple to maintain. - **Straightforward Configuration** – Simple `groups.yml` + `config.yml` setup. --- ## Requirements - Paper or Spigot server (1.8+) - LuckPerms - Java 8+ --- ## Installation 1. Download SimplePrefix. 2. Place the `SimplePrefix-<version>.jar` file into your server’s `plugins` directory. 3. Start (or restart) your server once. 4. Configure `groups.yml` and `config.yml`. 5. Apply changes with `/sp reload` (or let auto-reload handle it). --- ## Configuration SimplePrefix uses a `groups.yml` file for group definitions and a `config.yml` for general settings + formatting. ### Example `groups.yml` ```yaml groups: admin: prefix: "<red> " suffix: "" priority: 100 mod: prefix: "<aqua> " suffix: "" priority: 90 vip: prefix: "<yellow> " suffix: "" priority: 50 default: prefix: "<gray>" suffix: "" priority: 0 ``` ### Example `config.yml` ```yaml settings: auto-reload: enabled: true interval: 30 join-delay: 20 team-prefix: "lp_" debug: false # Chat & Tab Formatierung chat-format: enabled: true format: "{prefix}{player}{suffix}: {message}" tab-format: enabled: true format: "{prefix}{player}" ``` --- ## Commands & Permissions Main command: `/sp` ### Basic - `/sp help` — `simpleprefix.use` Shows all available commands. - `/sp reload` — `simpleprefix.reload` Reloads all configuration files. - `/sp update ` — `simpleprefix.update` Updates teams (all players or a single player). - `/sp list` — `simpleprefix.list` Shows all configured groups. ### Group management - `/sp create <group> <prefix>` — `simpleprefix.create` - `/sp set <group> prefix <value>` — `simpleprefix.set` - `/sp set <group> suffix <value>` — `simpleprefix.set` - `/sp set <group> priority <0-999>` — `simpleprefix.set` - `/sp set <group> namecolor <color>` — `simpleprefix.set` - `/sp clear <group> prefix|suffix|namecolor` — `simpleprefix.set` - `/sp delete <group>` — `simpleprefix.delete` - `/sp save <group>` — `simpleprefix.save` ### Format management - `/sp format chat` — `simpleprefix.format` - `/sp format chat set <format>` — `simpleprefix.format` - `/sp format chat toggle` — `simpleprefix.format` - `/sp format tab` — `simpleprefix.format` - `/sp format tab set <format>` — `simpleprefix.format` - `/sp format tab toggle` — `simpleprefix.format` ### Migration & maintenance - `/sp migrate luckprefix` — `simpleprefix.migrate` Migrates all data from LuckPrefix. - `/sp cleanup` — `simpleprefix.cleanup` Automatically removes empty groups. --- ## Placeholders Use these in `chat-format.format` and `tab-format.format`: - `{prefix}`: Replaced with the group prefix. - `{suffix}`: Replaced with the group suffix. - `{player}`: The player's name (without color). - `{message}`: The player's chat message (chat format only). --- ## Links - GitHub: https://github.com/AstranoxDEV/simpleprefix