0xDocs 0x.limo

Docs / Store page

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 *).

html
<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 = false on 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:

bash
curl -s 'https://0x.limo/oembed?url=https%3A%2F%2F0x.limo%2Fgame%2Fplanetsmithx&format=json'
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
}
ParameterMeaning
urlA game page on 0x.limo: /game/<id>, /play/<id> or /embed/<id>. Its ref or utm_source is passed on to the embed.
formatjson (the default). Anything else answers 501.
maxwidth, maxheightShrink the frame, keeping 16:9 (never larger than 640×360)
ErrorWhen
400url is missing or not a URL
404Not a game page on 0x.limo, or no such game
503The 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.