SimplePrefixes

A plugin that allows players to choose and customize their own prefixes for use in chat!

System Requirements

• Paper-based server (e.g., PurpurMC)
  • The plugin uses Mini-Message from Paper
• PlaceholderAPI plugin

Main Features

• User-friendly graphical interface for prefix selection
• Compatibility with other plugins through placeholder system
• Support for PlaceholderAPI placeholders
• Support for Mini-Message formatting
• Various requirement types for prefix access: permissions, statistics, advancements, numerical comparisons

Placeholders, Commands and Permissions

Placeholders

%sp_prefix% - main placeholder for prefix. Use it in your chat plugin.

Usage example: %sp_prefix% %player_displayname% » {message}

%sp_prefix_legacy% - placeholder for legacy formatting (uses &a / §a symbols instead of <green>).

Commands

• /sp gui - opens graphical interface with prefixes
• /sp reset - resets your current prefix
• /sp set <prefix-id> - sets specified prefix
• /sp reload - reloads the plugin

Configuration

saving-type: "file"
default-prefix: "<white>[<gray>Player</gray>]</white> "

Configuration Parameters

Saving Types

PersistentDataContainer (PDC) - saves prefix ID directly on the player. Prefix is unavailable when player is offline.

YML File (FILE) - saves prefix IDs of all players in configuration file. Allows seeing prefixes of offline players. Used by default.

Creating Prefixes

prefix-id:
  display-name: "Prefix ID"
  description:
    - "This is a prefix example!"
    - "This is the second description line!"
  prefix: "<white>[<rainbow>Something</rainbow>]</white>"
  verify-always: false
  show-when-locked: true
  requirements:
    - "permission simpleprefix.example true"
    - "statistic PLAYER_KILLS >= 10"
    - "advancement nether/summon_wither true"
    - "compare_int %placeholder% < 1"

Prefix Parameters

• prefix-id - unique prefix identifier (no spaces)
• display-name - displayed prefix name (supports placeholders)
• prefix - prefix string that will be displayed instead of %sp_prefix%

Prefix Requirements

Requirements define conditions that must be met to use the prefix.

Permissions Format: permission <permission.node> [false] Example: permission example.permission (player has permission)

Statistics Format: statistic <statistic> <operator> <value> Example: statistic ANIMALS_BRED >= 100 (player bred 100+ animals)

Advancements Format: advancement <namespace:advancement> [false] Example: advancement minecraft:nether/summon_wither (player has advancement)

Integer Comparison Format: compare_int <placeholder> <operator> <value> Example: compare_int %player_absorption% > 0 (absorption value greater than 0)

In Development

• Configurable icons
• String comparison (case sensitive and insensitive)