For game developers

Get your game listed

The Sui games catalog that rare.market and Rare OS read, every field of a games.json entry, and how a game's status is decided.

rare.market keeps one catalog of Sui games. The Games pages on rare.market and the Sui Games screen in Rare OS both read it, so a listed game shows up in both places, with its collections, token and play link.

Where the catalog lives

The catalog is a single public JSON file, a list of game entries:

Text

https://rare.market/games/games.json

curl

curl https://rare.market/games/games.json

rare.market shows each game at https://rare.market/games/<slug>, with floor and volume for its NFT collections. Collection pages link back to the game.
Rare OS reads the live file at runtime, so a status change reaches players without a launcher update. Games with status live or beta show as games and on Home; the rest wait under Coming.

Fields

Every entry in the catalog carries all of these fields. playUrl is the only one that is left out when it does not apply.

Field	Type	Required	Meaning
`slug`	string	Yes	Unique, lowercase. Used in `/games/<slug>` and as the key for the game's Rare OS profile.
`name`	string	Yes	Display name.
`studio`	string	Yes	Studio name.
`genre`	string	Yes	Short genre, for example `Crafting MMO`.
`status`	string	Yes	`live`, `beta`, `announced`, `paused` or `dead`. See Status.
`platforms`	string[]	Yes	Any of `web`, `pc`, `mobile`, `suiplay`.
`website`	string	Yes	Official site.
`x`	string	Yes	Official X account, as a URL or a handle.
`playUrl`	string	No	A URL that opens a playable state, for web games.
`description`	string	Yes	One or two plain sentences.
`logoUrl`	string or `null`	Yes	An image URL that returns an image.
`bannerUrl`	string or `null`	Yes	A wide image URL that returns an image.
`collections`	object[]	Yes	`[{ "nftType", "name" }]`: the full Move types of the game's NFTs. Use `[]` when there are none.
`token`	object or `null`	Yes	`{ "symbol", "coinType" }` for the game's coin, or `null`.
`featured`	boolean	Yes	`true` only for games that passed the alive test below.
`sources`	string[]	Yes	Links that back the entry: official site, posts, store pages.
`checkedAt`	string	Yes	Date (`YYYY-MM-DD`) the status was last proven.
`statusNote`	string	Yes	One line of evidence for the status.

Readers are lenient: an entry without a string slug and name is dropped, and a missing studio, genre, platforms, collections, sources, token or featured falls back to an empty value. The catalog itself always fills them.

Collections

nftType is the full Move type, for example 0x09af...6f00::pawtato::LAND. rare.market matches types without leading zeros in the address and in lowercase, so either form works. List every NFT type that belongs to your game; each one gets its floor and volume on the game page.

Where the game plays

For the Play button in Rare OS, the launcher picks the first of:

the playUrl in your game's Rare OS profile (see Per-game profiles),
the catalog playUrl, if it starts with https://,
the catalog website, if platforms includes web and it starts with https://.

Set playUrl when your game plays somewhere other than your website, such as a play. subdomain.

Status

A website that loads proves nothing. A game counts as alive only if at least one of these holds:

players are active on chain,
it can be played now,
the team ships: official posts in the last 30 days that show the game running.

Status	On rare.market	In Rare OS
`live`	Shown	Shown as a game
`beta`	Shown	Shown as a game
`announced`	Shown as Coming soon	Under Coming, as Announced
`paused`	Hidden	Under Coming, as Paused
`dead`	Hidden	Under Coming, as Offline

Statuses are rechecked about once a month. A paused or dead game comes back as soon as it is alive again.

Example entry

games.json

{
  "slug": "pawtato-land",
  "name": "Pawtato Land",
  "studio": "Pawtato",
  "genre": "Crafting MMO",
  "status": "live",
  "platforms": ["web"],
  "website": "https://pawtato.gg",
  "x": "https://x.com/PawtatoFinance",
  "description": "A browser MMO where heroes work land plots and craft with tools, all as NFTs, powered by the TATO token. Its land and hero collections are the most traded game items on Sui.",
  "logoUrl": "https://pawtato.gg/favicon/web-app-manifest-512x512.png",
  "bannerUrl": "https://pawtato.app/images/open-graph/pawtato-land-640x360-new.png",
  "collections": [
    {
      "nftType": "0x09afb9a1c63a9bbaba650ef0a6b473b9874882cd63aab9570b99274e8f796f00::pawtato::LAND",
      "name": "Pawtato Land"
    },
    {
      "nftType": "0xe0fa7b75a3dc8137b38bceb0c0c21c10e0f57c408fe9068694f58fd21e071925::pawtato_heroes::HERO",
      "name": "Pawtato Heroes"
    },
    {
      "nftType": "0x42482d397dd0f1dc8dab9fdf8db9b81a6d4ce9e32597ed522cde660a8773b1a9::pawtato_tools::TOOL",
      "name": "Pawtato Tools"
    }
  ],
  "token": {
    "symbol": "TATO",
    "coinType": "0x04deb377c33bfced1ab81cde96918e2538fe78735777150b0064ccf7df5e1c81::tato::TATO"
  },
  "featured": true,
  "sources": [
    "https://pawtato.gg",
    "https://dexscreener.com/sui/0xcd46e4a5ffa4fa9bf8d8c6ed1ff792699a600c450b851acb3a6021693188e882"
  ],
  "checkedAt": "2026-10-26",
  "statusNote": "534 players online on the web game; posts 2026-10-26; TATO and resource coins moving daily."
}

Getting listed

Rare adds and updates catalog entries after checking them. To be listed, have ready:

The entry
Every field above, with slug, display text, links, images, your collections' Move types and your coin type.
Evidence for the status
Links for sources that show the game is alive: a playable URL, on-chain activity, or recent official posts that show the game running.
Your Rare OS profile, for web games
The input mode and key mapping your game needs. See Per-game profiles. Test it first as described in Testing your game in Rare OS.

For web games, Rare runs each title the way the launcher does, in Chrome and in WebKit, and checks that the page loads, that Rare Wallet registers and that controller input arrives in the game's input mode.