Developer guide

How to connect RoList and your game

Send site likes into your live Roblox servers and trigger rewards in real time. Offline players are queued and processed on join.

End-to-end flow

RoList sends each valid like through Roblox MessagingService. Your server script subscribes, rewards online players, and queues offline players.

RoList

A player likes your listing.

To your game

A message is published with your message key.

MessagingService

Live servers receive the payload.

Your code

Grant reward now or queue for join.

Download the bridge script

One server script for ServerScriptService. Paste it as a Script (not LocalScript).

Download .lua

File name

RoListLikeBridge.server.lua

UTF-8 plain text · matches the version running on this RoList deployment

Direct link (right-click → save as): /api/download/rolist-bridge

List your game on RoList

Sign in with Roblox and submit your start place ID from List a game . Your listing must be live before likes can trigger rewards.

Sign in with Roblox and approve RoList

Use the same Roblox account that owns the listing. Approve permissions so RoList can send like events to your game.

If status stays disconnected, sign out and sign in again once.

Turn on in-game rewards on your listing

On your game page, open In-game like rewards. Confirm connection status, enable notifications, then set Universe ID (optional) and Message Key.

Message key must match CONFIG.TOPIC. Default is RoListLike.

Add the official bridge script

Use the Download section above to fetch RoListLikeBridge.server.lua, or copy it from the RoList repo at roblox/RoListLikeBridge.server.lua. In Studio, add a Script under ServerScriptService and paste the full file. Do not use a LocalScript.

For Studio DataStore testing, enable Game Settings → Security → Enable Studio Access to API Services.

Customize rewards

At the top of the script, adjust CONFIG (Message Key, DataStore, demo toggle). Implement rewards in grantRoListLikeReward—the template includes an optional leaderstats demo that adds DEMO_REWARD_AMOUNT to a leaderstats IntValue.

Offline likes are stored and replayed on PlayerAdded.

Message payload (JSON)

RoList sends a JSON string your game receives by Message Key. Your script decodes it and should check type == "rolist_like", then read userId and likeId at minimum.

{
  "v": 1,
  "type": "rolist_like",
  "userId": "123456789",
  "placeId": "987654321",
  "likeId": "rolist-like-id",
  "claimedDay": "2025-03-21",
  "nickname": "PlayerDisplayName",
  "ts": 1710000000,
  "sig": "optional-hmac-sha256-hex"
}

If you configure a signing secret on RoList, validate sig with HMAC-SHA256 over the canonical string documented in the script header. The bridge template ships without verification so you can add the approach that fits your security model.

Security & limits

Roblox connection data is stored securely and used only for enabled notification delivery—see Privacy Policy .
Only valid likes trigger publish events (site rules still apply).
MessagingService reaches running servers; DataStore queue covers offline players.

Ready to ship?

Publish your place, watch [RoList] logs, and test one like while you are in-game.

List a game Your listings