SQL Gameplay

Test the game through database tools.

Announce: "I'm using gameplay-sql to test via database."

Game Tools

Tool	Purpose
`game_start`	Start a new game
`game_state`	See current question/guess/candidates
`game_turn`	Answer yes/no/not_sure
`game_submit`	Submit correct place (give up)
`game_find_place`	Search places by name
`game_summary`	Review completed session (history + result)

Complete Game Flow

1. Start a Game

code

game_start(description: "A medieval castle on a hilltop in Poland")

Returns: session_id, initial question, top candidates

2. Check State (optional)

code

game_state(session_id: "abc123...")

Returns: current status, question or guess, top candidates

3. Answer Questions

code

game_turn(session_id: "abc123...", answer: "yes")
game_turn(session_id: "abc123...", answer: "no")
game_turn(session_id: "abc123...", answer: "not_sure")

Returns: new state after answer

4a. If Game Guesses Correctly

code

game_turn(session_id: "abc123...", answer: "yes")

Game ends with status: won

4b. If Game Gives Up or Guesses Wrong

First, find the correct place:

code

game_find_place(name: "Wawel")

Then submit it:

code

game_submit(session_id: "abc123...", osm_id: "way/123456")

Example Session

code

> game_start(description: "A famous tower in Paris")

SESSION: 7f3a2b1c-...

status   | question                          | candidate_count
---------+-----------------------------------+----------------
active   | Is this place in Western Europe?  | 15

TOP CANDIDATES:
place           | confidence
----------------+-----------
Eiffel Tower    | 45%
Notre-Dame      | 22%
Arc de Triomphe | 12%

> game_turn(session_id: "7f3a2b1c-...", answer: "yes")

status | question                    | guess
-------+-----------------------------+------
active | Is it a metal structure?    | 

TOP CANDIDATES:
place           | confidence
----------------+-----------
Eiffel Tower    | 68%
Notre-Dame      | 15%

> game_turn(session_id: "7f3a2b1c-...", answer: "yes")

status | question | guess        | guess_confidence
-------+----------+--------------+-----------------
active |          | Eiffel Tower | 89%

> game_turn(session_id: "7f3a2b1c-...", answer: "yes")

status | 
-------+
won    |

Status Values

•active - Game in progress
•won - Correct guess confirmed
•ended - Game over (gave up or max turns)

Answer Values

•yes - Confirm question or guess
•no - Deny question or guess
•not_sure - Skip question (only for questions, not guesses)

Review Completed Game

code

game_summary(session_id: "abc123...")

Returns: description, result (won/lost), place name, trait count, and full question history.