Coming soon

Beta access open

Minecraft server embeds that actually update.

Drop a live widget onto any website, wiki, forum, or Discord server. Shows real-time player count, online status, MOTD, Minecraft version, and a one-click vote button. Works for both Java and Bedrock.

Get early access View API docs

What are server embeds?

Your server listing - anywhere on the web.

A Minecraft server embed is a small, self-contained widget that you paste into any web page, forum post, or README. It connects to the SuperNetwork API, pings your server address in real time, and renders the live result - no back-end code required on your end.

Server admins use embeds to put a live status widget on their website landing page, their Enjin or Wix site, their Wikia page, or inside a Discord bot message. Players use the badge format inside GitHub READMEs, forum signatures, and Reddit posts.

Live player count

Updates every 1-5 minutes. Visitors see the actual number of players online right now, not a stale cached value from yesterday.

Online / offline status

A green dot when the server is reachable, red when it isn't. The embed handles network errors gracefully - no broken images.

Copy-paste install

One iframe tag. No npm package, no API key for basic use. Works on any platform that allows custom HTML.

Embed types

Four formats for every context.

Status Card

iFrame

The full widget. Displays server icon, name, MOTD, player count, version badge, and a vote button. Recommended for website landing pages and wiki sidebars.

Default size: 340 × 120 px

Status Badge

PNG image

A flat badge (like a shields.io badge) showing online status and player count. Works in Markdown, GitHub READMEs, forum signatures, and Discord bot messages.

Default size: 200 × 28 px

Vote Button

iFrame

A standalone vote button that links back to your SuperNetwork listing. Embeds into any page. Updates the vote count client-side after a successful vote.

Default size: 200 × 48 px

Leaderboard Row

iFrame

Show your current weekly ranking position, vote count, and a delta arrow (up/down from last week). Great for Discord embeds and Enjin dashboard widgets.

Default size: 340 × 72 px

Copy-paste snippets

Install in under 60 seconds.

Replace YOUR_SERVER_SLUG with the slug from your SuperNetwork listing URL. For example, if your listing is at supernetwork.dev/listing/myCoolServer then your slug is myCoolServer.

iFrame embed (website / wiki)

<iframe
  src="https://supernetwork.dev/embed/YOUR_SERVER_SLUG"
  width="340"
  height="120"
  frameborder="0"
  scrolling="no"
  style="border-radius:8px"
></iframe>

Status badge (Markdown / forums)

<!-- Status badge (SVG, works in Markdown/Discord) -->
<img
  src="https://supernetwork.dev/api/badge/YOUR_SERVER_SLUG"
  alt="Server status"
/>

Markdown badge with link (README / Reddit)

