🏛️ Parlova
Teacher guide · advanced

Building and reworking a complex mission

Curriculum mission or free mission, then sources, sourced facts, characters, concepts, dates, timeline and events: everything you can set before and after generation, tab by tab.

First mission? Start with the step-by-step guide (sign-up, class, sharing).

🧪 The example used throughout this guide
“Paris, July 1789”, lower secondary, chapter “The French Revolution and the Empire”. The student arrives on 12 July 1789, questions a speaker at the Palais-Royal, the governor of the Bastille and a washerwoman from the Faubourg Saint-Antoine, then explains why the storming of the Bastille became a symbol. A “complex” mission: several characters with opposing views, a dated document, a tight chronology and plot twists.
1

⚖️ Curriculum mission or free mission?

It all starts with the first choice on the “✨ Create” screen: “From my curriculum” or “Free exploration”. Both produce a mission that plays and is edited the same way; what changes is the starting point and what the AI knows about your expectations.

📚 From my curriculum / 🧭 Free exploration
The first choice on the creation screen.
📚 From my curriculum🧭 Free exploration
Starting pointYour level and a chapter of the official curriculum (England, Ontario, the US AP, France… depending on the country you pick)An era and a theme you phrase freely
Teaching briefPre-filled from the curriculum (central question, concepts, key dates, skills, characters, places, final question), each section marked “Official curriculum” — to review and approveNo brief, unless you upload teaching material: the AI then turns it into a brief to review, as for the curriculum
Your teaching materialPossible: “Or upload your teaching material” (PDF, Word, ODT, text) — the brief is built from its contentAlso possible (single mission): “5. Documents” section — the brief is built from its content; an empty subject or period is filled in from the document
Sources (source corpus)From the start, in the briefFrom the start, in “5. Documents” (for a learning path, they go to every episode), or afterwards in the editor's 📚 Sources tab
Resource typeA missionA mission or a learning path (several episodes)
Audience (juniors / adults)Deduced from the chosen levelChosen by hand, with difficulty and optional levels
Skills assessedSuggested from the curriculum skills and the final questionSuggested from the final question
DomainsHistory-Geography, Psychology, Philosophy-Economics; Mythology through the history chapters about it; no official curriculum for InvestigationAll five domains, including Investigation
After generationSame editor, same tabs, same optionsSame editor, same tabs, same options
📚 From my curriculum

Pick the level, then a chapter: a complete brief arrives, aligned with the official curriculum. Each section shows where it comes from (“Official curriculum”, “Suggested by AI”, “Edited by you”).

List of official curriculum chapters
The level, then a curriculum chapter.
Teaching brief pre-filled from the official curriculum
The generated brief, to review before “✅ Validate and launch the investigation”.
🧭 Free exploration

Choose the resource type (mission or learning path), the domain, then describe the era and theme. The more precise the theme (place, date, issue), the more focused the generated mission: “Paris, July 1789: from anger to the storming of the Bastille” rather than “the French Revolution”.

Free exploration form: resource type, domain, era and theme
Resource type, domain, era and theme.

For a single mission, the “5. Documents (optional)” section offers the same tools as the curriculum path: “📄 Teaching material to guide the mission” (PDF, Word, ODT, text, then “📄 Analyse the document”) produces a brief you review and correct before generating, and “+ Add a source” directly adds the documents the characters can quote, together with the AI knowledge mode. During generation, each document added here is linked automatically to the characters who wrote it, lived the events it reports or could have read it in their lifetime; the 📚 Sources tab flags it “🤖 Linked automatically”, to check. For a learning path, the same section keeps only the documents, given to every episode. Nothing is required: without documents, the mission starts from the subject alone.

Documents section of free exploration: analysed teaching material and brief to review
The analysed teaching material: the brief taken from the document (concepts, key dates, characters, places, final question), with the added documents.
🤔
For a lesson that follows a curriculum chapter, start from the curriculum: the mission, the grading and the assessed skills line up with official expectations. For a cross-curricular project, an off-curriculum topic, an investigation or a multi-episode learning path, start from free exploration — with your teaching material and documents from the start if you wish. For a multi-episode learning path, the documents added at creation go to every episode.
2

🧭 Preparing a rich brief

A complex mission is shaped first in the brief (the “From my curriculum” path, or free exploration with teaching material): whatever you specify there is used as-is by the generation and saves you long edits later. Review each section with what it will become in the game in mind:

