Award badges
Embed an MMOLove Awards winner or Server of the Year badge — the endpoint, variants, themes, and copy-paste snippets.
Award badges let winning servers show off an MMOLove Awards accolade — a static, branded SVG you embed alongside (or instead of) the live vote badge. Like the vote badge, it's wrapped in an attributed backlink.
The endpoint
GET https://mmolove.com/badge/awards/<serverId>.svg?year=2026&variant=winner&theme=light|dark- Returns
image/svg+xml— embed with a plain<img>. - The
.svgsuffix is optional but recommended in the snippet.
| Param | Values | Default | Meaning |
|---|---|---|---|
year | a year ≥ 2024 | current year | The award year shown on the badge. |
variant | winner | server-of-the-year | winner | winner → "MMOLove Awards YYYY · Winner"; server-of-the-year → "Server of the Year YYYY". |
theme | light | dark | light | Colour scheme, matching the vote badge. |
Copy-paste embed
Winner badge, wrapped in the attribution redirector (src=award-badge):
<a href="https://mmolove.com/out/<serverId>?k=website&src=award-badge" target="_blank" rel="noopener">
<img src="https://mmolove.com/badge/awards/<serverId>.svg?year=2026&variant=winner" alt="MMOLove Awards 2026 Winner" height="40" />
</a>Server of the Year, dark theme:
<a href="https://mmolove.com/out/<serverId>?k=website&src=award-badge" target="_blank" rel="noopener">
<img src="https://mmolove.com/badge/awards/<serverId>.svg?year=2026&variant=server-of-the-year&theme=dark" alt="MMOLove Server of the Year 2026" height="40" />
</a>Markdown:
[](https://mmolove.com/out/<serverId>?k=website&src=award-badge)What it shows
A star glyph followed by the accolade text — either "MMOLove Awards YYYY · Winner" or "Server of the Year YYYY" — in the same brand design language and themes as the vote badge, so the two read as a family when shown together.
Published-only + caching
- Renders only for published listings. Unknown /
pending/rejectedids return a404with a neutral fallback chip (the same graceful-degrade behaviour as the vote badge), never a broken image. - The award badge is essentially static, so it's CDN-cached for up to 24 hours.
The endpoint will render an award badge for any published server and year you pass — it doesn't gate on whether you actually won. Only embed it if your server genuinely earned the accolade; misrepresenting an award is a listing-policy violation.
See also
Vote badge
Embed the live "Ranked on MMOLove" vote badge — a self-updating SVG showing your hearts and rank, wrapped in an attributed backlink.
SDKs
Official MMOLove SDKs for the Referral Kit (sign + send events) and reward callbacks (verify heart webhooks) — Node/JS, PHP, Python, and .NET, plus the raw HMAC spec.