Die Suche war einer der Gründe, weshalb es Atlavium überhaupt gibt. Im ersten Blogartikel habe ich von meinem Dungeon Master und seinem OneNote erzählt. Die Notizen waren da, nur die gerade wichtige Information ließ sich zuverlässig im falschen Abschnitt vermuten. Mein eigenes Charaktertagebuch macht die Sache mit der Zeit auch nicht übersichtlicher. Nach jeder Session kommt etwas hinzu, und irgendwann möchte ich einen Namen wiederfinden, an den ich mich nur noch ungefähr erinnere.

Inzwischen ist aus der Dokumentensuche ein deutlich größeres Projekt geworden. Die ursprüngliche Aufgabe ist geblieben. Deshalb habe ich die Suche mit Version 1.16 noch einmal überarbeitet. Die kurze Fassung steht im Changelog. Hier möchte ich etwas ausführlicher erzählen, was beim Suchen passiert und weshalb ich mich an einigen Stellen so entschieden habe.

Was die Suche von deiner Welt kennt

Zunächst braucht die Suche etwas, worin sie suchen kann. Wenn du einen Eintrag speicherst, übernimmt Atlavium seinen Titel, seine Schlagworte und den durchsuchbaren Text in einen Suchindex. Das ist gewissermaßen das Register deiner Welt. Auch ein Satz mitten in einem langen Dokument kann dadurch wiedergefunden werden, ohne dass du noch wissen musst, in welchem Ordner er liegt.

Bei Dokumenten gehört der gespeicherte Text dazu, bei Weltentitäten ihre Beschreibung. Wenn du eine Figur wie Mira Fenn anlegst und ihre Geschichte aufschreibst, kann die Suche also auch über diese Beschreibung zu ihr finden. Ergänzt du eine Weltentität um ein Profil, bestimmst du dort über „In Suche einbeziehen“, welche Felder berücksichtigt werden. Ein Zähler auf einem Charakterbogen muss schließlich nicht bei jeder Suche mitreden.

Mit dem Schalter „Für Suche und Keeper verwenden“ kannst du einen ganzen Eintrag herausnehmen. Er bleibt lesbar, taucht aber weder als Suchtreffer noch als Quelle für den Keeper auf. Und die Suche bleibt immer in der Welt, die du gerade geöffnet hast. Deine anderen Welten und der Verlauf deiner Keeper-Gespräche werden dabei nicht mit durchsucht.

Ein Name ist oft nur der Anfang

Nehmen wir Mira Fenn aus der Demo-Welt Nebelmark. Wenn du ihren Namen eingibst, ist ihr eigener Eintrag ein naheliegender Treffer. Vielleicht wird sie aber auch in einem Brief oder in einem längeren Dokument über das Hafenarchiv erwähnt. Diese Dokumente möchtest du ebenfalls finden können, ohne vorher zu entscheiden, ob du gerade nach einer Weltentität oder nach einem Text suchst.

Die Suche bewertet deshalb mehrere Dinge gemeinsam. Passt der Titel? Steht das Wort in einem Schlagwort oder irgendwo im Text? Wie gut unterscheidet es diesen Eintrag von den übrigen? Ein seltener Begriff sagt dabei mehr aus als ein Wort, das auf fast jeder Seite steht. Namen und Schlagworte bekommen mehr Gewicht als eine beiläufige Erwähnung mitten in einem Absatz. Auch das letzte Änderungsdatum fließt ein, wobei der Bonus für neue Änderungen mit der Zeit abnimmt. Eine alte Notiz fällt deshalb aber nicht einfach aus der Suche.

Wörter müssen außerdem nicht immer genau gleich geschrieben sein. Atlavium berücksichtigt Wortstämme anhand der Sprache deiner Welt, sodass beispielsweise „Schiff“ und „Schiffe“ zusammenfinden. Kleine Tippfehler werden ebenfalls aufgefangen, besonders bei Namen und Schlagworten. Im Fließtext ist die Suche damit zurückhaltender, damit nicht jeder zufällig ähnlich aussehende Begriff einen Treffer erzeugt.

Aus all dem entsteht eine gemeinsame Reihenfolge. Dokumente und Weltentitäten haben darin keine reservierten Plätze. Du kannst die Ergebnisse auch nach Name oder letzter Änderung sortieren, wenn das gerade besser zu deiner Suche passt.

Die Verbindungen gehören dazu

Bei einer Rollenspielwelt steckt ein Teil des Wissens zwischen den Einträgen. Mira Fenn ist Mitglied des Hafenarchivs. Diese Beziehung steht in Nebelmark im Weltengraph. Wenn du nach Mira suchst, kann deshalb auch das Hafenarchiv auftauchen, selbst wenn ihr Name nicht in dessen Beschreibung steht. Der Hinweis „Über Verbindung zu Mira Fenn gefunden“ erklärt dir dann, wie die Suche darauf gekommen ist.

