Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
Platforms
Details
Licensed MIT
Published 6 days ago
Updated last month
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.ymlsetup.
Requirements
- Paper or Spigot server (1.8+)
- LuckPerms
- Java 8+
Installation
- Download SimplePrefix.
- Place the
SimplePrefix-<version>.jarfile into your server’spluginsdirectory. - Start (or restart) your server once.
- Configure
groups.ymlandconfig.yml. - 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).





