Minecraft Server Banner

A live image of your Minecraft server: the server icon, the MOTD in its real colors, the player count with a green or red dot, the version and the ping. Put it on your website, forum signature, Discord or server list page. It updates every minute.

Quick start

https://whiscey.net/banner/<address>.png
https://whiscey.net/banner/<address>.svg

<img src="https://whiscey.net/banner/mc.tulipsmp.com.png?theme=pink" alt="Server status" width="800" height="160">

Options

.png / .svg	PNG (default) or SVG. SVG keeps the text as text, sharp at any size.
?theme=	`dark` (default), `light` or `pink`
?bedrock=true	For Bedrock servers (port 19132 unless you give one)

Themes

The MOTD always sits on a dark panel, like the in-game server list, so white and yellow text still reads on the light themes. The PNG font covers letters, numbers, small caps and common symbols such as hearts, stars, arrows and bars.

Examples

HTML

<a href="https://example.com">
  <img src="https://whiscey.net/banner/play.example.com.png" alt="play.example.com status" width="800" height="160">
</a>

Markdown (GitHub, forums)

![Server status](https://whiscey.net/banner/play.example.com.png?theme=light)

JavaScript (Discord embed)

const minute = Math.floor(Date.now() / 60000);
await channel.send({ embeds: [{ title: "Server status", image: { url: `https://whiscey.net/banner/play.example.com.png?t=${minute}` } }] });

Python

import requests
open("banner.png", "wb").write(requests.get("https://whiscey.net/banner/play.example.com.png").content)

Skript

command /banner:
    trigger:
        send "<link:https://whiscey.net/banner/play.example.com.png>&dClick to see our live server banner" to player

Java

BufferedImage banner = ImageIO.read(new URL("https://whiscey.net/banner/play.example.com.png?theme=dark"));

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.
Each banner is cached for 60 seconds. If the address is invalid or private you get a JSON error instead of an image.

Need the numbers instead? The server status API returns the same data as JSON.

FAQ

How do I make a Minecraft server banner?

Use https://whiscey.net/banner/<address>.png as an image. It updates every 60 seconds.

Can I change the colors?

Yes, add ?theme=dark, ?theme=light or ?theme=pink.

Does it work for Bedrock servers?

Yes, add ?bedrock=true.

Why does Discord show an old banner?

Discord caches images. Add a changing value like ?t=<minute> to the URL to get a fresh one.

What size is the banner?

800 by 160 pixels. The SVG version scales to any size.

Every whiscey.net Minecraft API, with all options →