ios-game-testing

What problem does it solve?

The Skill provides automated testing for the Nathaniel SpriteKit iOS game using the embedded GameCommandServer HTTP API, reducing manual QA time and ensuring features behave correctly in the simulator.

Core Features & Use Cases

• Automated UI Interaction: Use GameCommandServer API (port 8765) for deterministic, coordinate-accurate testing of the SpriteKit game.
• End-to-End Test Steps: Build, run, health check, state inspection, and scripted actions to validate features end-to-end.
• Test Scenarios: Navigate from Main Menu to Level Select, start a level, toggle characters, move units, target enemies, and verify camera behavior.
• Visual Verification: Obtain screenshots via the API or XcodeBuildMCP tooling for visual QA.

Quick Start

Build and run the game in a simulator, then use the GameCommandServer API to drive tests. For example:

• Start the simulator and app
• Wait for the server to be healthy at http://localhost:8765/health
• Retrieve the current game state with http://localhost:8765/state
• Perform actions via http://localhost:8765/action with a JSON payload like {"name":"startGame"}