<!-- In your forum post or README -->
[![Server Status](https://supernetwork.dev/api/badge/YOUR_SERVER_SLUG)](https://supernetwork.dev/listing/YOUR_SERVER_SLUG)

REST API - fetch live data (JavaScript)

// Fetch live server data - look up by slug, then ping by id
const listing = await fetch(
  "https://api.supernetwork.dev/api/listings/by-slug/YOUR_SERVER_SLUG"
).then(r => r.json());

const status = await fetch(
  `https://api.supernetwork.dev/api/listings/${listing.id}/ping`
).then(r => r.json());
// { ok: true, status: "online", players: 42, max: 200, motd: "..." }

Discord bot (discord.js v14)

// discord.js v14 - post a live status embed
const listing = await fetch(
  "https://api.supernetwork.dev/api/listings/by-slug/YOUR_SERVER_SLUG"
).then(r => r.json());
const { status, players, max, motd } = await fetch(
  `https://api.supernetwork.dev/api/listings/${listing.id}/ping`
).then(r => r.json());

await channel.send({
  embeds: [{
    title: status === "online" ? "🟢 Server is online" : "🔴 Server is offline",
    description: motd,
    fields: [
      { name: "Players", value: `${players} / ${max}`, inline: true },
    ],
    color: status === "online" ? 0x3fb950 : 0xf85149,
    url: `https://supernetwork.dev/listing/${listing.slug}`,
    footer: { text: "Powered by SuperNetwork" },
  }],
});

Discord integration

Live status inside your Discord server.

Discord doesn't render HTML iFrames, but you have three solid options for showing your Minecraft server status:

Status badge in bot embeds

Use the badge PNG URL inside a Discord bot embed's image field. The image re-fetches each time Discord's CDN expires its cache (~10 min), giving you near-live status.

image: { url: 'https://supernetwork.dev/api/badge/SLUG' }

SuperNetwork Discord bot

Add the official SuperNetwork bot to your Discord. Run /status <server-slug> and it posts a live card with player count, MOTD, and version. Pin it to a #server-info channel.

/status myCoolServer

Custom discord.js integration

Use the REST API with your own bot. Fetch status data and build a rich embed - see the discord.js snippet above. Schedule it to update a pinned message every 5 minutes.

GET /api/listings/{id}/ping

API reference

Build your own embed.

Every SuperNetwork embed is powered by a public REST API. You can call these endpoints directly to build custom widgets, Minecraft plugins, website dashboards, or Discord bots.

GET

/api/listings/by-slug/{slug}

Auth: None

Fetch a listing by its URL slug. Returns name, id, platform, tags, and join info. Use the returned id to call the ping endpoint.

{ id, name, slug, platform, joinInfo, tags, ... }

GET

/api/listings/{id}/ping

Auth: None

Pings the listing's server directly from our infrastructure. Returns online status, player count, and MOTD. Rate-limited to 20 requests per minute per IP.

{ ok: true, status: "online", players: 42, max: 200, motd: "..." }

GET

/api/badge/{slug}

Auth: None

Returns a live SVG status badge. Supports ?style=flat (default), for-the-badge, or compact. Cached for 2 minutes at the CDN edge.

[SVG image]

POST

/api/listings/{id}/vote

Auth: Session cookie

Toggle a vote on a listing. Requires an authenticated session. Used by vote-reward plugin integrations.

{ voted: true }

Full API documentation

How we compare

SuperNetwork vs other Minecraft server lists.

Not all server list embeds are equal. Here's how SuperNetwork stacks up on embed features specifically.

Feature	SuperNetwork	top.gg / other lists	Planet MC
Live player count	✓	-	-
Online / offline status badge	✓	✓	✓
Server MOTD in embed	✓	-	-
Vote button in embed	✓	✓	-
Bedrock & Java support	✓	-	✓
iFrame embed	✓	-	-
Discord bot status card	✓	✓	-
Custom accent colour	✓	-	-
Transparent background	✓	-	-
REST API for embed data	✓	✓	-
Free tier available	✓	✓	✓

FAQ

Common questions about Minecraft server embeds.

What is a Minecraft server embed?

A Minecraft server embed is a small widget you place on your website, forum, or Discord server that displays live information about your Minecraft server - including online/offline status, current player count, server MOTD, version, and a direct vote or join button. The widget fetches data in real time so visitors always see the current state.

How does the embed know my server is online?

SuperNetwork pings your server's address at regular intervals (every 1-5 minutes depending on your plan) and caches the result. When someone loads the embed, they get the latest status without the embed itself having to open a TCP connection to your server.

Will a server embed slow down my website?

No. The embed script is loaded asynchronously and renders into an isolated iframe. It has no impact on your page's Core Web Vitals or initial load time.

Do embeds work for both Java and Bedrock servers?

Yes. SuperNetwork supports Minecraft Java Edition (TCP port 25565 by default) and Bedrock Edition (UDP port 19132 by default). The embed automatically detects which protocol to use based on your listing configuration.

Can I use the embed in Discord?

Discord does not support iFrames, but you can use the SuperNetwork status image URL directly inside a Discord bot embed field, or link the badge PNG which Discord renders inline. We also provide a Discord bot command that posts a live status card.

Is the embed free?

Yes. Basic status embeds are free for all verified listings. Advanced features like animated vote buttons, custom themes, and removal of the SuperNetwork attribution are available on paid plans.

How do I verify my server to unlock embeds?

Submit your server on SuperNetwork and complete the verification step - either by adding a TXT record to your domain or by placing a verification token in your server's MOTD. Once verified, your embed is automatically enabled.

Can I customise the embed's colours?

Yes. The embed accepts URL parameters for accent colour, background style (solid, transparent, glass), and whether to show or hide individual fields like MOTD or version number.

Get early access to server embeds.

Embeds are launching soon. Submit your server listing now and you'll be notified the moment embeds go live - and you'll get first access to the beta.

Browse listings Read the API docs