⚠ This plugin requires PlaceholderAPI and Vault to run!
- PlaceholderAPI Support
- MiniMessages Support with Legacy Colors Support!
- Template System
- Custom Placeholders System
- Per-permission miniMessages Tags (see permissions below)
- Mentions System - mention players with @playername and they will hear a sound (toggleable through
/chatformatter mentiontoggle)
Note: Each color and decoration permission (e.g.,
chatformatter.color.white,chatformatter.reset,chatformatter.decorations.bold) grants access to both the legacy code (e.g.,&f,&r,&l) and the MiniMessage tag (e.g.,<white>,<reset>,<bold>).
| Permission | Access |
|---|---|
chatformatter.decorations.* |
<bold>, <italic>, <underlined>, <strikethrough>, <obfuscated>, &l, &o, &n, &m, &k |
chatformatter.decorations.bold |
<bold>, <b>, &l |
chatformatter.decorations.italic |
<italic>, <i>, <em>, &o |
chatformatter.decorations.underlined |
<underlined>, &n |
chatformatter.decorations.strikethrough |
<strikethrough>, <st>, &m |
chatformatter.decorations.obfuscated |
<obfuscated>, <obf>, &k |
chatformatter.reset |
<reset>, &r |
chatformatter.newline |
<newline>, <br> |
chatformatter.shadow |
<shadow>, |
chatformatter.gradient |
<gradient> |
chatformatter.rainbow |
<rainbow> |
chatformatter.pride |
<pride> |
chatformatter.transition |
<transition> |
chatformatter.hover |
<hover> |
chatformatter.click |
<click> |
chatformatter.insertion |
<insertion> |
chatformatter.color.* |
All color codes: <red>, <blue>, <#a568a9>, &c, &#a568a9, etc. |
chatformatter.color.black |
<black>, &0 |
chatformatter.color.dark_blue |
<dark_blue>, &1 |
chatformatter.color.dark_green |
<dark_green>, &2 |
chatformatter.color.dark_aqua |
<dark_aqua>, &3 |
chatformatter.color.dark_red |
<dark_red>, &4 |
chatformatter.color.dark_purple |
<dark_purple>, &5 |
chatformatter.color.gold |
<gold>, &6 |
chatformatter.color.gray |
<gray>, &7 |
chatformatter.color.dark_gray |
<dark_gray>, &8 |
chatformatter.color.blue |
<blue>, &9 |
chatformatter.color.green |
<green>, &a |
chatformatter.color.aqua |
<aqua>, &b |
chatformatter.color.red |
<red>, &c |
chatformatter.color.light_purple |
<light_purple>, &d |
chatformatter.color.yellow |
<yellow>, &e |
chatformatter.color.white |
<white>, &f |
chatformatter.score |
<score> |
chatformatter.selector |
<selector> |
chatformatter.font |
<font> |
chatformatter.translatable |
<lang> |
chatformatter.keybind |
<key> |
chatformatter.nbt |
<nbt> |
chatformatter.reload |
/chatformatter reload |
chatformatter.receiveupdates |
receive update announcements for this plugin |
chatformatter.mentiontoggle |
toggle mention sound (/chatformatter mentiontoggle) |
# ____ _ _ _____ ChatFormatter _ _ # / ___| |__ __ _| |_| ___|__ _ __ _ __ ___ __ _| |_| |_ ___ _ __ # | | | '_ \ / _` | __| |_ / _ \| '__| '_ ` _ \ / _` | __| __/ _ \ '__| # | |___| | | | (_| | |_| _| (_) | | | | | | | | (_| | |_| || __/ | # \____|_| |_|\__,_|\__|_| \___/|_| |_| |_| |_|\__,_|\__|\__\___|_| # Do you want to receive updates about new versions of ChatFormatter? receiveUpdates: true # Chat format for ranks (Vault) Support mini-messages and legacy colors # We're recommending to use webui for mini-messages: https://webui.adventure.kyori.net/ # documentation is here: https://docs.adventure.kyori.net/minimessage/format.html # You can check LuckPerms setup and placeholders here: https://luckperms.net/wiki/Placeholders # # Example usages: # # Hover message: # One line: <hover:show_text:'<red>test'>TEST # Multiple lines: <hover:show_text:'<red>test'>Test<newline>Test2</hover> # # Click message: # Open URL: <click:open_url:'https://webui.adventure.kyori.net'>TEST</click> # Run command: <click:run_command:/say hello>Click</click> to say hello # Suggest command: <click:suggest_command:'/msg {displayname}'></click> # # RGB and gradient message usage: # <color:#ff00ee>Example message</color> # <gradient:#ff00ee:#f79459>Example message</gradient> # # You can use three more internal placeholders: <displayname> <name> <message> # defaultFormat: "{displayname} » {message}" # Here you can set different formats for each rank. # Remember! Rank name must be exactly the same as in you permission plugin configuration. # If player have more than one rank remember to correctly setup rank weight configuration format: default: "{member} &7$hoverName({displayname}) &8» <gradient:#d4d4d4:white>{message} " vip: "{vip} &f$hoverName({displayname}) <dark_gray>» <gradient:#ffd270:white>{message}" mod: "{mod} &f$hoverName({displayname}) <dark_gray>» <gradient:#a3ff9e:white>{message}" admin: "{admin} &f$hoverName({displayname}) <dark_gray>» <gradient:#bac8ff:white><b>{message}" owner: "{owner} &f$hoverName({displayname}) <dark_gray>» <gradient:#ff9195:white><b>{message}" # Placeholders, it allows you to make a shorter text, you can use some prefixes, characters etc. # You can use here PAPI placeholders. placeholders: {displayname}: "<displayname>" {name}: "<name>" {message}: "<message>" {member}: "<#6e6764>Member" {vip}: "<gold>VIP" {mod}: "<b><#00c900>Mod</b>" {admin}: "<b><#6e86ff>Admin</b>" {owner}: "<b><gradient:#c40000:#e04b4b>Owner</b>" {rankDescription}: "<dark_gray>Rank: <white>%vault_group%" {joinDate}: "<dark_gray>Joined: <white>%player_first_join_date%" {health}: "<dark_gray>Health: <red>%player_health%" {lvl}: "<dark_gray>LVL: <gold>%player_level%" {privateMessage}: "<gradient:#36ff39:#75ff75><i>Click to send private message</i></gradient>" # This section is made for experienced users # It is used to shorten the text even more and keep the clean file! templates: - "$hoverName($name) -> '<hover:show_text:'<dark_gray>Name: <white>$name<br><br>{rankDescription}<br>{joinDate}<br>{health}<br>{lvl}<br><br>{privateMessage}'><click:suggest_command:'/msg {displayname} '>{displayname}</click></hover>'" # Mention system settings mentions: # When a player mentions another player with @playername, the mentioned player will hear a sound enabled: true # The sound to play when a player is mentioned # Available sounds: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html sound: "BLOCK_NOTE_BLOCK_PLING" # The volume of the mention sound (0.0 to 1.0) volume: 1.0 # The pitch of the mention sound (0.5 to 2.0) pitch: 1.0