Minecraft MOTD Formatter

Type a MOTD with color codes and see how it looks, or use the API to turn Minecraft formatting into HTML, plain text, a chat component or a PNG. It understands & and § codes, hex colors, Spigot hex, and MiniMessage tags including gradients.

Try it

Need a gradient? Make one with the RGB gradient generator and paste it here.

API

GET https://whiscey.net/api/motd?text=<text>
GET https://whiscey.net/render/motd.png?text=<text>&scale=2

text	Up to 2000 characters, URL-encoded. New lines as line breaks or `\n`.
amp	`false` to ignore `&` codes (only `§`)
mini	`false` to ignore MiniMessage tags
scale	PNG pixel size, 1-4 (default 2)
bg	PNG: `false` for a see-through background

The JSON has html, plain, legacy (§ codes, hex as §x), component (a JSON chat component) and image.

Codes it reads

&0-&f	Colors: 0 black, 1 dark blue, 2 dark green, 3 dark aqua, 4 dark red, 5 purple, 6 gold, 7 gray, 8 dark gray, 9 blue, a green, b aqua, c red, d pink, e yellow, f white
&l &o &n &m &k &r	Bold, italic, underline, strikethrough, obfuscated, reset
&#RRGGBB	Hex color
&x&R&R&G&G&B&B	Spigot hex color
<#RRGGBB>, <red>, <color:#hex>	MiniMessage colors
<b> <i> <u> <st> <obf>	MiniMessage decorations (long names work too)
<gradient:#a:#b>, <rainbow>	Gradients with any number of colors, and rainbow
<reset>, <newline>, <br>	Reset and line break

Examples

HTML

<img src="https://whiscey.net/render/motd.png?text=%26aMy%20%26lServer" alt="MOTD">

JavaScript

const r = await fetch("https://whiscey.net/api/motd?text=" + encodeURIComponent("&aHello <bold>world"));
document.querySelector("#motd").innerHTML = (await r.json()).html;

Python

import requests
j = requests.get("https://whiscey.net/api/motd", params={"text": "<rainbow>Hello"}).json()
print(j["legacy"])  # §x§f§f§0§0§0§0H...

Skript

command /motdpreview <text>:
    trigger:
        send "<link:https://whiscey.net/render/motd.png?text=%arg-1%>Click to preview your MOTD" to player

Java

String url = "https://whiscey.net/api/motd?text=" + URLEncoder.encode(text, StandardCharsets.UTF_8);

Limits and caching

No key or sign-up. CORS is open (Access-Control-Allow-Origin: *).
120 requests a minute per IP across the status, banner, player and MOTD APIs. Over that you get 429 and a Retry-After header.
The same text always gives the same result, so results are cached for a day.

FAQ

How do I add colors to my Minecraft MOTD?

Use & or § color codes like &a for green, &#ff66cc for hex colors, or MiniMessage tags like <gradient:#ff66cc:#66ccff>. Paste it above to see how it looks.

How do I convert Minecraft color codes to HTML?

Request https://whiscey.net/api/motd?text=<your text> and use the html field.

Does it support MiniMessage?

Yes, the basics: colors, hex, decorations, gradient, rainbow, reset and newline.

Can I get an image of my MOTD?

Yes, https://whiscey.net/render/motd.png?text=<your text> draws it like the game does.

What does &k do?

It makes text obfuscated (random changing characters). In the HTML it gets class="mc-obfuscated" so you can animate it yourself.

Every whiscey.net Minecraft API, with all options →