Mynawoo: Mystery Language Game

Send the player's answer to the current step question: the number of the choice that matches what they said, or 0 if it matches none. Always copy the current step number and create one attempt_id per explicit player answer; the same call can then be retried safely. Correct: returns the next step (or the ending). Wrong: returns a hint, and after two wrong answers at a step the remaining choices are shown. The final guess allows only a few attempts; a final decision ends the story with the ending of the chosen option.

answer_mystery

List the mystery stories the user can play, with saved progress and language hints for the player. Pass the chosen language and level so the closest stories come first.

list_mysteries

Erase the saved progress for one mystery and start it from step 1. Call only after the player explicitly asks to replay from the beginning. Returns the same bounded first-step packet as start_mystery.

restart_mystery

Begin a mystery, or continue it where the user left off. Call it once per chat, and again only to save a new language or level the player asks for (progress is kept). Returns the intro, what was already learned, the language to narrate in, the next move for the narrator, and the current step: scene, characters with their claims, knows and gated secrets, evidence, the player task, and the step question with choices that stay hidden from the player until show_choices is true. Set familiarization for a first trial in the player's native/current language without CEFR setup or corrections.

start_mystery