🏰 xMotd-VS

xMotd-VS is a high-performance BungeeCord proxy plugin designed to handle your server's MOTD with extreme efficiency. It features full MiniMessage and Hex color support, automatic centering, smart caching, and a complete Maintenance System.

🚀 Key Features

• ✨ MiniMessage & Hex Support: Bring your MOTD to life with modern <gradient>, <✨>, and Hex &#FF0000 tags, fully compatible with classic &c legacy codes.
• 🛡️ Maintenance Mode: Secure your server with one command. Automatically changes the MOTD, Icon, and masks the version text (e.g., "⚠ Maintenance") to hide the player count.
• 🖼️ Random Icons: Drop multiple .png images in the icons folder, and the plugin will display a random one on every ping.
• ⏳ Smart Countdowns: Use placeholders like %countdown_2026_01_01_12_00% for live event timers.
• 📏 Auto-Centering: The plugin mathematically calculates the text width (ignoring format tags) to center your MOTD perfectly on any resolution.
• ⚡ Zero-Lag Caching: Colors and formatting are pre-calculated in memory. The plugin serves the MOTD instantly from RAM.
• 👥 Custom Hover Sample: Customize the player list shown when hovering over the connection bars.

📥 Installation

1. Download the .jar file.
2. Drop it into your BungeeCord plugins folder.
3. Start your proxy.
4. Edit plugins/xMotd-VS/config.yml.
5. Run /xmotd reload to apply changes.

🛠️ Commands & Permissions

Command	Permission	Description
/xmotd reload	xmotdvs.command.reload	Reloads the configuration and refreshes the cache.
/xmotd maintenance <on/off>	xmotdvs.command.maintenance	Toggles the maintenance mode system on or off.

⚙️ Configuration (config.yml)

#                       _      _
#   __  __ /\/\   ___ | |_ __| |
#   \ \/ //    \ / _ \| __/ _` |
#    >  </ /\/\ \ (_) | || (_| |
#   /_/\_\/    \/\___/ \__\__,_|
#            v1.0.4

#   Wiki: https://xplugins.es/plugins/xmotd-vs
#      Discord: https://discord.gg/xplugins

settings:
  # Automatically centers the MOTD to align it in the server list.
  center-motd: true

  # If 'true', it will look for .png icons (64x64) in the /plugins/xMotd-VS/icons/ folder
  # and display a random one every time a player refreshes the list.
  random-icons: true


#           UPDATE CHECKER

# System to notify admins if a new plugin version is available.
update-checker:
  enabled: true
  # Message admins will see upon joining if there is an update.
  message:
    - "&b[xMotd-VS] &fNew update available: &a%version%"
    - "&fDownload it at: &n[https://modrinth.com/project/xmotd-vs](https://modrinth.com/project/xmotd-vs)"

#         MAINTENANCE SYSTEM

# You can toggle this with /xmotd maintenance on
maintenance:
  enabled: false

  # Text that replaces the game version (e.g., where it would say "BungeeCord 1.20").
  # This prevents players from seeing the real online count.
  version-text: "<red>⚠ Maintenance!</red>"

  # Specific icon to use ONLY when maintenance is active.
  # Must be located inside the 'icons' folder.
  icon: "maintenance.png"

  # MOTD to show when maintenance is active.
  motd:
    - "<bold><gradient:#ff0000:#aa0000>SERVER MAINTENANCE</gradient></bold>"
    - "<gray>We are improving the network for you.</gray>"
    - "<white>More info at: <aqua>discord.gg/xplugins</aqua></white>"


#             MOTD LIST

# The plugin will pick one of these groups at random.
# You can use Hex colors: &#RRGGBB or MiniMessage tags like <gradient:#ff0000:#ffff00>
# Countdown placeholder: %countdown_YYYY_MM_DD_HH_MM%
motds:
  default:
    - "<gradient:#ff0000:#ffff00><bold>MY SERVER</bold></gradient> <dark_gray>| <white><bold>NETWORK</bold> <gray>(1.8 - 1.21)"
    - "<white>Join now and enjoy the best quality!</white>"
  event:
    - "<✨><bold>SPECIAL EVENT!</bold></✨>"
    - "<yellow>Time left: <white>%countdown_2026_02_01_18_00%</white> to start.</yellow>"
  offer:
    - "<gradient:#FFD700:#FFA500><bold>WINTER SALE!</bold></gradient>"
    - "<aqua>Store:</aqua> <white>store.myserver.com</white> <gray>(-50% OFF)</gray>"

#           HOVER SAMPLE

# Text shown when hovering over the player count (ping bars).
sample:
  enabled: true
  lines:
    - "<aqua>xPlugins Network</aqua>"
    - ""
    - "<white>IP:</white> <green>play.myserver.com</green>"
    - "<white>Online:</white> <yellow>%online%</yellow><gray>/</gray><white>%max%</white>"
    - "<gold>24/7 Support on Discord!</gold>"

# Default icon configuration (if random-icons is false)
favicon:
  enabled: true
  file: "server-icon.png"

#          ___ _             _
# __  __ / _ \ |_   _  __ _(_)_ __  ___
# \ \/ // /_)/ | | | |/ _` | | '_ \/ __|
#  >  </ ___/| | |_| | (_| | | | | \__ \
# /_/\_\/    |_|\__,_|\__, |_|_| |_|___/
#                     |___/     v1.0.4