ChatStylist

A lightweight and versatile chat extension plugin for Minecraft servers. Fully compatible with modern Paper environments (Adventure API / MiniMessage), allowing you to flexibly customize chat formatting, handle private messaging, restrict spam/blocked words, and more.

Features

• Custom Chat Formatting: Full support for MiniMessage formatting, allowing custom colors, gradients, and text decorations.
• Click & Hover Actions: Click player names in chat to run commands, or hover over them to view customized tooltip text.
• PlaceholderAPI Integration: Complete support for PAPI placeholders across chat formats, hover text, and system messages.
• Character Limit: Automatically blocks messages that exceed a configurable maximum character length.
• Word Filtering: Detects and cancels messages containing specified blocked words or phrases.
• Private Messaging (/msg): Built-in private chat system with smart player name and message tab completion.
• In-Game Reload: Easily reload configuration files without restarting the server using /chatstyle reload.

Commands & Permissions

Commands

• /msg <player> <message> - Send a private message to another player (Aliases: /tell, /w, /whisper)
• /chatstyle reload - Reload the plugin configuration file (Alias: /cs)

Permissions

• chatstyle.reload - Allows execution of the /chatstyle reload command (Default: OP)

Configuration (config.yml)

# Chat format configuration using MiniMessage format.
# Available placeholders:
#   <player>  - The name of the player
#   <message> - The chat message sent by the player
chat-format:
  enabled: true
  format: "<gray>[<gold>Lobby<gray>] <white><player> <dark_gray>» <reset><message>"

# Character limit settings
chat-settings:
  enabled: true
  max-length: 256
  exceed-message: "<red>Your message is too long! (Maximum is <yellow>%max%<red> characters)."

# Word filtering settings
word-filter:
  enabled: true
  blocked-words:
    - ""
  warning-message: "<red>Your message contained a blocked word and was cancelled."

# Private message format settings
msg-format:
  enabled: true
  to: "<gray>[Me -> <gold><player><gray>] <reset><message>"
  from: "<gray>[<gold><player> <gray>-> Me] <reset><message>"

# Clickable chat settings
click-command:
  enabled: true
  player-click: "/msg <player> "
  hover:
    enabled: true
    text: "<green>Click to message <yellow><player>"