Brief sectionWhat it becomes
Central questionThe common thread of the investigation.
Concepts to coverThe concepts to discover, spread across the characters (none knows everything).
Key datesThe dates on the timeline.
SkillsWhat the student will have to do, and the skills assessed in the final answer.
Key charactersUsed as-is; the AI adds others around them. Name them exactly (“Bernard-René de Launay”, not “the governor”).
Key placesPlaced as-is on the 2D map.
Final questionThe question the student is graded on.
Source corpusThe sources the characters rely on (step 4).
🎯
For a rich mission, aim for 3 to 5 key characters with different viewpoints (an actor, an opponent, an ordinary witness) and 4 to 6 dated landmarks: that gives the timeline depth and forces the student to cross-check.
⏳
In free exploration without teaching material, put those same elements into the theme: wanted characters, places, key dates. Everything else (detailed concepts, questions, dialogue, illustrations, map) is generated, and generation keeps running on the server if you close the page.
3

🧰 Finding your way in the editor

Once the mission is generated: “📚 My missions” → “✏️ Edit” on the mission card. The editor opens with the action buttons at the top and the tabs underneath.

The mission editor: action buttons and tabs
The editor, Info tab: title, era, difficulty, audience, levels, visibility.
TabWhat you set there
InfoTitle, era, difficulty, audience, levels, visibility, game options (suggestions, dictation, map).
📚 SourcesSource corpus and the AI knowledge mode.
ContextCentral question, model answer, grading criteria, start date, period, location, tensions.
TimelineThe key dates the student sees — and can travel to.
EventsPlot twists, their date and their trigger conditions.
ConceptsWhat the student must discover in conversation, with hints.
CharactersIdentity, dates, point of view, known concepts, fact sheet, documents, starter questions.
QuestionsIntermediate questions asked during the game.
ExplanationThe detailed solution, used as the reference to grade the final answer.
MemoThe printable summary sheet.
IllustrationsArchive images that appear during the game.
🗺️ PlacesThe 2D map: building names, places revealed by an event, where characters stand.
💾
Nothing is saved until you click “Save”. While changes remain, “● Unsaved changes” is shown and the page asks for confirmation if you leave. You can switch tabs freely: changes are kept until you save.
🏛️
An “Official Parlova version” mission cannot be edited directly: “📋 Duplicate” creates your own copy, which you then edit.
4

📚 Adding and setting up sources

“📚 Sources” tab → “+ Add a source”. Only the title is required; the rest makes the source more useful. The same form is available at creation: in the brief (curriculum) or in “5. Documents” (free exploration).

  1. Identity: title, author, date, type (primary source, secondary source, testimony, official document), bibliographic reference, URL.
  2. Content: paste the text, or “📎 Import a document” (PDF, .docx, .odt, .txt, .md). Imported text arrives “to validate”: read it, correct it, then “✓ Validate this content”. Until it is validated, no character uses it.
  3. Exact text? Tick the box only if it is the original wording: the character may then quote it in quotation marks. Unticked (the default), they rely on it without ever quoting it word for word — the right choice for a translation, like the Declaration here.
  4. Known from (optional): before this date, no character can use the document. Here, the Declaration of 1789-08-26 is unknown to Desmoulins on 1789-07-12.
  5. Related concepts and characters: decide who has the document in their sheet (see below).
  6. Copyright: public domain, open license, protected excerpt for my class, or “I don't know”.
Sources tab with two sources and the knowledge mode
Two sources: the Declaration (validated text, “Unknown to the characters before 1789-08-26”, linked to a concept and to Desmoulins) and a book as a reference only. Below, the knowledge mode.

One source, three states

StateWhat characters can do with it
Reference only (no text)Say the document exists, never draw a precise fact from it.
Document provided — to validateNothing yet: the text is waiting for your review.
Validated, or text pasted by handUse it as a factual basis; the student sees the quoted passage under the answer.

Who does the document apply to?

Characters use it in two ways. Their sheet: the beginning of the text (about 1,500 characters) is written into the sheet of the linked characters — the “👥 In the sheet of” line shows who. Search during conversation: for every question, Parlova looks for relevant passages in all validated documents, whichever character is being asked.

You tick…The document goes into the sheet of…Typical use
A conceptEvery character who knows that conceptA document that explains a theme
A characterThat character onlyTheir memoirs, letters, speech
NothingNobody (search during conversation only)A supporting document

The AI knowledge mode

It sets what characters may say beyond your documents, for the whole mission. It only appears once a document is validated; adding a first source sets it to semi-restricted.

Restricted
Only your documents and the mission content. The most reliable, but the character will often say “I don't know”.
→ The character answers that they don't know.
Semi-restricted
Your documents first for whatever they cover, general knowledge for the rest.
→ If the question is about the document, they stick to it; otherwise they answer from general knowledge.
Open
Your documents and general knowledge, with no priority.
→ They answer from general knowledge.
⚖️
A protected text stays in your mission: characters paraphrase it without quoting, it is not passed on if a colleague copies the mission, and the mission cannot be made public while it is there.
5

