Open documentation · English edition

Translation of the canonical Spanish source under CC BY-SA 4.0. Code, trademarks and visual assets are not included.

TRACEKEEPERS plain-language guide

This guide applies to every text that a player may read or hear: scans, dialogue, missions, hints, biographies, curiosities, treasures and wonders.

Goal

A person of about ten and any adult with no previous knowledge should understand the text on the first reading. Every version begins from zero. Simplifying does not mean removing the important idea; it means explaining it with common words, familiar examples and easy steps.

Required rules

  1. Begin by saying what the object, person or problem is.
  2. Then explain how it works and what it was used for.
  3. Use short sentences, with one main idea in each sentence.
  4. Avoid technical terms when an everyday word works.
  5. If a historical term is necessary, explain it immediately: “a qanat, a tunnel that carries water underground”.
  6. Do not introduce more than one new term in the same sentence.
  7. Avoid an encyclopaedic tone, exaggeration and phrases such as “the first in history” when firm evidence is absent.
  8. Clearly distinguish facts, hypotheses and traditional stories.
  9. Distinguish historical characters from legendary, religious, fictional or composite ones.
  10. Never present ancient medical practices as current advice. Do not include doses or instructions for eating plants or applying them to wounds. If a historical practice appears, explain that it may have eased symptoms but does not replace medical treatment.

Suggested length

Presentation by age

Age does not change what must be learned or make the reasoning harder. All three versions explain the same basic idea, ask equally simple questions and offer help. Only the way of speaking changes.

An adult version never turns into an advanced lesson. If an idea needs several steps, explain them one by one with an everyday example.

When the player wants to know more

Extra depth is optional and available at every age. Going deeper means adding simple steps, not harder words.

A good limit sounds like this: “I have seen that a covered ember grows weak, but I do not know what air is made of.” It does not use a modern word the character could not know.

When another character continues the thread, the Atlas gives the summary. The new character explains which different tool or problem lets them move forward. They never call the earlier character ignorant.

Words belonging to the game

The first appearance of any of these words in a scene must include its plain explanation.

Approved example

Scan: Flint

Flint is a hard stone. It is often found inside a paler rock called limestone. When it breaks, it can leave a very sharp edge. Many people in the past used it to cut, scrape hides and prepare tools. The game does not teach real flintknapping.

Checklist

Before approving a text, check: