How to put the MOTD on your server
The MOTD (message of the day) is the text under your server's name in the Multiplayer list. On a Java Edition server it comes from the
motd line in server.properties.
- Open
server.propertiesin your server folder, with your control panel's file manager or a text editor. - Find the line that starts with
motd=and replace the whole line with the first output. - Save the file and restart the server. Changes to this file only take effect after a restart.
- In Minecraft, open Multiplayer and press Refresh.
The server rewrites server.properties every time it starts, so the line may not look exactly like the one you pasted. For
the other settings in that file there is the
server.properties generator, and the
server icon maker fills the square next to your message.
How the motd property handles color codes and line breaks
A formatting code is the section sign § followed by one character. The 16 color buttons above are the color codes, and
the color codes list covers each one. These are the format codes:
| Code | What it does |
|---|---|
§l | Bold |
§o | Italic |
§n | Underline |
§m | Strikethrough |
§k | Obfuscated: the characters keep changing |
§r | Reset: default color, all formats off |
Three rules decide what goes in the file:
- Write § as
\u00A7. The file uses Java's properties format, where\uand four hex digits stand for one character. Since Java Edition 1.20 the server tries to read the file as UTF-8 and falls back to ISO 8859-1. Older versions used ISO 8859-1. A real § can break, depending on how your editor saved the file. The escaped form cannot, so the tool escapes § and every other non-ASCII character, such as ♥. - Write the line break as
\n. One setting is one line of the file, so the Enter key does not work here. - Color first, then format. In Java Edition a color code switches off bold, italic and the other formats.
§a§lgives bold green.§l§agives plain green.
The backslash is the escape character in this format, so the tool doubles any backslash you type. It also puts a backslash in
front of a leading space, because the format skips spaces right after the equals sign. Each line box starts from the default
style: if line 1 ends with a color still on, the tool puts §r at the start of line 2 so nothing carries over.
Which output to copy
| Output | Use it for |
|---|---|
| Line for server.properties | The motd= line of a Java Edition server. |
| Plain § form | A MOTD box in a control panel, or a plugin setting that expects § codes typed directly. |
| MiniMessage | Plugins and proxies that say they accept MiniMessage. |
| Line for velocity.toml | The motd setting of a Velocity proxy. |
How long a MOTD line can be
The Minecraft Wiki documents one limit: if the MOTD is over 59 characters, the server list may report a communication error. The tool counts the codes and the line break toward that number and warns you past it.
There is no fixed number of characters per line. Letters in the game's font have different widths, and bold text is drawn wider, so how much fits depends on what you write. The tool flags any line with more than 45 visible characters. That is our rule of thumb, not a limit in the game, so look at long lines in your own server list.
Hex colors, gradients and MiniMessage
A vanilla server.properties MOTD cannot use hex or RGB colors. Minecraft's text components have accepted hex colors since
1.16, but the vanilla server sends the MOTD as plain text with § codes inside it, and those codes only cover the 16 colors.
To go further you need software that sends a full text component. It takes MiniMessage tags instead of § codes:
- Velocity has its own
motdsetting invelocity.tomland accepts only MiniMessage there. As of October 2026 the default ismotd = "<#09add3>A Velocity Server". - Paper servers use a plugin. MiniMOTD takes MiniMessage with RGB
colors and gradients, and as of October 2026 it also runs on Velocity, Fabric, NeoForge, Sponge, and BungeeCord or Waterfall. It has a
line1and aline2setting, so cut the tool's output at<newline>. Players on versions older than 1.16 get the colors downsampled.
In MiniMessage, <green> and <bold> replace §a and §l. A hex color
is <#55ff55>, a gradient is <gradient:#55ff55:#55ffff>text</gradient> and the line break is <newline>. The tool turns
your codes into the matching tags. Hex colors and gradients you add by hand.
Common mistakes
-
Typing
&aintoserver.properties. The game only understands §, so the code shows up as text. This tool converts&codes for you. - Pressing Enter to start the second line. The second half becomes a separate line that the server does not read as part of the MOTD.
- Skipping the restart. Restart the server, then press Refresh in the Multiplayer list.
- Using this output on Bedrock Edition. The codes here follow Java Edition rules. Bedrock has no underline or strikethrough codes and keeps formats on after a color code.
If the server does not show up at all, the server status checker tells you whether it is reachable.
Sources
The data and rules in this tool were last checked on against:
- Minecraft Wiki: server.properties (motd, file format and encoding)
- Minecraft Wiki: Formatting codes
- Minecraft Wiki: Server list
- Minecraft Wiki: Server List Ping (how the MOTD is sent)
- Minecraft Wiki: Text component format (hex colors)
- Minecraft Wiki: Font
- Oracle Java SE 21 API: Properties.load (escapes in .properties files)
- PaperMC docs: MiniMessage format
- PaperMC docs: Velocity configuration
- PaperMC docs: legacy text serializer
- MiniMOTD on GitHub
- TOML v1.0.0 specification (string escapes)