Question Sets

Experimental

Question sets and the quiz engine are currently an experimental feature. Their behavior may change.

A question set holds the questions a quiz asks and the rules the run follows. A game only ever sends a character id and a set id, so everything about how the quiz behaves is decided here rather than in your code.

Open Question Sets from the dashboard sidebar.

Plan requirement

Question sets and the quiz engine require a Team plan.

Creating a set

Click Create Question Set and give it a name
Click Add Question for each question you want to ask
Copy the set id from the card's action menu, or from the URL of the set

A set holds up to 10 questions.

Question types

Pick the Answer Type on each question.

Type	How it is judged
Free Text	The host reads the answer and compares it to the expected answer you wrote, plus any rubric.
Multiple Choice	Two to six options, one marked correct. Graded against the option you marked.
True / False	Fixed True and False options. Mark which one is correct.

Choice questions are graded without asking the host for a verdict. When a player's words do not name an option outright, for example answering "yes" to a true or false question or naming the option in another language, the host is asked only which option they meant and the comparison to your answer key still happens in code.

What you write on a question

Field	What it does
Question Prompt	The question itself. The host asks this, translated into the character's language if it speaks another one.
Expected / Correct Answer	The reference answer for a free text question. Choice questions derive it from the option you mark.
Scene keyword	A stable name for the scene this question needs, such as `SHOW_RED_APPLE`. Sent to the game with the question so it can key its scene on something readable instead of a generated id.
Reasoning Facts & Context	Background the host may use to judge edge cases and explain an answer. Never read out as the answer.
Hint	A clue, offered when a player asks for one or gets it wrong. The host leads them towards the answer with it and never states the answer itself.
Custom Grading Rubric	Free text only. Decides what counts as correct or partial for this question, in the language the player speaks. Useful for judging pronunciation, where near misses have to be spelled out.
Points	What a correct answer is worth.
Allow partial credit	Free text only. Lets the host award a partial verdict, worth the partial points you set.

A wrong answer teaches rather than reveals

While the player still has an attempt left, the host never says the answer: it uses your hint and background facts to lead them towards it. Once the attempts are spent, it tells them what the answer was and why, so nobody moves on still believing the wrong thing.

How a run plays

Open Configure Protocol & Instructions to set the rules. These are what make the same two ids drive a coaching tutor that lets a child try again and a game show that never does.

Setting	Effect
Question order	`In order` or `Shuffled`.
Questions per run	How many of the set one run serves. Leave it empty to serve them all.
After a wrong answer	`Move on`, `One more try`, or `Until they get it`.
Ask before trying again	The host offers another go and waits for a yes. Off, and it simply asks the question again.
A second try still scores	Whether a replayed question can move the leaderboard. Off, and a replay is played for the learning rather than the points.
Give a hint when asked	Whether the host may offer the hints you wrote. Off, and the game is never told a clue exists.
Opening words	Said verbatim as the host's welcome, before the first question. Leave empty to open on the first question.
Closing words	Said verbatim to end the run. Leave empty to end on the host's last reaction.

Opening and closing words are spoken exactly as you wrote them, in your own language, rather than paraphrased.

Host delivery

Host Delivery Preset decides how the host talks about scores.

Preset	Delivery
Spoken Scores	Announces each player's points out loud. A game show.
Conversational	Reacts in character and leaves the points to your UI.
Educational	Explains why the answer is what it is and corrects gently.

Custom Host Instructions add guidance for the host on top of the character's own personality, for this set only.

The character you pick when the quiz runs supplies the host's name, personality, language and voice. Add a Quiz Evaluator node to a character to choose its hosting style, and a Language node to have it run the whole quiz in another language.

Testing a set

Test Set opens the playground. It runs the same engine the public API runs, so a question graded here grades the same way in a game.

Pick a question and a host character
Add simulated contestants, type or tap their answers, and post them one at a time
Evaluate Round scores the round and shows the host's reaction and each verdict
Preview Start and Preview Finish play the opening and closing sequences

Playground runs count against your daily editor allowance, the same as the character chat preview.

Using a set in a game

Once a set has questions with no Incomplete badge, it is ready to play. Pass its id to the quiz endpoint, along with the character that hosts it.