
Crafting Eye-Catching Minecraft MOTDs with MiniMOTD
jpenilla/MiniMOTD
Minecraft server/proxy plugin to set the server list MOTD using MiniMessage for formatting, supporting RGB colors.
View on GitHub ↗Your Minecraft server's MOTD is the first thing players see in the multiplayer menu. If it's just plain text, you're wasting an opportunity to stand out. MiniMOTD adds vibrant RGB colors, gradients, and formatted text to make your server impossible to miss.
What MiniMOTD Is and Why It Matters
Think about the multiplayer server list. You're scrolling through 100 servers, and most of them have generic MOTDs: "Welcome to MyServer" or "Survival PvP". A few servers jump out. Those are the ones with colorful, eye-catching messages.
MiniMOTD is a Java plugin that gives you the tools to create those standout MOTDs. It's available for practically every major Minecraft server platform. The trick is that it uses MiniMessage, a text formatting system from the Paper project, to give you access to millions of RGB color combinations instead of Minecraft's standard 16 colors.
Here's the real draw: if someone joins your server on a modern client (1.16 or later), they see the full RGB glory. On older clients? MiniMOTD automatically downsamples to colors they can see, so nobody's left with a broken message.
Installing MiniMOTD for Your Setup
MiniMOTD ships with separate downloads for each platform, which sounds complicated but is actually pretty clean. You're not jamming a one-size-fits-all JAR and hoping it works.
For Paper-Based Servers
Paper is what most mid-size servers run. Grab the appropriate JAR (the "-paper" version if you're on Minecraft 26.1.2 or newer, otherwise the "-bukkit" version for earlier releases), drop it into your plugins folder, and restart.
# Copy the JAR into: server/plugins/
# Then restart the server
# Or use: /reload if supportedIf You're Running Fabric
Fabric isn't as common, but it's growing. First grab Fabric API from Modrinth, then download the MiniMOTD JAR. Throw both in your mods folder.
# Download: Fabric API and MiniMOTD JAR
# Place both into: server/mods/
# Restart the serverProxies (Velocity, Waterfall, Bungeecord)
Running a proxy means multiple backend servers sharing one entry point. Install MiniMOTD on the proxy, and players see your custom MOTD before connecting to any backend server. Waterfall and Bungeecord use the same JAR, which makes things convenient.
# Place JAR into: proxy/plugins/
# Restart the proxyOther Platforms: NeoForge and Sponge
Both exist and are supported, but they're less common. Check the releases page for the right download. The GitHub wiki has platform-specific notes if you hit issues.
Coloring Your MOTD with MiniMessage
This is where MiniMOTD gets fun. Once it's installed, you're editing a config file and writing text using MiniMessage tags. It's basically HTML for Minecraft text.
The simplest approach is using named colors:
<red>Welcome!</red> <blue>Join Now</blue>If you want specific RGB colors, use hex codes:
<color:#FF5733>Custom Orange</color>Gradients are where things look genuinely impressive:
<gradient:blue:purple>Fade between colors</gradient>You can also do rainbow gradients:
<rainbow>RAINBOW TEXT LOOKS COOL</rainbow>The config file is YAML, which means indentation matters (use spaces, not tabs). I've seen people lose an hour to a misaligned tag or a missing quote. Double-check your syntax before reloading. MiniMessage tags need to be properly closed. An unclosed tag will break the parser and you'll see errors in the logs. It's not hard to get right - just keep your angle brackets in pairs.
Testing and Refining Your MOTD
After you've configured everything, you'll want to see what it looks like before players see it. The easiest way is to run a local test server and join it from the multiplayer menu.

If you want a faster preview without spinning up a server, try the Minecraft MOTD Creator tool to see how your formatted text will render. It won't be 100% identical to how the game displays it, but it's close enough for previewing color choices and layout.
Once you're happy, reload the plugin or restart the server. Players will immediately see the new MOTD. If you need to verify your server's MOTD is being broadcast correctly, the Minecraft Server Status Checker can pull your server info and show you what clients are seeing. Good for debugging if things look weird.
Common Gotchas and Limitations
RGB colors only work on modern clients. That means if someone's playing on Minecraft 1.15 or older, MiniMOTD will downgrade your colorful gradient to the nearest standard color. It still looks okay - the plugin's smart about it - but they won't see the full RGB range.
Proxies and newer servers (1.16+) can send RGB colors to modern clients. Older servers can't, even with MiniMOTD installed, because the Minecraft protocol itself didn't support it.
YAML syntax errors in the config will silently break things. The plugin logs an error, but if you're not checking logs, you'll wonder why your new MOTD didn't load. Check indentation and quotes first.
One last thing worth mentioning: the performance impact is basically zero. The plugin renders your MOTD once at startup and caches it. There's no per-connection overhead or recurring processing, even with complex gradients and rainbow effects. It's completely safe to go wild with formatting.
Other Options Worth Considering
MiniMOTD isn't the only way to customize your MOTD, though it's probably the most flexible. Some admins just use basic Bukkit/Spigot MOTD plugins that don't require RGB support. They're simpler but limited to 16 colors.
Others set the MOTD in the proxy config (for Bungeecord) and skip a plugin entirely. But again, you're capped at standard Minecraft colors. If you're already thinking about running Waterfall (Paper's proxy fork), it has better built-in formatting support than Bungeecord, which makes MiniMOTD less essential. But the plugin still works and gives you more control.
MiniMOTD wins because it's actively maintained (the latest version supports Minecraft 26.1.2), widely compatible across platforms, and genuinely makes your server look better in the server browser.


