1 General

The four settings at the top of the file: which language to use, what to call the console, where nicknames/ignore lists are saved, and whether to check Modrinth for updates on startup.

language: 'en'
check-updates: true
console-name: 'Console'

storage:
  file: 'data.yml'

2 Chat Formatting

One template controls how every chat line looks. It's parsed as MiniMessage, so hovers, click actions and gradients all work directly inside it.

chat:
  formatting:
    enabled: true
    format: '<hover:show_text:"<gray>Click to whisper</gray>"><click:suggest_command:"/msg {player} ">{prefix}{name}{suffix}</click></hover><dark_gray> » </dark_gray><white><message></white>'

3 Auto-Link & Chat Format Permissions

How much formatting a player can type into their own message depends on two permissions, layered on top of each other:

PlaceholderAPI placeholders typed by the player (like %player_health%) are always resolved, regardless of these two permissions — they're considered safe since they only display information.

chat:
  auto-link: false

4 Message Cooldown & Allowed Pattern

A base throttle on how often anyone can send a message, and an optional whitelist regex for message content.

chat:
  message-cooldown: 2
  allowed-pattern: ''

5 Duplicate Message Check

Blocks a message that's too similar to the same player's previous one, using a Levenshtein-style character distance rather than a strict exact match.

chat:
  duplicate-check:
    enabled: true
    seconds: 30
    ignore-spacing: true
    max-difference: 2

6 Mentions & Group Mentions

@name highlights and plays a sound to a specific player — it matches both real usernames and nicknames. group-mentions defines extra keywords, like @admin, that notify everyone online with the matching permission instead of one player. Group mention keys also show up in the client's own @ chat suggestions.

chat:
  mentions:
    enabled: true
    color: 'yellow'
    sound:
      enabled: true
      name: 'ENTITY_EXPERIENCE_ORB_PICKUP'
      volume: 1.0
      pitch: 1.0

  group-mentions:
    admin:
      permission: 'auricchat.notification.admin'
    staff:
      permission: 'auricchat.notification.staff'

7 Anti-Caps & Anti-Swear

Two independent, off-by-default filters that only touch the message itself — neither one warns, mutes or punishes the player. See Moderation for how these fit together with the rest of the toolkit.

chat:
  anti-caps:
    enabled: false
    max-chars: 10

  anti-swear:
    enabled: false
    replacement-char: '*'
    words: []

8 Nickname Length

Only the length boundaries live here — the uniqueness check (no two players sharing the same visible nickname) always runs regardless of these values, and both can be bypassed entirely with auricchat.command.nick.unsafe.

nickname:
  min-length: 2
  max-length: 16

9 Private Messages

Controls how /socialspy and console logging behave for private messages sent through /msg.

private-messages:
  console-socialspy: true
  socialspy-format: '<dark_gray>[<gray>Spy<dark_gray>] <white>{player} <dark_gray>-> <white>{receiver}<dark_gray>:</dark_gray> <gray><message></gray>'

10 Join & Quit Messages

Both replace the vanilla broadcast entirely. Join messages support a distinct first-join template shown only the very first time a player ever connects — both use the same {prefix}/{name}/{suffix} tokens as chat formatting, minus <message>.

join-message:
  enabled: true
  format: '<green>[+] {prefix}{name}{suffix}</green>'
  first-join:
    enabled: true
    format: '<gold>[+] Welcome for the first time, {name}!</gold>'

quit-message:
  enabled: true
  format: '<red>[-] {prefix}{name}{suffix}</red>'

11 Death & Advancement Messages

Both are off by default. Death messages resolve {attacker} from the real last damage source — a player (by nickname), another entity, or an environmental cause — not from parsing the vanilla death text, so it always matches your configured language. {victim} is the one who died. Pet deaths reuse the exact same {attacker} logic and add {pet} for the animal type.

death-message:
  enabled: false
  hide-vanilla: false
  format: '<gray>{prefix}{name}{suffix} was defeated by {attacker}</gray>'
  pets:
    enabled: false
    format: '<gray>{prefix}{name}{suffix}''s {pet} was defeated by {attacker}</gray>'

advancement-message:
  enabled: false
  format: '<yellow>{prefix}{name}{suffix} has made the advancement [{achievement}]</yellow>'

12 Broadcasts

Covers both manual /broadcast messages and the automatic rotating announcer.

broadcast:
  format: '<yellow><message></yellow>'
  centered: true
  border:
    enabled: true
    line: '<dark_gray><strikethrough>                    </strikethrough></dark_gray>'
  auto:
    enabled: false
    interval-seconds: 600
    messages:
      - 'Welcome to the server! Remember to read the rules.'
      - 'Need help? Ask the staff team.'

13 Clear Chat

A single number: how many blank lines /clearchat sends to every online player to push old messages off-screen.

clearchat:
  empty-lines: 100

14 Chat Bubbles EXPERIMENTAL

Shows a floating text bubble above the sender's head whenever they chat, following them for the configured duration. AuricChat picks the best available renderer automatically — nothing to choose in config.yml.

chat-bubbles:
  enabled: false
  duration-seconds: 5
  radius: 32

15 Emojis

A shortcode-to-emoji dictionary applied to every message, for every player, no permission required. Over 40 shortcodes are included by default — add, remove or rename any of them freely.

emojis:
  enabled: true
  list:
    ':)': '🙂'
    ':fire:': '🔥'
    ':heart:': '❤️'
    '<3': '❤️'