Custom MOTD Plugin for Paper

A plugin for Paper servers that allows easy customization of the message of the day (MOTD), player limit, and hover information displayed when mousing over the player count in server lists. Compatible exclusively with Paper and utilizes the modern PaperServerListPingEvent event handling system. Designed with simplicity in mind and optimized for the latest game versions.

Commands and Permissions

Two commands are available, both requiring the custommotd.admin permission:

• /max-players <number> (alias: /set-max-players) — set the maximum player count directly in-game while also saving it to configuration
• /motd-reload — reload the configuration file

Default Configuration

# Uses Adventure's MiniMessage: https://docs.advntr.dev/minimessage/format.html
motd:
  line1: "First line"
  line2: "Second line"

# Uses legacy color codes (e.g., §a, §1)
enable_hover_message: true
player_hover_message:
  - "First line"
  - "Second line"

# Set -1 to leave unchanged
max_players: 50