plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "heynakama",
  "version": "1.0.2",
  "description": "A fast portrait reflex arcade game where HeyNakama calls the moves.",
  "author": {
    "name": "Snappy Fox Ltd",
    "email": "hello@snappyfox.co.uk",
    "url": "https://www.snappyfox.co.uk"
  },
  "homepage": "https://heynakama.snappyfoxgames.co.uk/game",
  "keywords": [
    "arcade",
    "game",
    "reflex",
    "heynakama"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HeyNakama",
        "shortDescription": "Do what the bot says.",
        "longDescription": "HeyNakama is a fast portrait reflex game where the bot sees hazards before you do and calls LEFT, RIGHT, JUMP, or DUCK. Launch a normal run, today's shared Daily Run, or a deterministic BUDDY challenge. Runs happen entirely inside the interactive component and no account is required.",
        "developerName": "Snappy Fox Ltd",
        "category": "Entertainment",
        "capabilities": [
          "Launch a normal HeyNakama run",
          "Open today's deterministic Daily Run",
          "Validate and open a BUDDY challenge"
        ],
        "websiteURL": "https://heynakama.snappyfoxgames.co.uk/game",
        "supportURL": "https://heynakama.snappyfoxgames.co.uk/support",
        "privacyPolicyURL": "https://heynakama.snappyfoxgames.co.uk/privacy",
        "termsOfServiceURL": "https://heynakama.snappyfoxgames.co.uk/terms",
        "defaultPrompt": [
          "Start HeyNakama.",
          "Start today's HeyNakama Daily Run.",
          "Start HeyNakama challenge BUDDY-21I3V9."
        ],
        "brandColor": "#8753ED",
        "brandColorDark": "#B79CFF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Launch a normal HeyNakama run.",
              "prompt": "Start HeyNakama.",
              "tools_triggered": "start_game",
              "expected_behavior": "The assistant reports that HeyNakama launched successfully, the result has status='launched' and mode='endless', and the interactive game component shows the portrait HeyNakama start screen."
            },
            {
              "description": "Open the daily shared run.",
              "prompt": "Start today's HeyNakama Daily Run.",
              "tools_triggered": "start_daily_run",
              "expected_behavior": "The assistant reports that the Daily Run launched successfully, the result has status='launched', mode='daily', today's dailySeedLabel, and the interactive game component shows the HeyNakama start screen."
            },
            {
              "description": "Open a valid shared challenge.",
              "prompt": "Start HeyNakama challenge BUDDY-21I3V9.",
              "tools_triggered": "start_challenge",
              "expected_behavior": "The assistant reports that the challenge launched successfully, the result has status='launched', challengeCode='BUDDY-21I3V9', and the interactive game component shows the BUDDY CHALLENGE INCOMING start screen."
            },
            {
              "description": "Launch from a natural request to play.",
              "prompt": "I want to play HeyNakama.",
              "tools_triggered": "start_game",
              "expected_behavior": "The assistant reports that HeyNakama launched successfully, the result has status='launched' and mode='endless', and the interactive game component shows the portrait HeyNakama start screen."
            },
            {
              "description": "Launch a practice run for the game's commands.",
              "prompt": "Open HeyNakama so I can practise LEFT, RIGHT, JUMP, and DUCK.",
              "tools_triggered": "start_game",
              "expected_behavior": "The assistant reports that HeyNakama launched successfully, the result has status='launched' and mode='endless', and the interactive game component shows the start screen and command controls."
            }
          ],
          "negative": [
            {
              "description": "Reject an invalid challenge code without launching a run.",
              "prompt": "Start HeyNakama challenge BUDDY-NOT-A-CODE.",
              "tools_triggered": "start_challenge",
              "expected_behavior": "The tool validates the request and returns status='invalid_challenge' for BUDDY-NOT-A-CODE. The assistant states that the code was not recognised and no run was launched; the component shows CHALLENGE CODE REJECTED rather than a generic tool failure."
            },
            {
              "description": "Do not invoke the arcade game for an unrelated game recommendation.",
              "prompt": "Recommend a cooperative board game for four people.",
              "expected_behavior": "The assistant answers normally with board-game recommendations and does not invoke any HeyNakama MCP tool."
            },
            {
              "description": "Do not invoke the game for account or personal-data requests.",
              "prompt": "Show me my ChatGPT account email address.",
              "expected_behavior": "The assistant does not invoke any HeyNakama MCP tool and explains that HeyNakama cannot access or display the user's ChatGPT account email."
            }
          ]
        },
        "demo_recording_url": "https://heynakama.snappyfoxgames.co.uk/review/heynakama-review-walkthrough.mp4",
        "commerce": false,
        "commerce_description": "HeyNakama is a free arcade game and does not sell products, subscriptions, or digital goods."
      },
      "publication": {
        "release_notes": "HeyNakama submission using https://heynakama.snappyfoxgames.co.uk/mcp. Includes normal runs, Daily Runs, deterministic BUDDY challenges, explicit invalid-challenge handling, MCP Apps lifecycle support, portrait sizing, optional post-run coaching, five positive and three negative review cases, and the review walkthrough."
      },
      "apps": "./.app.json"
    }
  }
}