✨ OrdiMotd — Universal Server MOTD Plugin

OrdiMotd is an all-in-one, lightweight, and modern MOTD management plugin developed by OrdiStudios. With a single universal .jar file, you can customize your server list appearance across proxies and backend servers effortlessly.

---

🚀 Key Features

• 🌐 True Universal Jar: Works natively on Paper, Purpur, Spigot, Folia, BungeeCord, Waterfall, and Velocity out of the box.
• 🎨 Hybrid Color & Gradient Engine: Combine MiniMessage tags (<gradient:#color1:#color2>, <color:#hex>, <bold>), HEX codes (&#RRGGBB or &x&R&R&G&G&B&B), and Legacy codes (&a, &l) seamlessly in the same line.
• 📐 Automatic Text Centering: Automatically centers your MOTD lines in the Minecraft server list (centered: true).
• 👥 Player Counter Control: Set a custom maximum player count or enable the Just-One-More mode (online + 1).
• 💬 Custom Hover Text (Sample Box): Display custom information lines when players hover over the player count (Supported on Paper, Purpur, Folia, BungeeCord, Waterfall & Velocity).
• 🏷️ Custom Version Protocol Text: Replace the player count/ping bar with custom text (e.g., Compatible 1.13 - 26.3).
• ⚡ Instant Reload: Apply configuration changes immediately with /ordimotd reload.

---

🎨 Supported Color Formats

You can mix and match any of these formats anywhere in your config.yml:

Format Type	Syntax Example	Description
MiniMessage Multi-Gradient	<gradient:#968EFB:#D11FFD:#FD0E55>Text</gradient>	Smooth transition between 2 or more HEX colors.
MiniMessage Solid HEX	<color:#31F400>Text</color> or <#31F400>Text	Applies a single HEX color using MiniMessage syntax.
MiniMessage Styling	<bold>, <italic>, <underlined>, <reset>	Text formatting tags.
Short HEX	&#FF66CC	Clean and compact 6-digit HEX format.
Legacy & Bungee HEX	&a, &l, &x&F&F&6&6&C&C	Classic Minecraft color and formatting codes.

---

🛠️ Commands & Permissions

Command	Alias	Permission	Description
/ordimotd reload	/omotd reload	ordimotd.admin	Reloads the config.yml file in real time without restarting.

---

⚙️ Default config.yml (Bilingual EN/ES)

# ==============================================================================
#                                  OrdiStudios
#                     OrdiMotd - Configuration / Configuración
# ==============================================================================
# [EN] Supported formats: Legacy (&a, &b, &l), HEX (&#RRGGBB or &x&R&R&G&G&B&B),
#      and MiniMessage (<color:...>, <gradient:...>, <bold>).
# [ES] Formatos soportados: Clásicos (&a, &b, &l), HEX (&#RRGGBB o &x&R&R&G&G&B&B)
#      y MiniMessage (<color:...>, <gradient:...>, <bold>).
# ==============================================================================

[EN] Main MOTD settings

[ES] Configuración principal del MOTD

motd:

[EN] Automatically center the MOTD lines in the server list

[ES] Centrar automáticamente las líneas del MOTD en la lista de servidores

centered: true line1: 'color:#31F400» gradient:#968EFB:#D11FFD:#FD0E55𝐎𝐫𝐝𝐢𝐒𝐭𝐮𝐝𝐢𝐨𝐬 | OrdiMotd' line2: 'color:#31F400» gradient:#FFFFFF:#9D9D9D1.13x - 26.3'

[EN] Player counter settings

[ES] Configuración del contador de jugadores

players:

[EN] Change the maximum player limit displayed on the server list

[ES] Cambiar el límite máximo de jugadores mostrados en la lista

custom-max: enabled: true amount: 100

[EN] If enabled, the max players will always be online players + 1 (e.g., 0/1, 15/16)

[ES] Si está activo, el máximo será igual a los conectados + 1 (ej. 0/1, 15/16)

just-one-more: false

[EN] Text displayed when hovering the cursor over the player count (0/100)

[ES] Texto que aparece al pasar el cursor sobre los jugadores conectados (0/100)

hover: enabled: true lines: - '&#FF66CC&lOrdi&#00F0FF&lStudios &7- &e2026' - '&7' - '&f¡Entra y descubre nuestras modalidades!' - '&b• &fTienda: &etienda.ordistudios.lat' - '&b• &fDiscord: &ediscord.ordistudios.lat'

[EN] Custom text displayed instead of the version/ping bar (Optional)

[ES] Texto personalizado en lugar de la barra de versión/ping (Opcional)

version-text: enabled: true text: '&aCompatible 1.13 - 26.3'

---

## 📦 Installation

1. Download the `OrdiMotd-(version).jar` file.
2. Drop it into the `plugins/` folder of your **Proxy** (*BungeeCord, Waterfall, Velocity*) or **Server** (*Paper, Purpur, Spigot, Folia*).
3. Restart your server or proxy to generate the `config.yml`.
4. Customize `plugins/OrdiMotd/config.yml` and run `/ordimotd reload`!

---

## 📊 Platform Compatibility Matrix

| Feature | Paper / Purpur / Folia | BungeeCord / Waterfall | Velocity | Spigot / Bukkit |
| :--- | :---: | :---: | :---: | :---: |
| **MOTD (MiniMessage + HEX + Legacy)** | ✅ | ✅ | ✅ | ✅ |
| **Auto-Centering** | ✅ | ✅ | ✅ | ✅ |
| **Custom Max Players / Just-One-More** | ✅ | ✅ | ✅ | ✅ |
| **Player Count Hover Text** | ✅ | ✅ | ✅ | ❌ *(API Limit)* |
| **Custom Version Text** | ✅ | ✅ | ✅ | ❌ *(API Limit)* |

---

## 🇪🇸 Información en Español

**OrdiMotd** es un plugin universal y ultraligero creado por **OrdiStudios** para personalizar el MOTD de tu servidor o network de Minecraft (**1.21 – 26.3**).

* **Un solo archivo `.jar`** compatible nativamente con **Paper, Purpur, Spigot, Folia, BungeeCord, Waterfall y Velocity**.
* **Motor de color híbrido:** Combina degradados **MiniMessage** (`<gradient:...>`, `<color:...>`), **colores HEX** (`&#RRGGBB`) y códigos clásicos (`&a`, `&l`) sin instalar dependencias externas.
* **Funciones avanzadas:** Centrado automático de líneas, límite de jugadores personalizado (`custom-max` o `just-one-more`), texto flotante al pasar el cursor (**Hover**) y texto de versión editable.
* **Recarga inmediata:** Aplica todos tus cambios al instante con `/ordimotd reload` (`/omotd reload`).

---

## 💬 Support & Community

Need help, found a bug, or want to suggest a new feature? Join our community!
* **Discord:** Join our Discord Server