Chat & Formatting

Global Chat Formatting

When enabled, every message from a player in a team is prefixed with their team's prefix. This is configured in config.yml:

chat:
  enabled: true
  format: "{team_prefix}<white>{player}</white><dark_gray>:</dark_gray> <gray>{message}</gray>"

Placeholders:

{team_prefix} — The team's configured prefix (supports MiniMessage)
{player} — The player's display name
{message} — The chat message content

Paper Native SimpleTeams uses Paper's AsyncChatEvent with Adventure components, ensuring full MiniMessage compatibility and no legacy formatting hacks.

Team Chat

Players can toggle a private team chat channel:

/team chat

When enabled, messages are only sent to other team members. The format is controlled by:

team-chat:
  enabled: true
  format: "<dark_gray>[<aqua>Team Chat</aqua>]</dark_gray> <gray>{rank} {player}:</gray> <white>{message}</white>"

Placeholders:

{team_prefix} — Team prefix
{rank} — The sender's rank display name (e.g., "Moderator")
{player} — Player name
{message} — Message content

Team chat is automatically disabled when a player leaves their team or logs out.

Prefix Colors

Team prefixes support full MiniMessage syntax. Examples:

<dark_gray>[<aqua>Pro</aqua>]</dark_gray>
<gradient:red:blue>[Elite]</gradient>
<bold><gold>[VIP]</gold></bold>

Set your prefix with /team edit prefix <value>. The length check strips MiniMessage tags before counting characters.