Vereinfachtes Beispiel für die Suche nach Mira Fenn: Ihr Name führt zu ihrer Weltentität und zu Erwähnungen in Dokumenten. Über ihre gespeicherte Mitgliedschaft kann auch das Hafenarchiv gefunden werden. Das Beispiel zeigt keine feste Rangfolge.

Damit bekommen die Verbindungen, die du in deiner Welt festhältst, auch beim Nachschlagen eine Aufgabe. Für mich gehört das zur ursprünglichen Idee von Atlavium: Eine Welt wächst mit den Zusammenhängen, die wir beim Spielen entdecken. Wenn du diese ohnehin aufschreibst, sollte die Suche sie auch nutzen können. Sie zieht dafür die gespeicherten Verbindungen heran. Eine neue Beziehung denkt sie sich beim Suchen nicht aus.

Wenn die Runde andere Begriffe benutzt

Nun hält sich eine Spielrunde selten durchgehend an ihre eigenen Bezeichnungen. Ein Ort hat einen langen Namen, im Gespräch wird daraus eine Abkürzung, und in den Notizen steht womöglich noch die alte Schreibweise. Mit Tippfehlern allein lässt sich das nicht lösen.

Dafür gibt es unter Einstellungen → Suche das Suchvokabular. Dort kannst du einen bevorzugten Begriff mit Aliasnamen, Synonymen und Abkürzungen verbinden. Wenn eure Runde für das Hafenarchiv etwa „HA“ verwendet, kannst du diese Abkürzung dort hinterlegen. Atlavium berücksichtigt die zusätzlichen Begriffe dann automatisch in der Suche und beim Keeper. Die ursprüngliche Suchanfrage bleibt dabei erhalten. Deine Texte und der Kanon werden dadurch nicht umgeschrieben.

Du musst dafür nicht deine ganze Welt durcharbeiten. Ein verständlicher Titel und ein paar passende Schlagworte helfen bereits viel. Das Suchvokabular ist für die Begriffe da, bei denen eure Runde regelmäßig etwas anderes sagt, als im Kompendium steht.

Wenn zu viel oder zu wenig auftaucht

Beim Nachschlagen helfen meist ein Name oder wenige konkrete Wörter. Wenn du weißt, dass die gesuchte Information in einem Brief steht, kannst du die Suche auf Dokumente eingrenzen. Suchst du eine Figur oder einen Ort, wählst du Weltentitäten. In der erweiterten Suche gibt es dafür auch Kategorien, Schlagworte und Favoriten. Eine feste Wortgruppe lässt sich in Anführungszeichen setzen.

Die Suche sammelt pro Inhaltstyp nur eine begrenzte Auswahl für die gemeinsame Trefferliste. Erscheint ein entsprechender Hinweis, hilft ein genauerer Begriff oder ein Filter weiter. Auch sehr schwache Treffer werden ausgeblendet. Eine leere Liste kann also bedeuten, dass die Suche nichts ausreichend Passendes gefunden hat. Falls du einen bestimmten Eintrag vermisst, lohnt sich ein Blick auf seine Schlagworte und die Suchschalter des Eintrags oder der einzelnen Profilfelder.

Die öffentliche Demo-Welt Nebelmark kannst du ohne Konto durchstöbern. Dort lässt sich zum Beispiel nach „Hafenarchiv“ suchen. Das öffentliche Lesen verwendet allerdings eine einfachere Textsuche ohne die sprachabhängigen Wortstammregeln. Es ist deshalb kein vollständiger Vergleich mit der Suche in deiner eigenen Welt.

Wie der Keeper passende Textstellen bekommt

In der globalen Suche suchst du einen Eintrag, den du anschließend selbst öffnest. Stellst du dem Keeper eine Frage zu einem Dokument, sucht Atlavium die dazu passenden Textpassagen heraus und stellt sie ihm als Grundlage für seine Antwort zur Verfügung. Bei einer Frage zum Wiederaufbau des Hafenarchivs können das einzelne Stellen aus einer langen Chronik sein. Der Keeper bekommt diese ausgewählten Stellen mit ihrem Zusammenhang im Dokument.

Für diese Suche bereitet Atlavium den Dokumenttext in kleineren Passagen auf. Überschriften und Unterüberschriften gliedern ihn dabei in zusammengehörige Abschnitte. Die Aufteilung kann dieser Struktur folgen und den Text innerhalb der technischen Größenlimits möglichst zusammenhalten. Zusätzlich bleibt zu jeder Passage erhalten, unter welcher Überschriftenfolge sie steht.

