PhantomBans | Complete Moderation Suite 1.3.0

📝 Multi-Line Messages

Every key in messages.yml, plus format and format-silent on every broadcast in appearance.yml, now accepts either a single string exactly as before, or a list of lines. A list is sent as one chat message with a line break between entries.

Before

mute:
  blocked: "<prefix> <red>You are muted.</red> <gray>Expires: <white>{expiry}</white></gray>"

After

mute:
  blocked:
    - "<dark_gray><strikethrough>                                                  </strikethrough></dark_gray>"
    - "<color:#FF3A6E><bold>MUTED</bold></color> <gray>You cannot send messages right now.</gray>"
    - ""
    - "<dark_gray>|</dark_gray> <gray>Reason</gray> <dark_gray>»</dark_gray> <white>{reason}</white>"
    - "<dark_gray>|</dark_gray> <gray>Staff</gray> <dark_gray>»</dark_gray> <white>{staff}</white>"
    - "<dark_gray>|</dark_gray> <gray>Expires</gray> <dark_gray>»</dark_gray> <color:#1AFFB2>{expiry}</color>"
    - "<dark_gray><strikethrough>                                                  </strikethrough></dark_gray>"

• An empty entry ("") renders as a blank line
• Put <prefix> only on the line you want it on. A boxed layout usually drops it and uses a header line instead
• <newline> inside a single string does the same job, if you prefer one-liners
• Single strings are untouched, so nothing breaks on upgrade

mute.blocked and warn.received now ship as boxed multi-line lists by default. Broadcast defaults stay on one line on purpose, since they reach every player online and a multi-line announcement there turns into chat spam quickly.

🔤 Richer Placeholders on Mute and Warn

mute.blocked and warn.received now receive the full punishment placeholder set, not just {expiry} and {reason}:

These are the same names the ban and kick screens and the broadcasts already used, so one placeholder vocabulary now covers every punishment-driven message.

📌 Where To Stay On One Line

• Row templates (history.line, lists.line, alts.line, notes.line, general.audit-line, import.breakdown) accept a list too, but they repeat once per row, so a multi-line row will flood a paginated list
• Broadcasts go to everyone online. Multi-line works, but keep it short
• discord.* keys are embed titles rather than chat, and stay single-line

📝 Upgrade Notes

The new multi-line defaults will not appear on an existing server unless you regenerate messages.yml. The config updater adds new keys and removes obsolete ones, but it never overwrites a value you already have, so your existing single-line mute.blocked and warn.received are kept as they are.

To pick up the new defaults: stop the server, replace the jar in plugins/, delete plugins/PhantomBans/messages.yml so it regenerates, and start the server.

To keep your own wording: leave the file alone. Back it up and hand-edit just those two keys into list form, then run /phantombans reload. Any other key can be converted the same way, at any time.

mute:
  blocked:
    - "your first line"
    - "your second line"

To do nothing at all: that is fine too. Every existing single-line value keeps rendering exactly as it did in 1.2.1. This release is additive, with no forced migration and no change to bans, mutes, warns, or the network sync layer.

📦 Downloads

🧪 Compatibility

Minecraft 1.21 and newer, Java 21.