Skills

remix-game-sdk

Installation
SKILL.md

Remix Game SDK Reference (@remix-gg/sdk)

Use this file when generating or repairing game code for Remix.

Runtime model

  • In Remix-hosted uploads, the SDK is available as window.RemixSDK.
  • window.FarcadeSDK is still assigned as a backward-compatible alias, but new code should use window.RemixSDK.
  • Include SDK script in the HTML <head>:
    • <script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script>
  • Do not rely on package imports in uploaded single-file game code.
  • Always call await window.RemixSDK.ready() before reading player/game data.

Required hooks for v1 agent validation

These checks are required by GET /v1/games/{gameId}/versions/{versionId}/validate:

  • window.RemixSDK.singlePlayer.actions.gameOver({ score })
  • window.RemixSDK.onPlayAgain(() => { ... })
  • window.RemixSDK.onToggleMute(({ isMuted }) => { ... })

Commonly used SDK surface

Properties/getters:

  • window.RemixSDK.player
  • window.RemixSDK.players
  • window.RemixSDK.gameState
  • window.RemixSDK.gameInfo
  • window.RemixSDK.purchasedItems
  • window.RemixSDK.inventory
  • window.RemixSDK.shopItems
  • window.RemixSDK.isReady
  • window.RemixSDK.hasItem(itemId)
  • window.RemixSDK.getItemPurchaseCount(itemId)
  • window.RemixSDK.getShopItem(slug)

Useful gameInfo fields:

  • viewContext for feed/full-screen/challenge/tournament context
  • contentSafeAreaInset for overlay-safe mobile layout
  • initialGameState for persisted state hydration

Single-player actions:

  • window.RemixSDK.singlePlayer.actions.gameOver({ score })
  • window.RemixSDK.singlePlayer.actions.saveGameState({ gameState })
  • window.RemixSDK.purchase({ item })
  • window.RemixSDK.onPurchaseComplete(({ success, item }) => { ... })
  • window.RemixSDK.singlePlayer.actions.reportError({ message, ... })
  • window.RemixSDK.hapticFeedback()

Multiplayer actions:

  • window.RemixSDK.multiplayer.actions.gameOver({ scores })
  • window.RemixSDK.onGameStateUpdated(callback)

Multiplayer actions/events are optional for basic single-player games.

Minimal integration template

async function initGame() {
  const sdk = window.RemixSDK
  await sdk.ready()

  let muted = true
  sdk.onToggleMute(({ isMuted }) => {
    muted = isMuted
  })

  sdk.onPlayAgain(() => {
    restart()
  })

  function finish(score) {
    sdk.singlePlayer.actions.gameOver({ score })
  }

  function save(state) {
    sdk.singlePlayer.actions.saveGameState({ gameState: state })
  }

  function restart() {
    // reset local game state and render
  }

  // start gameplay loop...
}

initGame()

Mistakes to avoid

  • Calling SDK getters before ready() resolves.
  • Omitting one of the required validation hooks (gameOver, onPlayAgain, onToggleMute).
  • Using non-existent SDK methods such as vibrate, checkpoint, or save.
  • Using singlePlayer.actions.purchase(...) in new code when the SDK exposes sdk.purchase(...).
  • Ignoring contentSafeAreaInset when HUD or controls can collide with mobile overlays.
  • Using localStorage/sessionStorage as primary persistence instead of saveGameState.
Related skills

More from farworld-labs/remix-skills

Installs
31
Repository
farworld-labs/r…x-skills
GitHub Stars
10
First Seen
Mar 5, 2026
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykWarn