Vote badge

The vote badge is a small, self-updating SVG that shows your server's live heart count and rank: ♥ 1,240 · #3 · MMOLove. Paste it on your website, forum, or Discord for credible social proof. Every embed is a do-follow backlink and a referral path back to your listing — the more people who see it, the more votes you get.

The endpoint

GET https://mmolove.gg/badge/<serverId>.svg?theme=light|dark

• Returns image/svg+xml — embed it with a plain <img> (or Markdown image).
• The .svg suffix is optional (/badge/<serverId> works too), but the snippet uses .svg so it reads cleanly as an image.

Your serverId is the MMOLove server id — it's in your dashboard URL and on the Integration tab.

Copy-paste embed

The badge wraps the SVG in a link to your MMOLove listing — the do-follow backlink — via the slug-proof /s/<serverId> permalink (it keeps working even if your slug changes, and lands visitors on your ranked page where they can vote). This is exactly what the dashboard snippet produces:

<a href="https://mmolove.gg/s/<serverId>?src=badge" target="_blank" rel="noopener">
  <img src="https://mmolove.gg/badge/<serverId>.svg" alt="Ranked on MMOLove" height="40" />
</a>

Dark theme — just add ?theme=dark to the image URL:

<a href="https://mmolove.gg/out/<serverId>?k=website&src=badge" target="_blank" rel="noopener">
  <img src="https://mmolove.gg/badge/<serverId>.svg?theme=dark" alt="Ranked on MMOLove" height="40" />
</a>

Markdown (e.g. a README or wiki) — image only, no attributed wrapper:

[![Ranked on MMOLove](https://mmolove.gg/badge/<serverId>.svg)](https://mmolove.gg/out/<serverId>?k=website&src=badge)

What it shows

The badge renders, left to right: a heart glyph, this month's heart count, your rank within your game (as a #3 chip — hidden if you're unranked), and the MMOLove wordmark. It's a hand-built SVG with no external fonts or scripts, so it renders identically in an <img> sandbox everywhere.

The data is the same ranked list as the public leaderboard, so the badge's rank always matches your listing.

Live + cached

The badge is live — it reflects your current hearts and rank — but it's CDN-cached for a few minutes, so embeds stay fast and don't hammer the origin. Expect changes to show within ~5 minutes, not instantly.

Published-only + graceful degrade

• The badge only renders for published listings. An unknown id, or a pending / rejected listing, returns a 404 — pending/rejected servers never expose a public badge.
• Even on a 404, the endpoint still returns a neutral "unavailable" chip SVG (cached briefly) rather than an error. So a broken or not-yet-published embed degrades to a tidy placeholder instead of a broken-image icon — it'll start showing real numbers the moment your listing goes live.

The backlink benefit

Each embed is a do-follow link back to your MMOLove listing. That's the Product-Hunt-badge playbook applied to game servers: voluntary distribution, credible social proof, and a compounding referral + SEO path that lifts your rank as more players follow it to your page and vote.

See also