AdvancedBan, Layout Templates

What Are AdvancedBan Layout Templates

When a player gets banned, kicked, or muted, the message they see is controlled by AdvancedBan's layout system. Advancedban layout templates define the exact text, colors, and formatting for every punishment message. The defaults are functional but generic. Custom templates let you brand punishments with your server name, include appeal instructions, and display relevant information like the reason, duration, and punishing staff member.

For the basics of banning and muting players, see the ban and mute management guide.

Template File Location

All templates live in plugins/AdvancedBan/Layouts/. The plugin generates default files on first run:

plugins/AdvancedBan/Layouts/
  Ban.yml
  Tempban.yml
  Mute.yml
  Tempmute.yml
  Kick.yml

Each file controls the message for its punishment type. Edit these files directly, then reload with /advancedban reload.

Ban Screen Template

The ban screen is what players see when they try to connect while banned. Open Layouts/Ban.yml:

# Ban.yml
Message:
  - "&c&lAstroworld MC"
  - ""
  - "&7You are &cpermanently banned &7from this server."
  - ""
  - "&7Reason: &f%REASON%"
  - "&7Banned by: &f%OPERATOR%"
  - "&7Date: &f%DATE%"
  - ""
  - "&7Appeal at: &b&ndiscord.gg/astroworld"

Each list item is one line on the disconnect screen. The &c, &7, &f, and &b codes are Minecraft color codes. The &l makes text bold and &n adds underline. Templates use the standard & formatting system.

Placeholders

AdvancedBan provides these placeholders for use in any template:

• %REASON%, the punishment reason text
• %OPERATOR%, the staff member who issued the punishment
• %DATE%, when the punishment was issued
• %DURATION%, how long the punishment lasts (temp punishments only)
• %REMAINING%, time remaining until expiry
• %ID%, the punishment ID number
• %NAME%, the punished player's name

Use these in any template file. Not all placeholders apply to every type, for example %DURATION% is empty for permanent bans.

Temporary Ban Template

Temporary bans should show the remaining time so the player knows when they can return:

# Tempban.yml
Message:
  - "&c&lAstroworld MC"
  - ""
  - "&7You are &ctemporarily banned &7from this server."
  - ""
  - "&7Reason: &f%REASON%"
  - "&7Duration: &f%DURATION%"
  - "&7Remaining: &e%REMAINING%"
  - "&7Banned by: &f%OPERATOR%"
  - ""
  - "&7Appeal at: &b&ndiscord.gg/astroworld"

The %REMAINING% placeholder updates every time the player tries to connect, showing the current countdown. This is one of the most useful template features because it reduces "when am I unbanned" questions.

Mute Message Template

Muted players see a message in chat when they try to speak. This is not a disconnect screen, it appears in the chat window:

# Mute.yml
Message:
  - "&cYou are muted."
  - "&7Reason: &f%REASON%"
  - "&7Muted by: &f%OPERATOR%"

Keep mute messages short since they appear in the chat flow. For temporary mutes, use Tempmute.yml and include %REMAINING%.

Kick Message Template

Kicks are one-time disconnections. The player can reconnect immediately:

# Kick.yml
Message:
  - "&c&lAstroworld MC"
  - ""
  - "&7You have been &ckicked &7from the server."
  - ""
  - "&7Reason: &f%REASON%"
  - "&7Kicked by: &f%OPERATOR%"
  - ""
  - "&7You may reconnect."

Staff Notification Messages

AdvancedBan also supports notification templates for staff. When a punishment is issued, staff with the ab.notify permission see a message. Configure this in plugins/AdvancedBan/Messages.yml:

# Messages.yml (partial)
Ban:
  Notification: "&8[&cBan&8] &f%OPERATOR% &7banned &f%NAME% &7for &f%REASON%"
Mute:
  Notification: "&8[&6Mute&8] &f%OPERATOR% &7muted &f%NAME% &7for &f%REASON%"
Kick:
  Notification: "&8[&eKick&8] &f%OPERATOR% &7kicked &f%NAME% &7for &f%REASON%"

These messages broadcast to all online staff. Notification templates should be concise since they appear alongside regular chat.

HEX Color Support

On servers running Paper 1.16+, you can use hex colors in templates:

- "&#FF5555;&lAstroworld MC"
- "&#AAAAAA;You are banned."

The format is &#RRGGBB; followed by the text. This allows exact brand colors instead of the 16 default Minecraft color codes. Not all AdvancedBan versions support hex, check your version's documentation.

Summary

Advancedban layout templates give you full control over every punishment message players and staff see. Edit the YAML files in the Layouts folder, use placeholders for dynamic data, apply color codes for branding, and reload without restarting. Pair clean ban screens with a structured moderation workflow from the ban and mute guide for a professional punishment system.

Full config access on every plan: Astroworld Hosting, NVMe SSDs, Pterodactyl panel.