Developer guide

How to connect BloxList and your game

Wire BloxList’s daily likes to your Roblox servers in near real time. Players who like your game on the site can receive in-game rewards instantly—or the moment they join if they were offline when the like happened.

End-to-end flow

BloxList never runs inside your place. Your site sends one signed Open Cloud publish per valid like; your servers consume it with MessagingService.

BloxList

User likes your listing (once per UTC day).

Open Cloud

BloxList calls publish on your universe.

MessagingService

Live servers receive JSON on your topic.

Your code

Grant rewards or queue for next join.

Download the bridge script

One file for ServerScriptService. Save it, open Roblox Studio, create a Script (not LocalScript), paste the contents—or drop the downloaded file into Studio if your workflow supports it.

Download .lua

File name

BloxListLikeBridge.server.lua

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

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

List your experience on BloxList

Sign in with Roblox and submit your start place id from the List a game flow. Your listing must be approved and live before players can like it on the site.

Create a Roblox Open Cloud API key

In the Creator Dashboard → Credentials, create an API key for this experience’s universe with the scope universe-messaging-service:publish. Keep the key secret—treat it like a password.

Reference: Roblox Open Cloud documentation.

Enable integration on BloxList

Open your game’s detail page while signed in as the owner. In In-game like rewards, turn on notifications and paste your Open Cloud key. Optionally set a Universe id (or leave it blank to auto-resolve from your place id) and a topic name.

The topic string must match CONFIG.TOPIC in your server script. The default on both sides is BloxListLike.

Add the official bridge script

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

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

Customize rewards

At the top of the script, adjust CONFIG (topic name, DataStore name, demo toggle). Implement your economy inside grantBloxListLikeReward—the template includes an optional demo that adds DEMO_REWARD_AMOUNT to a leaderstats IntValue.

Offline players: likes are stored in DataStore and replayed automatically on PlayerAdded, so rewards can fire as soon as they join.

Message payload (JSON)

BloxList publishes a JSON string. Your script decodes it and should at minimum check type == "bloxlist_like" and read userId and likeId.

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

If you configure a signing secret on BloxList, 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.

Operations & trust

BloxList stores your Open Cloud key encrypted when BLOXLIST_REWARD_ENCRYPTION_KEY is set on the server (required in production for saving keys).
Likes are still subject to BloxList rules (e.g. one like per user per UTC day site-wide). Only successful likes trigger a publish.
MessagingService broadcasts to running servers; use the included DataStore queue so offline players are not left out.

Ready to ship?

Publish your place, watch Output for [BloxList] logs, and ask a friend to like your listing on the site while you are in-game.

List a game Your listings