If you want the custom prefixes... ...in your chat? You need a chat formatting plugin. (ex. LPC/EssXchat/etc) ...in the tab list? You need a tab plugin. (ex. TAB) ...somewhere else: You need a specific plugin for that.
Permissions
prefix.* - Gives the permissions for every command
prefix.change - Gives the permission to change your prefix
prefix.char - Gives the permission to use multiple colors in their prefix by using the char '&'
prefix.blacklist - Gives the permission to be excluded from the blacklist
prefix.list - Enabled by default - Gives players the permission to use /prefix list
prefix.other - Gives the permission to change others prefix, prefixcolor and namecolor
prefix.admin - Receive messages if there is a new version available and gives the permission to reload the plugin
prefix.color - Gives the permission to change their prefix and name to all colors
prefix.color.name - Gives the permission to use all colors for their name
prefix.color.prefix - Gives the permission to use all colors for their prefix
prefix.blacklist - Allows to use the blacklisted words
suffix.list - Enabled by default - Gives players the permission to use /suffix list
suffix.change - Allows to change suffix
suffix.char - Allows to use multiple colors in their suffix by using the char '&'
suffix.remove - Allows to remove suffix
suffix.color - Gives the permission to use all colors for their suffix
prefix.templatelist - Enabled by default - Allow to use /prefixtemplate list
prefix.template - Allow access to all existing templates
prefix.template.<template_name> - Allow acces to the template with a specific name
See spoiler for all color specific permissions for the name and prefix
Code (Text):
prefix.color.name.dark_blue:
description: Allows players to use a dark blue nickname
prefix.color.name.dark_green:
description: Allows players to use a dark green nickname
prefix.color.name.dark_aqua:
description: Allows players to use a dark aqua nickname
prefix.color.name.dark_red:
description: Allows players to use a dark red nickname
prefix.color.name.dark_purple:
description: Allows players to use a dark_purple nickname
prefix.color.name.gold:
description: Allows players to use a gold nickname
prefix.color.name.blue:
description: Allows players to use a blue nickname
prefix.color.name.green:
description: Allows players to use a green nickname
prefix.color.name.aqua:
description: Allows players to use a aqua nickname
prefix.color.name.red:
description: Allows players to use a red nickname
prefix.color.name.light_purple:
description: Allows players to use a light_purple nickname
prefix.color.name.yellow:
description: Allows players to use a yellow nickname
prefix.color.name.white:
description: Allows players to use a white nickname
prefix.color.name.gray:
description: Allows players to use a gray nickname
prefix.color.name.light_gray:
description: Allows players to use a light gray nickname
prefix.color.name.black:
description: Allows players to use a black nickname
prefix.color.name.bold:
description: Allows players to use a bold nickname
prefix.color.name.italic:
description: Allows players to use a italic nickname
prefix.color.name.magic:
description: Allows players to use a magic nickname
prefix.color.name.reset:
description: Allows players to use a reset nickname
prefix.color.name.strikethrough:
description: Allows players to use a strikethrough nickname
prefix.color.name.underline:
description: Allows players to use a underline nickname
prefix.color.prefix.dark_blue:
description: Allows players to use a dark blue prefix
prefix.color.prefix.dark_green:
description: Allows players to use a dark green prefix
prefix.color.prefix.dark_aqua:
description: Allows players to use a dark aqua prefix
prefix.color.prefix.dark_red:
description: Allows players to use a dark red prefix
prefix.color.prefix.dark_purple:
description: Allows players to use a dark_purple prefix
prefix.color.prefix.gold:
description: Allows players to use a gold prefix
prefix.color.prefix.blue:
description: Allows players to use a blue prefix
prefix.color.prefix.green:
description: Allows players to use a green prefix
prefix.color.prefix.aqua:
description: Allows players to use a aqua prefix
prefix.color.prefix.red:
description: Allows players to use a red prefix
prefix.color.prefix.light_purple:
description: Allows players to use a light_purple prefix
prefix.color.prefix.yellow:
description: Allows players to use a yellow prefix
prefix.color.prefix.white:
description: Allows players to use a white prefix
prefix.color.prefix.gray:
description: Allows players to use a gray prefix
prefix.color.prefix.light_gray:
description: Allows players to use a light gray prefix
prefix.color.prefix.black:
description: Allows players to use a black prefix
prefix.color.prefix.bold:
description: Allows players to use a bold prefix
prefix.color.prefix.italic:
description: Allows players to use a italic prefix
prefix.color.prefix.magic:
description: Allows players to use a magic prefix
prefix.color.prefix.reset:
description: Allows players to use a reset prefix
prefix.color.prefix.strikethrough:
description: Allows players to use a strikethrough prefix
prefix.color.prefix.underline:
description: Allows players to use a underline prefix
prefix.color.bracket.dark_blue:
description: Allows players to use a dark blue bracket
prefix.color.bracket.dark_green:
description: Allows players to use a dark green bracket
prefix.color.bracket.dark_aqua:
description: Allows players to use a dark aqua bracket
prefix.color.bracket.dark_red:
description: Allows players to use a dark red bracket
prefix.color.bracket.dark_purple:
description: Allows players to use a dark_purple bracket
prefix.color.bracket.gold:
description: Allows players to use a gold bracket
prefix.color.bracket.blue:
description: Allows players to use a blue bracket
prefix.color.bracket.green:
description: Allows players to use a green bracket
prefix.color.bracket.aqua:
description: Allows players to use a aqua bracket
prefix.color.bracket.red:
description: Allows players to use a red bracket
prefix.color.bracket.light_purple:
description: Allows players to use a light_purple bracket
prefix.color.bracket.yellow:
description: Allows players to use a yellow bracket
prefix.color.bracket.white:
description: Allows players to use a white bracket
prefix.color.bracket.gray:
description: Allows players to use a gray bracket
prefix.color.bracket.light_gray:
description: Allows players to use a light gray bracket
prefix.color.bracket.black:
description: Allows players to use a black bracket
prefix.color.bracket.bold:
description: Allows players to use a bold bracket
prefix.color.bracket.italic:
description: Allows players to use a italic bracket
prefix.color.bracket.magic:
description: Allows players to use a magic bracket
prefix.color.bracket.reset:
description: Allows players to use a reset bracket
prefix.color.bracket.strikethrough:
description: Allows players to use a strikethrough bracket
prefix.color.bracket.underline:
description: Allows players to use a underline bracket
suffix.color.dark_blue:
description: Allows players to use a dark blue suffix
suffix.color.dark_green:
description: Allows players to use a dark green suffix
suffix.color.dark_aqua:
description: Allows players to use a dark aqua suffix
suffix.color.dark_red:
description: Allows players to use a dark red suffix
suffix.color.purple:
description: Allows players to use a purple suffix
suffix.color.gold:
description: Allows players to use a gold suffix
suffix.color.blue:
description: Allows players to use a blue suffix
suffix.color.green:
description: Allows players to use a green suffix
suffix.color.aqua:
description: Allows players to use a aqua suffix
suffix.color.red:
description: Allows players to use a red suffix
suffix.color.pink:
description: Allows players to use a pink suffix
suffix.color.yellow:
description: Allows players to use a yellow suffix
suffix.color.white:
description: Allows players to use a white suffix
suffix.color.gray:
description: Allows players to use a gray suffix
suffix.color.light_gray:
description: Allows players to use a light gray suffix
suffix.color.black:
description: Allows players to use a black suffix
suffix.color.name.bold:
description: Allows players to use a bold suffix
suffix.color.name.italic:
description: Allows players to use a italic suffix
suffix.color.name.magic:
description: Allows players to use a magic suffix
suffix.color.name.reset:
description: Allows players to use a reset suffix
suffix.color.name.strikethrough:
description: Allows players to use a strikethrough suffix
suffix.color.name.underline:
description: Allows players to use a underline suffix
Commands
/prefix - Main command
/prefix help - Displays the help menu
/prefix reload - Reloads the config
/prefix version - Display plugin information
/prefix list - Displays avaible colors and formatting
*/prefix reset - Reset your prefix to default
*/prefix <prefix> - Change your prefix
*/prefix color <color> - Change your prefixcolor
*/prefix name <color> - Change your namecolor
*/prefix bracket <color> - Change your bracketcolor (If enabled)
/suffix list - Displays avaible colors and formatting
*/suffix reset - Reset your suffix to default
*/suffix <suffix> - Change your suffix
*/suffix color <color> - Change your suffixcolor
/prefix template list - Displays all available templates for the player
*/prefix template reset - Reset the template to default
*/prefix template <template> - Change your prefix to the defined template
If you have the permission
prefix.other. You can enter behind the commands marked with * the playername of someone else to excecute this command on them.
Config The config is very simple and you only need to change here things if you want to set a custom char in front of the Prefix and behind the Prefix.
Code (YAML):
# +---------------------------------------------------------------------------------------------------------+ # Prefix is made by martijnpu # File generated in version v7.01 # For the descriptions for each setting check the documentation: # https://hangar.papermc.io/martijnpu/PrefiX/pages/Documentation/Config # +---------------------------------------------------------------------------------------------------------+ prefix: # Here you can set the maximum length of the Prefix WITHOUT color characters max-length: 16
# Here you can set the characters before and after the prefix # You can include color codes here (&.), can also left blanked ("") # For Example if you want the following ingame: "[Admin] martijnpu" start-character: "[" end-character: "]" bracket: # Define here the option to let people change their bracket color specifically # If disabled brackets will always have the same color as the prefix enable: false
# Define here the color the start-character and end-character should be when a player has a custom Prefix # You can include color codes here (&.), can also left blanked ("") # If this value other than blanked, custom brackets functionality will be disabled change-color: "" suffix: # Here you can set the maximum length of the Prefix WITHOUT color characters max-length: 8
# Here you can set the characters before and after the suffix # You can include color codes here (&.), can also left blanked ("") start-character: "<" end-character: ">" general:
hexadecimal:
enabled: false
# Define here the hexadecimal format the other plugins are using ({#rrggbb}, &#rrggbb) format: "{#rrggbb}"
# Enable gradient support. This will allow you to use <>. Please contact martijnpu if you need other ways # With bracket functionality disabled the brackets will be included in the gradient gradient: false
# Use hexadecimal color names # Only enable if your chat/tab plugin supports this hex-names: false
# Hide warning messages to normal players # Console and players with prefix.admin will still always receive it hide-warnings: false
# Define the language of the plugin. # Currently available: "en_US" (English), "nl_NL" (Dutch), "uk_UA" (Ukrainian) and "ru" (Russian) # Want to add your translation to PrefiX? Contact the developer language: "en_US"
# Keep the current context of the tag # This option needs LuckPerms version v5.4.xx at least to work keep-context: false
# Define here the characters you want to allow # Check for the full list: https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html whitelist: -
"\\w"#Alphabetic characters -
"\\p{Punct}"#Punctuation characters -
" "#Spaces # - "\\p{IsHan}" #Chinese characters # - "%@♡€" # Allow specific symbols
# Here you can specify any characters or words whose are blocked. # Blacklist is NOT Case Sensitive blacklist: -
"fuck" -
"admin" -
"owner"
#In this section you can define your own Prefix templates players can choose of templates:
enabled: false
#The name of the template is used as permission (prefix.template.<name>) list:
example: "&a[&bTemplateExample&a] "
Custom messages You can define your own messages instead of the default English.
Code (YAML):
# +---------------------------------------------------------------------------------------------------------+ # PrefiX is made by martijnpu # File generated in version v7.1 # For the default values for each message check the documentation: # https://hangar.papermc.io/martijnpu/PrefiX/pages/Documentation/Languages # +---------------------------------------------------------------------------------------------------------+ prefix: "&ePrefiX &3➢ " language: "English" messages:
header: "&6&m&l+-----------------&6&l= &ePrefiX &6&l=&6&m&l-----------------+&r" footer: "&6&m&l+------------------------------------------+" command:
unknown: "&cDid you mean '/%COMMAND% help'?" usage: "&cPlease usage '%COMMAND%'" reload: "&6Successfully reloaded the config" reset: "&6Reset %TYPE%" changed: "&6Changed %TYPE% to &r%TAG%" removed: "&6Removed %TYPE%" reset-other: "&6Reset the %TYPE% of %NAME%" changed-other: "&6Changed the %TYPE% of %NAME%" removed-other: "&6Removed the %TYPE% of %NAME%" color:
apply: "&6Changed %TYPE% color to %COLOR%" reset: "&6Reset %TYPE% color" target: "&6Changing the %TYPE% color of %NAME%" invalid: "&cInvalid color. Pick a color from '/prefix list'" list:
apply: "&aClick to apply this to your %TYPE%" no-perm: "&cNo permission to use this for your %TYPE%" template-header: "&7&lTemplates:" error:
player: "&cPlayer '&6%NAME%&c' doesn't exists! (or is offline)" command: "&cAn error occur while executing this command. Please check the console for more info" need-target: "&cYou must target a player to execute this command!" blacklist: "&cYou've used a blacklisted word" length: "&cYou can not have more than %SIZE% characters" length-colorcode: "&cYou can not have more than %SIZE% characters excluding color codes!" character: "&cYou've used a wrong character!" colorcode: "&cYou can't use color codes!" hexadecimal: "&cHexadecimal format is disabled!" bracket: "&cBrackets are disabled by the administrator" permission:
command: "&cYou don't have permission to execute this command" color: "&cYou are not allowed to use this color" target: "&cYou are not allowed to target others" template:
disabled: "&cTemplates are disabled by the administrator" unknown: "&cTemplate '%TEMPLATE%' does not exist" help: | &6➢ &a/prefix [text] &7- &eChange the text of your prefix &6➢ &a/prefix color [color] &7- &eChange the color of your prefix &6➢ &a/prefix name [color] &7- &eChange the color of your name &6➢ &a/prefix list &7- &eList of all available colors &6➢ &a/prefix reset &7- &eSet your prefix to the default value &6➢ &a/prefix bracket [color] &7- &eChange the color of your bracket &6➢ &a/suffix [text] &7- &eChange the text of your suffix &6➢ &a/suffix color [color] &7- &eChange the color of your suffix &6➢ &a/suffix reset &7- &eSet your suffix to the default value help-others: | &6➢ &a/prefix [text] <name> &7- &eChange the text of someone else's prefix &6➢ &a/prefix color [color] <name> &7- &eChange the color of someone else's prefix &6➢ &a/prefix name [color] <name> &7- &eChange the color of someone else's name &6➢ &a/prefix list &7- &eList of all available colors &6➢ &a/prefix reset <name> &7- &eSet someone else's prefix to the default value &6➢ &a/prefix bracket [color] &7- &eChange the color of someone else's bracket &6➢ &a/suffix [text] <name> &7- &eChange the text of someone else's suffix &6➢ &a/suffix color [color] <name> &7- &eChange the color of someone else's suffix &6➢ &a/suffix reset <name> &7- &eSet someone else's suffix to the default value
Placeholders PrefiX supports placeholders via Placeholder API (PAPI). In order to use the placeholders you only need both plugins, no additional download required!
Official PAPI Wiki
Code (Text):
Placeholder - Description
-------------------------------------
%prefix_prefix% - Full Prefix
%prefix_startcolor% - StartColor
%prefix_startchar% - Start Character
%prefix_tagcolor% - Prefix Color
%prefix_tag% - Prefix itself (text within brackets without color)
%prefix_endchar% - End Character
%prefix_namecolor% - Name Color
%suffix_suffix% - Full Suffix
%suffix_startcolor% - StartColor
%suffix_startchar% - Start Character
%suffix_tagcolor% - Suffix Color
%suffix_tag% - Suffix itself (text within brackets without color)
%suffix_endchar% - End Character
%suffix_namecolor% - End Color
Looking for support? Visit our
Discord server for quick support for all your questions!