Skip to content

EternalCodeTeam/ChatFormatter

Repository files navigation

Readme Banner

Available on Paper Available on modrinth

Patreon Website Discord

Gradle Java

โš  This plugin requires PlaceholderAPI and Vault to run!

Preview:

1 2

Features:

  • PlaceholderAPI Support
  • MiniMessages Support with Legacy Colors Support!
  • Template System
  • Custom Placeholders System
  • Per-permission miniMessages Tags (see permissions below)

Useful links:

Permissions:

Permission Access
chatformatter.decorations.* <bold>, <italic>, <underlined>, <strikethrough>, <obfuscated>
chatformatter.decorations.bold <bold>
chatformatter.decorations.italic <italic>
chatformatter.decorations.underlined <underlined>
chatformatter.decorations.strikethrough <strikethrough>
chatformatter.decorations.obfuscated <obfuscated>
chatformatter.reset <reset>
chatformatter.gradient <gradient>
chatformatter.hover <hover>
chatformatter.click <click>
chatformatter.insertion <insertion>
chatformatter.font <font>
chatformatter.transition <transition>
chatformatter.translatable <lang>
chatformatter.selector <selector>
chatformatter.keybind <key>
chatformatter.newline <newline>
chatformatter.color.* <red>, <blue>, etc.
chatformatter.legacycolor &c, &4, &l, etc.
chatformatter.color.black <black>
chatformatter.color.dark_blue <dark_blue>
chatformatter.color.dark_green <dark_green>
chatformatter.color.dark_aqua <dark_aqua>
chatformatter.color.dark_red <dark_red>
chatformatter.color.dark_purple <dark_purple>
chatformatter.color.gold <gold>
chatformatter.color.gray <gray>
chatformatter.color.dark_gray <dark_gray>
chatformatter.color.blue <blue>
chatformatter.color.green <green>
chatformatter.color.aqua <aqua>
chatformatter.color.red <red>
chatformatter.color.light_purple <light_purple>
chatformatter.color.yellow <yellow>
chatformatter.color.white <white>
chatformatter.reload /chatformatter reload
chatformatter.receiveupdates receive update announcements for this plugin

config.yml

#    ____ _           _   _____      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
# 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>

defaultFormat: "{displayname} {arrow_right} {message}"
format:
  default: "{member} &f{displayname} &8{arrow_right} {message} "
  admin: "$template({admin}, &c)"

# It is used to shorten the text even more and keep the clean file!
templates:
  - "$template($rank, $color) -> '$rank $color{displayname} &8{arrow_right} $color{message}'"

# Placeholders, it allows you to make a shorter text, you can use some prefixes, characters etc. 
placeholders:
  {displayname}: "<displayname>"
  {name}: "<name>"
  {message}: "<message>"
  {prefix}: "<b><gradient:#29fbff:#38b3ff>ChatFormatter</gradient></b>"
  {member}: "<b><color:#6e6764>Member</color></b>"
  {admin}: "<b><color:#ff4400>Admin</color></b>"
  {arrow_right}: "ยป"
  {arrow_left}: "ยซ"