Server Status Badge
Generate an auto-updating SVG badge showing your FiveM server's online state and player count. Copy the Markdown, HTML or BBCode and paste it anywhere.
Server
Options
Offline is always red so the badge stays honest.
Live preview
Enter a server to see the badge.
Discord: Discord does not render SVG images in embeds or chat, so pasting the badge URL will not show a preview. Link to your server or status page instead, or use the badge on your website, GitHub README or forum thread. There is no PNG version yet.
What the badge shows
The badge shows the live state of your server: 64/128 online in green when it answers, offline in red when it does not. It is not a historical uptime percentage, we don't store status history yet. Every time the image is loaded (at most about once a minute because of caching) it checks your server again.
URL format
https://fivemad.com/api/badge/<server>.svg?label=&style=&color=&labelColor=&hostname=1| Option | Values |
|---|---|
<server> | Join code (abc123), ip:port or host:port |
label | Left side text, default fivem. Empty for a value-only badge. |
style | flat (default), flat-square, for-the-badge |
color | Colour when online: a name (blue, orange...) or hex without #. Offline stays red. |
labelColor | Hex for the left side, default 555 |
hostname | 1 to use your server name (colour codes stripped) as the label |
Join code or IP?
Use the join code if your server sits behind a proxy or blocks HTTP on the game port. Use ip:port for private or unlisted servers. Private network addresses are rejected.
Caching
The badge is cached for about a minute. GitHub proxies README images through its camo cache, so a badge there can lag a few minutes behind.
Discord
Discord does not display SVG images, neither in chat previews nor in embeds, and there is no PNG version yet. For Discord, link yourstatus page or use a bot that posts the player count.
More server tools
Server Status Checker
Is a FiveM server online? Enter an IP:port or cfx.re join code for players, build, resources and map.
Profiler Analyzer
Drop a FiveM profiler JSON and see which resources and threads eat your frame or tick time, with clear fixes.
Cfx Blacklist Checker
Check whether an IP, a host or a server's join code is on the Cfx.re platform blacklist. Check a VPS before you buy it.