FloorFeed

Guides › Badges, Moments and achievements

FloorFeed Badges for game studios

FloorFeed Badges (badges.floorfeed.io) gives your players achievements they keep for good: soulbound badges on Base, awarded with one API call and claimed with an email, a passkey or the player's own wallet, with FloorFeed paying the gas. You deploy and own each collection from your own wallet; FloorFeed never holds your keys or your players'.

  1. Sign in on badges.floorfeed.io and open Dashboard.
  2. Deploy a soulbound collection for your badge from your own wallet: the Dashboard links to floorfeed.io/soulbound.
  3. Under Games, type a name and tap New game. Then give a badge key (first-win) and a name, pick the collection, and tap Add badge. Turn on Client-awardable only for badges a game build may award itself.
  4. Create API key (in the API keys card) for your server. For a game with no server, tap Create publishable key under the game.
  5. Award from your server with the SDK or POST /v1/badges/award. Each game's line shows awarded, claimed and the median time to claim.
  6. Players: type a player id and tap Look up to see their badges. Webhooks: paste your https endpoint and tap Add endpoint (keep the signing secret), then Send test event and Deliveries. Players' claim gas shows what's used; Set cap sets a lower monthly limit.
  7. Team: Invite a developer or Invite a viewer makes a one-time link (7 days) to send your teammate. They open it signed in to join.
  8. On a team? The Account card at the top of the Dashboard lists My account and each studio you joined: tap one to work on its games. A developer can add games, badges and award; a viewer can only look. The studio's API keys, billing, webhook secrets, gas cap and team stay with its owner.
Plans
Free is open now: 250 badges a month, $1 of claim gas, 100 players a month who sign in to claim (players with their own wallet are unlimited). Paid plans (Indie $29, Studio $199) are coming soon; the Pricing page and the Billing card say Coming soon and nothing can be charged. Enterprise from $1,000: [email protected].
SDKs
JavaScript/TypeScript (install from floorfeed.io until it's on npm) and plain REST for any engine; a Godot 4 addon to download; a Unity package in preview (Docs → Unity and Godot). Server keys (ffsk_) never go in a game build.
Terms
Using the API means agreeing to the Developer Terms, the Acceptable use and badge content policy, and, for player data, the Data processing terms (links at the foot of every badges.floorfeed.io page).
Not for Steam games
Steam forbids games that issue NFTs. Web, itch.io, Epic and mobile games can use it; badges never unlock paid features.
Limits
Base only for now. Publishable keys award one player at a time and each badge once per player; anyone can read them from a game build, so client-awarded badges can be cheated.

Related