KaribouPrefix

A lightweight prefix plugin for Paper servers. Players choose their own prefix from a list defined by the server admin. Prefixes appear in chat and in the tab list.

[VIP] Steve: Hello everyone!
[ADMIN] Alex: Welcome to the server!

Features

• Configurable prefixes with MiniMessage formatting (colors, bold, etc.)
• Prefix displayed in chat and tab list
• Players select prefixes from a server-defined list
• Optional permission per prefix
• Async persistence in data.yml (no data loss on restart)
• Tab completion for all commands

Requirements

• Paper 26.1.2
• Java 25

Commands

Command	Description
/prefix set <name>	Set your prefix
/prefix remove	Remove your prefix
/prefix list	List available prefixes
/karibouprefix reload	Reload the configuration (op only)

Permissions

Permission	Default	Description
karibouprefix.use	true	Use /prefix
karibouprefix.reload	op	Use /karibouprefix reload
karibouprefix.prefix.<name>	op	Restrict a specific prefix

Configuration

chat-format: "<prefix><player>: <message>"

prefixes:
  vip:
    display: "<gold>[VIP]</gold>"
    permission: ""
  admin:
    display: "<red>[ADMIN]</red>"
    permission: "karibouprefix.prefix.admin"
  moderator:
    display: "<blue>[MOD]</blue>"
    permission: "karibouprefix.prefix.moderator"

messages:
  no-permission: "<red>You don't have permission."
  prefix-changed: "<green>Your prefix has been changed."
  prefix-removed: "<yellow>Your prefix has been removed."
  invalid-prefix: "<red>Unknown or invalid prefix."
  config-reloaded: "<green>Configuration reloaded."

Prefix names must be lowercase alphanumeric (with - or _). The display field supports MiniMessage format. Leave permission empty to make a prefix available to everyone.

License

MIT