SoapsUniverse

MOTD and Server List

Last updated Oct 4, 2026

MOTD and Server List

Server-list message of the day, icon, maintenance lines, and displayed player counts. Module: motd. Config: server.yml. Permission: soapsadmin.motd. Reload: /sa reload targets that include MOTD / server settings (see /sa reload tab-complete).

Quick use

Command Effect
/sa motd Open the MOTD editor GUI when GUIs are enabled
/sa motd set <line1|line2> Set normal MOTD lines (chat prompt or args per messages)
/sa motd preview Preview the current MOTD
/sa motd icon <path> Set a 64×64 PNG server icon
/sa motd maintenance <line1|line2> Maintenance MOTD lines and enable maintenance presentation
/sa motd maxplayers <number|+N> Override max players, or add +N to the real max
/sa motd minplayers <number|-1> Floor for displayed online count, or -1 to disable

You can also open the editor from /sa admin when the MOTD panel is available.

Player counts

  • Max players applies even when MOTD text is empty. Use a fixed number or a +N offset (for example +1).
  • Min players sets a floor for the displayed online count. Use -1 to turn the floor off.
  • +N offsets do not collide with the -1 “disabled” sentinel for min players.

On Paper, SoapsAdmin sets list ping player counts at high priority so other plugins are less likely to overwrite them.

Tips

  • Keep maintenance lines ready before you flip maintenance for events.
  • After YAML edits under server.yml, reload the matching target and preview in-game.
  • Rules GUI is separate: /sa rules when the rules module is enabled. See Commands: Admin.