👤 Adding, editing and renaming characters

“Characters” tab. Each card shows its 📚 sourced facts and 📄 documents badges at a glance: a yellow “No sources” badge flags a character to complete. “Edit” expands the sheet.

Expanded sheet for Camille Desmoulins
Desmoulins' sheet: identity, point of view, dates, fact sheet, documents, known concepts, starter questions.

Adding a character

  1. “+ Add a character”, then fill in name, role and gender.
  2. Point of view: their worldview in two or three sentences. This is what makes them speak differently from the others — de Launay defends the king's order, the washerwoman talks about the price of bread.
  3. Dates: birth, death, active from, active until (see step 8).
  4. Known concepts: tick what they can reveal to the student.
  5. Starter questions: 2 or 3 suggestions offered to the student the first time they pick this character.
  6. Add sourced facts (step 6) and, if needed, link a document to them from the Sources tab (“Manage sources →”).

Editing, renaming, deleting

Renaming a character is safe: when you save, the new name is carried over everywhere the old one appeared — events, map and schedule, memo, linked sources, and even games your students have already started. Character sheets are rebuilt on every save, without regenerating the mission.

Deleting (✕) removes the character; then use “↻ Update the rest” (step 10) so the solution and memo no longer mention them.

⚠️
If an orange banner says a character “knows every concept”, untick a few: the student could learn everything from one person without cross-checking.
🕵️
In the Investigation domain, an extra section appears: “Hides the truth”, their version of events, their motive, what really happened and the topics they lie about. A single character who hides the truth makes the investigation easier to follow.
6

🔎 Sourced fact sheets

