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

- Straightforward Configuration – Seamless synchronization with LuckPerms groups. - Straightforward Configuration – Scoreboard teams for tab list and nametags with priorities. - Straightforward Configuration – Full control per group. - Straightforward Configuration – Custom formats with placeholders. - Straightforward Configuration – Reload config files automatically without server restart. - Straightforward Configuration – Easy migration with automatic conversion. - Straightforward Configuration – 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>[Admin] " suffix: "" priority: 100

mod: prefix: "<aqua>[Mod] " suffix: "" priority: 90

vip: prefix: "<yellow>[VIP] " suffix: "" priority: 50

default: prefix: "<gray>[Player]" 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 [player]` — `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