Configuration

yaml
name: "%vault_prefix%{name}"

formats:
  sent: "&#C77DFFTo &f{receiver}&7: &f{message}"
  received: "&#C77DFFFrom &f{sender}&7: &f{message}"
  spy: "&8[&#C77DFFSpy&8] &7{sender} &8→ &7{receiver}&8: &7{message}"
  action-bar: "&#C77DFF✉ &fNew message from {sender}"

hover:
  lines:
    - "&f{name}"
    - "&7------------"
    - "&#00FF11$ &fMoney: &#00FF11%vault_eco_balance_formatted%"
    - "&#FF0000🗡 &fKills: &#FF0000%statistic_player_kills%"
    - "&#FFE400⌚ &fPlaytime: &#FFE400%statistic_time_played%"
    - "&#FA7600☠ &fDeaths: &#FA7600%statistic_deaths%"
    - "&7------------"
    - "&7Click To Message!"
  click: "/msg {name} "

sounds:
  sent:
    sound: entity.experience_orb.pickup
    volume: 0.6
    pitch: 1.4
  received:
    sound: block.note_block.pling
    volume: 1.0
    pitch: 2.0
  error:
    sound: entity.villager.no
    volume: 1.0
    pitch: 1.0

cooldown: 1.0
log: true

storage:
  type: sqlite
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: ""

messages:
  msg-usage: "&cUsage: /msg <player> <message>"
  reply-usage: "&cUsage: /r <message>"
  not-online: "&c{player} is not online."
  no-reply: "&cYou have nobody to reply to."
  self: "&cYou can't message yourself."
  not-accepting: "&cThat user is not accepting private messages."
  you-ignore: "&cYou are ignoring {player}."
  cooldown: "&cWait {seconds}s before sending another message."
  ignore-on: "&7You now ignore &f{player}&7."
  ignore-off: "&7You no longer ignore &f{player}&7."
  ignore-self: "&cYou can't ignore yourself."
  ignore-list: "&7Ignored players: &f{players}"
  ignore-empty: "&7You don't ignore anyone."
  never-joined: "&c{player} has never joined."
  spy-on: "&aSocial spy on."
  spy-off: "&cSocial spy off."
  toggle-on: "&aPrivate messages on."
  toggle-off: "&cPrivate messages off."
  reloaded: "&aDirectMessages reloaded."
KeyDescription
nameHow a player's name looks in messages. {name} is the player's name; placeholders are filled for that player
sent: under formats:What the sender sees
received: under formats:What the receiver sees
spy: under formats:What staff with social spy on see
action-bar: under formats:The action bar line the receiver sees
lines: under hover:The card shown when hovering a name. Placeholders are filled for the player whose name it is
click: under hover:Typed into the chat box when a name is clicked. {name} is the player's name
sent: under sounds: / received: under sounds:Any sound key, including resource pack sounds. Volume and pitch are numbers
error: under sounds:Plays with every error message, like "You can't message yourself." or a player not accepting messages
cooldownSeconds between two messages from the same player. 0 turns it off
logWrites every message to plugins/DirectMessages/logs/<date>.log
type: under storage:sqlite (saved in plugins/DirectMessages/data.db) or mysql

In formats, {sender} and {receiver} are the two players' names, drawn with name, with the hover card and click. {message} is the message text. It is never parsed for colors or placeholders, so players can't use them. A token takes the color written before it.

When someone ignores you or has /msgtoggle off, you get the same not-accepting message, so you can't tell which.

An empty format, action bar, sound, lines: under hover: or click: under hover: turns that part off. An empty message in messages is not sent. Changing storage needs a restart; everything else applies with /directmessages reload.