MC-Server-Banner-API

Read usage documentation for an API that generates Minecraft server status banners.

github.com/LOOHP/MC-Server-Banner-API
MC-Server-Banner-API homepage screenshot

About MC-Server-Banner-API

MC-Server-Banner-API documents an API that generates Minecraft server status banners as PNG images through HTTP GET requests. A basic request using a server IP returns a banner with a default dirt background, with options to set width, display name, port, offline message, background image, ping icon value, timezone, and date format.

Generated banners are cached for 5 minutes. Background images must be provided by the user at the correct dimensions, and ping values are supplied manually rather than measured by the service.

Key features

  • Generates PNG banner via HTTP GET with server IP
  • Custom banner width, defaults to 1836
  • Custom top-line name and offline message text
  • Custom background image URL or transparent option
  • Manual ping value for ping icon display
  • Custom timezone and date format in footer
Best for: Minecraft server owners who want to show server status in a shareable banner image.
Good for
  • Customizes banner text, background, size, and footer through URL parameters
  • Provides a Web Editor to generate request URLs
  • Source code is available under GPL-3.0 license
Watch out for
  • Output is cached for 5 minutes
  • User must supply background images with correct dimensions
  • Ping icon value is not measured automatically

MC-Server-Banner-API at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

MC-Server-Banner-API alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in Game Servers & Multiplayer

Well-known listings from the same topic.

All 66

MC-Server-Banner-API FAQ

How do I create a basic banner?
Request https://api.loohpjames.com/serverbanner.png?ip= to generate a banner with the default dirt background, cached for 5 minutes.
Why is the ping not measured?
Because whether the ping is good or not from the API server is not useful to the end user, so a ping value is supplied manually for the icon.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing