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

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

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