?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
SimplePrefix

SimplePrefix

SimplePrefix is a well-structured and optimized Prefix Plugin

798downloads
0followers
798downloads
0followers

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
1.12.x
1.11.x
1.10.x
1.9.x
1.8.x

Platforms

Creators

Details

Licensed MIT
Published 10 months ago
Updated 10 months ago

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