Embeds, X cards and oEmbed
Put a playable 0x game into X posts, blogs and other sites with /embed/<id>, the X player card and oEmbed; which games play inside the frame.
Every game page on the store, https://0x.limo/game/<id>, can be shared as a playable embed.
#/embed/<id>
https://0x.limo/embed/<id> is the game made for other sites' iframes. It shows a tap-to-play poster with your capsule, plays the game as a guest, and links to the full page. It is the only path on 0x.limo that any site may frame (frame-ancestors *).
<iframe src="https://0x.limo/embed/my-neon-drift" width="640" height="360"
title="Neon Drift on 0x" style="border:0;border-radius:12px;max-width:100%"
allow="fullscreen; gamepad; autoplay; clipboard-write; pointer-lock; screen-wake-lock"
allowfullscreen loading="lazy"></iframe>The default size is 640×360 (16:9), and the host site scales it. Add ?ref=<tag> to see where plays came from. The embed counts them as embed-<tag> (1–32 characters of a-z 0-9 _ -), or embed with no tag.
#Which games play inside the frame
A game plays inside the embed when all of these are true:
- it plays in the browser (a hosted or https web client; not
paper); - it doesn't need a signed-in 0x account to join;
- it is free (not priced, not subscribers-only);
- it hasn't opted out (
universe.embed = falseon the catalog entry, which 0x sets on request).
Any other game shows its poster and an Open full page button.
#X (Twitter) player cards
Game page links posted on X unfurl as a player card (twitter:card = player): the post plays the game through /embed/<id>, at 640×360, with your capsule as the fallback image. Games that can't play in the frame (see above) get a summary_large_image card instead. You don't need to do anything: just post https://0x.limo/game/<id>. The link's ?ref= is carried into the embed.
Note
X decides whether to show player cards for a domain. If a post shows the large image instead of the player, the card still links to the game page.
#oEmbed
Sites that support oEmbed (blogs, CMSs, Discord-style unfurlers) can discover the embed from the game page's <link rel="alternate" type="application/json+oembed">, or ask for it directly:
curl -s 'https://0x.limo/oembed?url=https%3A%2F%2F0x.limo%2Fgame%2Fplanetsmithx&format=json'{
"version": "1.0", "type": "rich", "provider_name": "0x", "provider_url": "https://0x.limo/",
"title": "PlanetSmithX", "author_name": "0x Examples",
"html": "<iframe src=\"https://0x.limo/embed/planetsmithx\" width=\"640\" height=\"360\" …></iframe>",
"width": 640, "height": 360, "cache_age": 3600,
"thumbnail_url": "https://0x.limo/og/game/planetsmithx.png?v=…", "thumbnail_width": 1200, "thumbnail_height": 630
}| Parameter | Meaning |
|---|---|
url | A game page on 0x.limo: /game/<id>, /play/<id> or /embed/<id>. Its ref or utm_source is passed on to the embed. |
format | json (the default). Anything else answers 501. |
maxwidth, maxheight | Shrink the frame, keeping 16:9 (never larger than 640×360) |
| Error | When |
|---|---|
400 | url is missing or not a URL |
404 | Not a game page on 0x.limo, or no such game |
503 | The catalog is briefly unavailable |
#Share tags
Game pages also carry Open Graph tags (og:title, og:description, og:image, og:type = video.game) and schema.org VideoGame JSON-LD built from your listing: title, description, developer, tags, approval date. Write the tagline and description with that in mind. They are what link previews show. Image sizes: Store art.
