Widgets
Roblox widget guide
Paste the game link, link your Roblox account, and embed a live player count.
A Roblox experience needs no ports and no server settings. Paste the game link and the name, icon and live player count fill in on their own.
What you need#
- The link to the experience:
roblox.com/games/123456789/.... - To claim it, a Roblox account you have linked to Dispresso that owns the experience.
- Manage Server in a Discord that has Dispresso, or a Dispresso login.
1. Get the server ready#
Make sure the experience is public. Copy its full link from your browser. Nothing to open, nothing to install.
Ports and settings at a glance#
| Setting | Where it lives | What to use |
|---|---|---|
| Link | The experience page on roblox.com | https://www.roblox.com/games/123456789/Your-Game |
| Ports | Not used | Roblox is read from Roblox's public data |
| Player count | Live | Total people playing across all its servers |
Firewall and host: Nothing to open. Roblox runs the servers.
2. Add it to Dispresso#
Easiest is Discord. In a server where Dispresso is, with Manage Server:
- 1Run
/gameserver setup. - 2Pick Roblox from the list.
- 3Paste the full
roblox.com/games/...link. - 4Copy the code Dispresso gives you (step 3 below) and press Check when it is in place.
https://www.roblox.com/games/123456789/Your-GamePrefer the site? Sign in, open /dashboard/servers/games, pick the Roblox chip, search for your server and press Claim. If it is genuinely missing, use the collapsed option "Server not on the list? Add it" underneath.
3. Prove it is yours#
Link your Roblox account to Dispresso, then press Check. Dispresso confirms your linked account is the experience's creator, so there is no code to paste. An experience owned by a Roblox group needs a staff check for now, contact support.
4. Put the widget on your website#
The widget needs your listing id. Open your server's page on /servers/games and look at the address bar:
https://dispresso.co/servers/games/GAME/12345The number on the end (12345 here) is the id. That is the value for data-server. You can also pin a live card in Discord, which finds the server by name or address for you (last step below).
<!-- One server: replace YOUR_LISTING_ID with the number from your listing's address -->
<div data-dispresso-game-server data-server="YOUR_LISTING_ID"></div>
<!-- Or the busiest roblox servers, top 5 -->
<div data-dispresso-game-server data-game="roblox" data-limit="5"></div>
<script src="https://dispresso.co/widgets/game-server.js?v=3" async></script>Paste it where the card should appear. It shows the name, the map when the server has one, players out of the maximum, an Online or Offline pill and when it was last checked. It follows the visitor's light or dark theme; add data-theme="dark" or "light" to force one. How to paste it into WordPress, Wix, Squarespace, Carrd and plain HTML is in Put a widget on any website.
5. Show it in Discord too#
Want the same live numbers in a channel? In the Discord where Dispresso is, with Manage Server, run:
/gameserver pin server:Your Server channel:#server-statusSearch by the Roblox server's name, its IP, IP:port or the listing id. Dispresso posts one card with players, map, status, address and a Join button, and keeps it up to date on its own, even after the bot restarts. /gameserver create does the same thing, /gameserver list shows the cards this server has and /gameserver remove takes one down. The message version works too: !gameserver pin. The card is only for a server that is already listed, so finish the steps above first.
Troubleshooting#
| What you see | Usually because | Fix |
|---|---|---|
| Could not find that Roblox game | The link is wrong or the experience is private | Paste the whole link from the address bar and make sure it is public. |
| Your linked Roblox account does not match | You linked a different account than the creator | Link the account that created the experience, or ask support if it belongs to a group. |
| The player number looks huge next to a small maximum | Roblox has many small servers, and the maximum is one server's seats | The widget shows the total as "playing" for Roblox, which is the number that matters. |
| The widget says the server is not listed right now | The id is wrong, the listing is still Pending review, it was removed, or it is marked 18+ | Open the listing page and copy the number from its address. Approved and not 18+ is the rule for every public widget. |
Still stuck? Open your listing on the site and look at the card there. The widget shows exactly what that page shows, so if the page says Offline or Unknown the problem is the listing, not the embed.
Questions people ask#
Can anyone list a Roblox game?#
Anyone can suggest a public experience. Only its creator can claim it and prove it is theirs.
Does it show my game's map?#
No, Roblox has no map field. The card shows the name and players.