A character's fact sheet holds precise, sourced facts they use to answer — this is what avoids vague answers about a work, a date or a meeting. Any fact, with any source: a book, an archive, a museum, a textbook, your own lesson, a website… Wikipedia is just one possible starting point.

  1. “+ Add a sourced fact”: a date (or just a year), a short description, the source name as you want students to see it (“The National Archives”, “Textbook p. 42”, “Ms Taylor's lesson”) and, if there is one, a link. Fill in one fact before adding another.
  2. To get started faster on a real character, “Generate from Wikipedia” (or “Regenerate”). Parlova suggests the articles that might match the name: pick the right one (“Use”), or “None of these”.
  3. Review each fact: date, description, source name and link (↗ to check). Correct or delete whatever is wrong.
Camille Desmoulins's fact sheet with facts from a book, Wikipedia, the teacher's lesson and Gallica
Five facts, four kinds of source: a book, Wikipedia, the teacher's lesson, Gallica (BnF). Under the answer, students see each fact cited with its source.
Choosing the Wikipedia article above the existing facts
Two possible articles for “Camille Desmoulins”: pick the right one, not Lucile Desmoulins.
🕰️
A fact dated after the game date stays secret for the character: Desmoulins, questioned on 12 July 1789, knows nothing of 1794. You can therefore keep a complete sheet with no risk of anachronism.
🧺
A fictional character (“Marie Thibault, washerwoman”) has no Wikipedia article: that is expected. Add a few facts by hand taken from your sources — the price of bread in July 1789, life in the faubourg — with the book's reference.
🔁
“Regenerate” replaces all current facts, including your corrections: you are asked to confirm.
7

💡 Concepts and context

Concepts tab

Each concept is something the student must discover in conversation. The text is used for in-game detection: write it as a statement (“The high price of bread fuels the anger of the Parisian people”), never as a question. A new concept must be ticked for at least one character (“Known concepts”), otherwise no character is in charge of revealing it.

Concepts tab with four concepts and their hints
Four concepts, each with a teaching hint (direct help) and an immersive hint (a line from a character).

Context tab

Context tab: central question, model answer, criteria, skills
Central question, model answer, grading criteria, expected length, skills assessed, introduction and start date.
FieldRole
Central questionThe final question put to the student.
Model answerShown to the student at the end of the game, next to their grade.
Grading criteriaTaken into account when grading, and shown to the student before submitting (“Your teacher's expectations”).
Expected lengthWord target shown while writing (empty = default, 0 = none).
Skills assessedSaved as soon as you tick them; only these are graded.
Narrative introductionThe scene-setting text read at the start.
Start date, period, locationThe time and place framework (step 8).
TensionsThe conflicts running through the mission (Third Estate against the privileged, king against Assembly…).
8

🗓 Dates and timeline

In a history mission, dates are not decoration: they decide who can speak, what each person knows and when the student can go. They are set in seven places.

DateTabEffect in the gameExample
Investigation start dateContextThe game's “present” at the start. Everything else is compared to it.1789-07-12
Period (start, end, era name)ContextThe overall framework of the mission, in years.1789 → 1789, “French Revolution”
Timeline datesTimelineThe steps the student sees, sorted automatically. One click = time travel.1789-05-05 … 1789-08-26
Event dateEventsPlaces the twist in the story's time.1789-07-14
Birth, death, active from / untilCharactersSet when a character can be questioned: greyed out before or after.de Launay: 1740 → 1789-07-14
Sourced fact dateCharactersA fact dated after the game date stays secret for the character.Desmoulins' death: 1794
A source's “Known from”SourcesBefore this date, no character can rely on the document.Declaration: 1789-08-26

Building the timeline

  1. “Timeline” tab → “+ Add an event”.
  2. Enter the date (YYYY-MM-DD, YYYY-MM or just a year; “-52” for a year BC) and a short description.
  3. When you leave the date field, the timeline sorts itself in chronological order.
  4. To remove a step: ✕. To move it: change its date.
Timeline tab with six dates from May to August 1789
Six steps, from the opening of the Estates-General to the Declaration of the Rights of Man.

In the game, the student opens the timeline at the top of the screen and clicks a date to travel there: characters then answer from that moment. On 14 July, de Launay can still be questioned; on 4 August, he is gone.

📅
Outside History-Geography (Mythology, Psychology, Philosophy, Investigation), the timeline counts in numbered steps (1, 2, 3…) — “Acts”, “Sessions”, “Debate” or “Days” depending on the domain — and characters have “Available from day / until day” instead of birth and death.
🧩
A character is greyed out before their “Active from” date (or birth) and after “Active until” (or death). Check that each one can be questioned at the start date or at a timeline date, otherwise the student will never be able to talk to them.
9

⚡ Events and plot twists

Events are plot twists that happen during the game: all characters then know their description and react accordingly.

  1. “Events” tab → “+ Add an event”, then “Edit”.
  2. Title and date (YYYY-MM-DD, as on the timeline; a step number outside History-Geography).
  3. Description: what happens, from the point of view of someone living through it.
  4. Trigger conditions: “Minimum exchanges” (questions asked by the student, across all characters) and “Minimum notions found” (0 = no condition).
Events tab, second event expanded with a warning
“The crowd marches on the Bastille”: at least 6 exchanges and 2 concepts. The orange warning flags a question set to the same thresholds.

How they follow one another in the game

Only one element appears per exchange (event first, then illustration, then question), with at least 3 exchanges between two elements of the same kind. The first event arrives by the 4th exchange at the latest, whatever its thresholds, so every game has its twist.

⚠️
Two orange warnings help you: “Same trigger conditions as…” (stagger the thresholds, otherwise some elements will arrive later than set) and “This event repeats the answer to the concept…” (rephrase it: the event would give the answer away).
🗺️
In the “🗺️ Places” tab, a building can appear only after an event: for example the Hôtel de Ville, revealed when the crowd marches on the Bastille. Deleting the event makes the place visible from the start.
❓
Intermediate questions (“Questions” tab) can also be triggered when a concept is discovered or an event happens: tick them in the question.
10

💾 Save, update the rest, test

Save

“Save” saves every tab at once. At that moment: character sheets are rebuilt with their sources and known concepts, changed names are carried over everywhere, detection of edited concepts and answers is updated (a few extra seconds), and new documents are indexed for search during conversation.

↻ Update the rest

Some parts are derived from the content: the model answer, the solution (Explanation tab), the printable sheet (Memo tab), and how characters react to events. If you change the question, concepts, timeline or characters, they may still describe the old version — an orange banner says so.

Central question edited: orange banner and Update the rest button active
The central question has just been rewritten: “● Unsaved changes”, orange banner, “↻ Update the rest” button active.

The button (greyed out while nothing has changed) suggests new versions of those parts only. Tick what you want to replace, then “Apply and save”. A part you edited by hand is unticked by default.

Update the rest of the mission window
The proposal: model answer, solution and memo, to tick part by part.

🎮 Test in game

Opens the mission in a new tab, as a student would see it (pending changes are saved first). Test at least: one character per viewpoint, a jump on the timeline, a question that draws on a source (the quoted passage should appear under the answer), and the arrival of the first event.

✓ Checklist before sharing

The investigation start date is on or before the first important timeline date.
Every character can be questioned on at least one timeline date (birth, death and active period).
No character knows every concept: the student has to cross-check several accounts.
Every important source is validated (not “to validate”) and linked to a concept or a character.
Sources dated after the start date have a “Known from” date.
No event repeats a concept's answer word for word (orange warning in the tab).
No identical trigger thresholds between events, illustrations and questions (orange warning).
After major changes, “↻ Update the rest” has been applied, then the mission tested in game.