FloorFeed

Guides › Badges, Moments and achievements

Build your own achievements, and every developer integration

Docs on badges.floorfeed.io has two how-tos for developers. Developer integrations lists every way to build on FloorFeed with a quickstart for each: the REST API, the JavaScript SDK, Unity and Godot, the AI connector (MCP, io.floorfeed/floorfeed in the MCP Registry), the Discord bot, webhooks, and share cards for trophy cases, badges and Moments. Build your own badges and achievements walks a game or community through an achievement system like FloorFeed's own, every step in curl, the SDK and plain words for your AI app.

Open the docs ↗

  1. Open badges.floorfeed.io and tap Docs in the top bar. Developer integrations is first, then Quickstart in 5 minutes, then Build your own badges and achievements.
  2. Get a key: on floorfeed.io, Settings → Developers → Create API key (ffsk_, server only). For your AI app, add https://floorfeed.io/api/mcp, sign in and tap Allow, then turn on Prepare trades in Settings → AI.
  3. Follow the steps: deploy a soulbound collection from your own wallet, make a game, add badges, award one (it waits until the player claims), add a webhook, make a Moment, and show a trophy case. Each step has a curl tab, a Node.js tab and an AI app tab with what to ask and the tools it calls.
Non-custodial
FloorFeed never holds your keys or your players'. Deploys and mints are signed by you, on FloorFeed or with your own key; free claims use vouchers your own server signs.
Free and paid
The Free plan works today (250 badges a month, 1 game, 3 collections, $1 of claim gas). Indie and Studio are coming soon and nothing can be charged yet.
Limits
Base only today. There's no embeddable widget script: link a trophy case or badge page and its share card unfurls, or read the JSON from your server.

Related