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