MMOLove Developer Platform
Wire MMOLove into your game server — reward voters, reward referrers, and show off your rank.
These are the developer docs for integrating MMOLove into your game server. MMOLove ranks game servers by player love — votes are hearts — and the platform gives you three ways to turn that into growth: reward the players who vote for you, reward the players who bring their friends, and show off your standing with an embeddable badge.
A common thread runs through all of them: MMOLove handles attribution; you own the in-game economy. We tell you who voted or who referred a friend; you decide what the reward is and grant it on your terms.
The pieces
Reward Callbacks
The core vote→reward loop. A player hearts your server → MMOLove POSTs a signed heart.counted → you grant the in-game reward.
Referral Kit
Reward the players who bring their friends. We track the click → register → qualify journey; you grant the reward when a referral qualifies.
Badges
Embed a live 'Ranked on MMOLove' vote badge (or an award badge) — credible social proof + a do-follow backlink that lifts your rank.
SDKs
Official packages that wrap the referral + callback HMAC for you — Node, PHP, Python, .NET. npm i @mmolove/referral, pip install mmolove-callback, dotnet add package MMOLove.Referral, or a single-file PHP drop-in.
API reference
The machine-readable Referral API contract + a downloadable OpenAPI 3.1 spec for Postman / client generators.
Where to start
- You run a server and want to reward voters → start with Reward Callbacks (or the 5-minute quickstart).
- You want a referral / "invite a friend" reward → start with the Referral Kit.
- You just want social proof on your site → grab a vote badge — no code required.
How the integrations relate
Reward Callbacks and the Referral Kit are separate webhooks for different moments, and they sit on opposite ends of the request:
| Reward Callbacks | Referral Kit | |
|---|---|---|
| Trigger | a player votes for you | a referred player registers / qualifies |
| Direction | MMOLove → you (we POST, you verify) | you → MMOLove (you POST, we verify) |
| You reward | the voter | the referrer |
| Event | heart.counted | registered / qualified |
Both share the same HMAC-SHA256 signing core (sign over the raw body, t in the
X-MMOLove-Signature header) — they differ only in the v1 header encoding. If
you've integrated one, the other's signing is mostly reuse. See the
reward-callback signing notes.
No SDK required — any language that can compute an HMAC-SHA256 and speak HTTPS can
integrate every part of the platform. But if you'd rather not write the boilerplate,
the official SDKs wrap it for Node, PHP, Python, and .NET
(npm i @mmolove/referral, pip install mmolove-callback,
dotnet add package MMOLove.Referral, or a single-file PHP drop-in).