Die Suche berücksichtigt sowohl die Wörter in den Passagen als auch ihre Überschriften. Sie wählt daraus passende Fundstellen für die konkrete Frage aus. Mit den Textstellen erhält der Keeper auch ihre Überschriftenfolge und den Verweis auf das Dokument. Seine Antwort entsteht aus dieser Auswahl. Deine gespeicherten Texte bleiben dabei unverändert.

Angenommen, du schreibst ein langes Dokument mit dem Titel „Die Historie des Hafenarchivs“. Darin erzählst du von seiner Gründung, den ersten Jahrhunderten, einem großen Brand und dem Wiederaufbau. Ein Ausschnitt aus der Gliederung könnte so aussehen:

## Die Gründungszeit
Die ersten Bücher am Hafen.

## Die ersten Jahrhunderte
Wie die Sammlung wuchs.

## Der große Brand
### Die Rettung der Bestände
Was gerettet werden konnte.

### Der Wiederaufbau
Neue Räume für alte Bücher.

## Das heutige Archiv
Der Wandel bis heute.

Die Textstelle „Neue Räume für alte Bücher“ gehört dann zur Folge „Der große Brand → Der Wiederaufbau“. Der Satz selbst nennt den Brand nicht. Die Überschriften geben der Suche aber zusätzliche Anhaltspunkte, um ihn bei einer Frage zum Wiederaufbau zu finden. Werden solche Stellen ausgewählt, bekommt der Keeper ihre Einordnung mit: Sie gehören zum Wiederaufbau nach dem Brand. Diese Information bleibt auch erhalten, wenn das Kapitel später viele Seiten umfasst. Die Beziehungen der beteiligten Personen und Orte hältst du weiterhin im Weltengraph fest.

Deshalb lohnt es sich, beim Schreiben echte Überschriften im Editor zu verwenden, zum Beispiel „Die ersten Jahrhunderte“ oder „Der Wiederaufbau nach dem Brand“. Unterüberschriften gliedern das Thema weiter. Eine nur fett geschriebene Zeile ist für diese Gliederung keine Überschrift. Halte zusammengehörige Informationen beieinander und beginne einen neuen Abschnitt, wenn du das Thema wechselst. Du musst dafür nicht jede Notiz in ein Nachschlagewerk verwandeln.

Ein langer Text ohne Überschriften bleibt durchsuchbar. Ohne diese Gliederung muss sich die Aufteilung vor allem an technischen Größenlimits orientieren. Dadurch kann eine zusammenhängende Erklärung mitten im Gedankengang getrennt werden. Überschriften helfen uns, sinnvollere Abschnitte zu bilden und solche Schnitte möglichst zu vermeiden.

Die technischen Grenzen gelten auch für ein gut strukturiertes Dokument. Ein sehr langes Kapitel muss deshalb trotzdem in mehrere Passagen geteilt werden. Seine Teilstücke bleiben aber in der Gliederung miteinander verbunden und ihrem gemeinsamen Abschnitt zugeordnet. So hilft die Struktur dabei, den Kontext auch über notwendige Teilungen hinweg zu erhalten.

Was ich mit der Vektorsuche vorhabe

Bei der Überarbeitung habe ich die semantische Suche aus der globalen Suche herausgenommen. Sie kann Textstellen über ihre Bedeutung finden, auch wenn darin andere Wörter stehen. Dafür muss die Anfrage zunächst in eine Form umgerechnet werden, mit der sich diese Ähnlichkeit vergleichen lässt. Das kostet Zeit. Beim schnellen Nachschlagen eines Namens mitten im Spiel möchte ich diese zusätzliche Wartezeit vermeiden.

Für den Keeper möchte ich die Vektorsuche dagegen wieder einsetzen. Das ist noch ein Plan. Eine Frage an ihn fällt häufig länger aus und braucht mehr Zusammenhang als ein einzelner Suchbegriff. Dort kann es helfen, auch eine passende Textstelle zu finden, deren Wortlaut ganz anders ist. Die längere Laufzeit bleibt dabei ein Nachteil, den ich gegen den Nutzen abwägen muss.

Die Auswahl von Textpassagen anhand von Wörtern und Überschriften funktioniert schon heute. Die Vektorsuche soll sie später um Treffer über die Bedeutung ergänzen. Das Suchvokabular und die gespeicherten Verbindungen deiner aktuellen Welt helfen dem Keeper ebenfalls. Er zeigt dir relevante Quellen und macht Vorschläge. Was davon Kanon wird, entscheidest weiterhin du.

Ob eine Trefferliste im Alltag hilft, erfahre ich am besten an konkreten Beispielen. Welchen Begriff hast du eingegeben, und welchen Eintrag hättest du erwartet? Unter den Suchergebnissen kannst du eine kurze Rückmeldung geben. Oder komm im Discord vorbei und schnack mit mir darüber. Gerade bei einer Suche hilft mir so ein Beispiel mehr als meine eigene Vermutung darüber, wonach andere Menschen suchen.