Using it

Broadcasts and messages

Every action is announced in chat. broadcast.scope: staff (default) shows broadcasts only to players with mcbans.notify. all shows them to everyone, except silent (-s) actions, which stay staff-only. On a network, broadcast.network-wide: true shows them on every server.

All messages are in lang.yml as MiniMessage. Legacy & and &#RRGGBB codes also work. A list value is shown as several lines, and an empty value sends nothing. Reload with /mcbans reload.

These tags can be used in punishment messages and ban screens:

TagValue
<id>Record id
<type>Ban, Mute, Warning, Kick or Freeze
<player>, <staff>Target and issuer
<reason>The reason
<duration>, <remaining>Total length and time left
<date>, <expires>When it was issued and when it ends
<server>The server-name it was issued on
<ip>, <purgatory>Tags shown when the record is IP-based or a purgatory ban
<status>Active, Expired, Reversed or Issued
<removed_by>, <removed_reason>, <removed_date>Details of how it was ended
<appeal>The appeal line, or nothing if the appeal link is empty
<threshold>Credits needed to leave purgatory