Integration guide

Wire MMOLove rewards into your game server. Full docs are coming soon.

Reward callbacks

When a player gives your server a heart, MMOLove sends a signed POST to your configured callback URL so you can grant an in-game reward. Configure the URL in your server's dashboard under Integration.

The JSON body (heart.counted) includes:

username — the player's in-game name (the reward recipient)
server_id, heart_id, period (YYYY-MM), timestamp (unix seconds)
streak_day — the voter's current daily vote streak, so you can grant escalating rewards (e.g. bigger bonuses at day 7, 30). Omitted if unavailable.

Verifying signatures

Each callback is signed with your server's secret (rotate it any time from the Integration tab). Verify the signature before granting a reward to ensure the request genuinely came from MMOLove.