Unser Keyword-Feature ist der ultimative Storytelling-Booster für deine Serious Games Events. Es hebt die Interaktion und Kommunikation mit deinen Teams auf ein neues Level!
Mit gezielten Keywords sprichst du Teams direkt in Spielinformationen und Aufgaben an – persönlich und motivierend.
Das funktioniert so: In deinen Aufgabentexten deiner Schnitzeljagd, deiner Stadtrallye, deines Quiz-Events oder deines Outdoor-Escape-Games platzierst du spezielle Keywords, die in der App automatisch mit individuellen Daten wie Teamnamen, erspielten Punkten oder Aufgabenstatus ersetzt werden.
Zusätzlich lassen sich Berechnungen durchführen, um Inhalte dynamisch an den Punktestand oder den Lösungsstand anzupassen. So reagiert das Spiel noch genauer auf die Aktionen deines Teams.
Beispiel 1
Das Beispiel 1 zeigt die Möglichkeit der Personalisierung deines Schnitzeljagd Events durch die stetige Anzeige des individuellen Teamnamens.
„Hallo Team [show_teamname], herzlich willkommen im Event XY!“
„Super Team [show_teamname], die Aufgabe habt ihr richtig gelöst!“
„Weiter so [show_teamname], ihr seid dem Dieb auf der Spur!“
Beispiel 2
Beispiel 2 zeigt wie du Spieler/Teams durch stetiges Feedback motivieren kannst.
„Klasse Team [show_teamname], ihr habt aktuell [show_scored_points] Punkte erspielt! Weiter so!“
„Liebes Team [show_teamname], die Hälfte der Spielzeit ist um. Ihr habt jetzt [show_played_tasks] Aufgaben gespielt. Es warten noch [show_open_tasks] Aufgaben auf euch. Also ran an den Speck!“
„Hey, gut gespielt bisher! Ihr habt von [show_played_tasks] gespielten Aufgaben ganze [show_solved_tasks] Aufgaben richtig gelöst und [show_failed_tasks] Aufgaben falsch beantwortet.“
Beispiel 3
Sogar der Inhalt deiner Texte lässt sich durch individuelle Werte austauschen. Schau dir mal die folgenden Sätze an!
„Hey, die Hälfte der Spielzeit ist um! [show_solved_tasks MAX:8 CONTENT: Das Ergebnis ist insgesamt noch ausbaufähig. Gibt noch einmal Vollgas an den letzten Stationen!][show_solved_tasks MIN:9 MAX:12 CONTENT:Insgesamt kein schlechtes Ergebnis aber es geht natürlich noch viel besser! Auf geht es!][show_solved_tasks MIN:13 CONTENT:Das Ergebnis lässt sich mehr als sehen. Weiter so auf den letzten Stationen in dieser Challenge!]“
Die Keywords im Überblick
Die 8 Standard-Keywords #
Es gibt eine ganze Reihe spannender Keywords die du in unserer Serious Games Schnitzeljagd Software nutzen kannst. Beachte, dass einige von ihnen in der Web App noch nicht funktionieren. Du solltest in jedem Fall immer gut testen!
[show_teamname] – zeigt den Teamnamen eines Teams/Spielers!
[show_username] – zeigt speziell nur den Usernamen eines Spieler-Accounts!
[show_played_tasks] – zeigt die Anzahl der gespielten Tabspots!
[show_solved_tasks] – zeigt die Anzahl der richtig gelösten Tabspots!
[show_failed_tasks] – zeigt die Anzahl an falsch gelösten Tabspots!
[show_open_tasks] – zeigt die Anzahl noch offener Tabspots im Event!
[show_scored_points] – zeigt die Anzahl an erspielten Punkten!
[show_open_points] – zeigt die Anzahl noch zu erspielender Punkte!
Bedingte Keywords #
Der spannendste Teil der Keywords sind die Bedingungen. Ein Inhalt erscheint erst, wenn das Team etwas erreicht hat. Ist die Bedingung nicht erfüllt, verschwindet der ganze Block
spurlos — die Spieler sehen keine Lücke und keine Fehlermeldung.
Optional kannst du aber einen Alternativtext angeben, der stattdessen erscheint.
Der Keyword-Dialog bietet dafür drei geführte Muster an. Du füllst nur die Felder aus, die korrekte Schreibweise im Test erzeugt der Dialog.
Es gibt folgende bedingte Keywords:
[show_played_tasks MIN:8 CONTENT: Dein Text] – zeigt Text nur wenn mindestens 8 Tabspots gespielt wurden. Funktioniert auch mit den anderen Keywords.
[show_played_tasks MAX:9 CONTENT: Dein Text] – zeigt Text nur wenn maximal 9 Tabspots gespielt wurden. Funktioniert auch mit den anderen Keywords.
[show_played_tasks MIN:2 MAX:9 CONTENT: Dein Text] – zeigt Text nur wenn mindestens 2 und maximal 9 Tabspots gespielt wurden. Funktioniert auch mit den anderen Keywords!
[show_played_tasks ID:1928 CONTENT:Dein Text] – zeigt Text nur, wenn der Tabspot mit der ID:1928 gespielt wurde. Funktioniert auch mit den anderen Keywords!
[show_played_tasks NR:3 CONTENT: Dein Text] – zeigt Text nur, wenn der Tabspot Nummer 3 im Event gespielt wurde. Funktioniert auch mit den anderen Keywords!
[show_teamname NR:3] – zeigt den Teamnamen des Teams Nr. 3.
[show_teamname ID:323214] – zeigt den Teamnamen des Teams mit der ID: 323421.
ID oder Position (NR)? #
Normalerweise verweist die Bedingung über die Spot-ID auf den Spot. Die IDs vergibt das System beim Anlegen und genau da lauert die größte Falle des Features.
Kopierst du ein Event, bekommen alle Spots der Kopie neue IDs und die mitkopierten ID-Bedingungen zeigen ab dann stillschweigend nichts mehr an (dasselbe passiert beim Löschen und Neu-Hochladen). Die Alternative „Per Position (NR:)“ verweist auf die laufende Nummer des Spots. Sie übersteht Kopieren und Neu-Hochladen, verschiebt sich aber, wenn du Spots umsortierst.
Keywords lassen sich verschachteln (App-Versionen ab September 2026): #
Ein Keyword im CONTENT: eines anderen wird ebenfalls ersetzt. Der innere Inhalt erscheint nur, wenn beide Bedingungen erfüllt sind (UND-Verknüpfung). Beispiel [show_scored_points MIN:100 CONTENT:[show_played_tasks ID:17 CONTENT:Bonus frei!]] erscheint erst ab 100 Punkten und gespieltem Spot 17. Ältere App-Versionen brechen an der ersten schließenden Klammer ab. Dort kommt die Verschachtelung zerstückelt beim Spieler an. Vermeide bei Verschachtelungen aber einzelne eckige Klammern im übrigen Text.Custom Keywords
Neben den fest eingebauten Keywords kannst du pro Event eigene Platzhalter anlegen — für Angaben, die an vielen Stellen auftauchen und sich gern mal ändern: der Treffpunkt, die Ansprechpartnerin, ein Sponsorenname oder ein zentrales Codewort.
Du definierst Name und Inhalt einmal und schreibst in die Texte nur noch [custom:name]. Ändert sich die Angabe, passt du sie an
einer Stelle an.
Definieren & verwenden #
Definieren: Event-Konfiguration → Schritt „Inhalte“ → Tab „Custom Keywords“. Der Name wird klein geschrieben, ohne Leerzeichen (erlaubt sind Buchstaben, Ziffern, Bindestrich und Unterstrich) und muss im Event eindeutig sein. Das Formular prüft das beim Speichern.
Verwenden: In jedem Inhaltstext als [custom:name], am einfachsten über den Keyword-Dialog, der alle definierten Platzhalter mit einer Inhaltsvorschau auflistet.
Übersetzen: In den Event-Übersetzungen gibt es ebenfalls einen Tab „Custom Keywords“. Pro Sprache ein Feld je Platzhalter. Ein leeres Feld greift automatisch auf den Standard-Inhalt zurück; du übersetzt also nur, was sich wirklich unterscheidet.
So verhalten sich Custom Keywords #
- Der Inhalt darf HTML und sogar Standard Keywords enthalten. Ein [show_teamname] im Inhalt wird im Spiel ganz normal ersetzt.
- Ein Platzhalter ohne passende Definition (z. B. wegen eines Tippfehlers im Namen) bleibt im Spiel sichtbar roh stehen. Das ist unangenehm für die Spieler, aber dadurch fällt der Fehler im Testlauf sofort auf.
- Inhalts-Änderungen greifen, wenn ein Team das Event das nächste Mal vollständig lädt. Mitten im laufenden Spiel ändern sich bereits geladene Texte nicht sofort.
- Custom Keywords verweisen über ihren Namen. Sie überstehen Kopieren wie Neu-Hochladen eines Events, anders als die Spot-ID-Bedingungen.
- Ein Custom Keyword kann KEIN weiteres Custom Keyword enthalten. Eingesetzte Inhalte werden nicht erneut nach [custom:…] durchsucht.
Der Codewort-Trick: Custom Keywords in Lösungen #
Custom Keywords funktionieren auch im Spot-Passwort und in Lösungen. So pflegst du ein Codewort zentral, das die Spieler an mehreren Spots eintippen müssen. Ändert es sich, änderst dues an einer Stelle.
Wichtig: In Lösungen und Passwörtern nur reinen Text als Inhalt verwenden (kein HTML, keine Standard-Keywords). Die Spieler müssen den ersetzten Wert exakt eintippen können.
App-Versionen beachten #
Custom Keywords funktionieren nur bei App-Versionen ab September 2026; ältere App-Versionen zeigen [custom:name] als rohen Text an. Setze sie erst in Live-Events ein, wenn deine Zielgruppe mit Versionen ab September 2026 spielt.
Wo Keywords ersetzt werden und wo nicht
Ersetzt wird überall dort, wo die Spieler Inhalte in der App oder im Browser sehen:
Am Spot: Titel, Beschreibung, Aufgabenstellung, die Reaktionstexte auf richtige und falsche Antworten, Hinweise.
Am Event: Info-Text, Custom Pages, Finish-Text.
Im Team-Chat (nur App): auch Chat-Nachrichten laufen durch die Ersetzung.
Nicht ersetzt werden Keywords außerhalb des Spiels. Dort steht der Platzhalter wörtlich im Text. Zum Beispiel:
Im Roadbook-Ausdruck: Das PDF entsteht vor dem Event, es gibt dort noch keine Team-Daten. Rechne damit, dass Keywords im Ausdruck sichtbar sind oder halte Roadbook-Texte keyword-frei.
In E-Mails und anderen Ausgaben außerhalb von App und Browser-Version.
Zwischen App und Browser-Version gibt es zwei bewusste Unterschiede: [show_username]
zeigt im Browser den Teamnamen und einen Team-Chat gibt es nur in der App.
Alle anderen Keywords verhalten sich identisch.
Praxisregeln & Stolperfallen
Die ID-Falle beim Kopieren: Spot-IDs entstehen beim Anlegen der Spots. Wird ein Event kopiert, bekommen alle Spots der Kopie neue IDs und die mit kopierten ID-Bedingungen verweisen weiter auf die Spots des Originals und zeigen in der Kopie stillschweigend nichts mehr an, ohne Fehlermeldung.
Dasselbe passiert, wenn ein Event gelöscht und (z. B. per JSON) neu hochgeladen wird. Nach jedem Kopieren oder Neu-Upload gehören die ID-Bedingungen deshalb auf die Checkliste.
Bewährter Arbeitsablauf: Solange sich die Spot-Reihenfolge noch ändert, mit NR: arbeiten. Steht das Event, dann auf ID: umstellen. Die Position verschiebt sich bei jedem Umsortieren, die ID nicht.
Schwellen mit „gespielte Spots“ statt mit „gelöste Spots“ bauen, denn sonst droht Teams mit Falschantworten ein Festhängen.
Entscheidungen als eigene Spots modellieren: Keywords können abfragen, ob ein Spot gespielt/gelöst wurde und nicht, welche Antwort gegeben wurde. Soll eine Wahl der Spieler Folgen haben, lege für jede Option einen eigenen (versteckten) Konsequenz-Spot an und frage diesen per Bedingung ab.
Immer im Testlauf verifizieren: Bedingungen scheitern lautlos, d.h. ob IDs stimmen, Schwellen greifen und Inhalte wie geplant erscheinen, siehst du nur im Durchspielen. Plane denTestlauf fest ein, besonders nach Uploads und Umsortierungen.
Neue Funktionen und alte App-Versionen #
Die Basis-Keywords und die Bedingungs Muster funktionieren seit Jahren in App und Browser-Version.
Neu hinzugekommen sind: der Alternativtext (ELSE), die Custom Keywords und die Möglichkeit, Keywords ineinander zu verschachteln.
Diese Funktionen setzen aktuelle App-Versionen voraus (ab September 2026). Auf älteren erscheinen sie als roher Text bzw. als Teil des Inhalts; die Browser-Version ist zentral immer aktuell.
Faustregel: Bei offenem Publikum konservativ bleiben, in geschlossenen Events mit frisch installierter App kannst du sie früher nutzen. Die Dialoge im CMS warnen an den betroffenen Stellen.
Häufige Fragen
Die Spieler sehen [show_teamname] als Text — warum?
Meist ein Tippfehler oder eine neue Funktion auf einer alten App-Version.
Bei [custom:…] prüfe, ob der Name exakt so im Custom-Keywords-Tab definiert ist.
Mein bedingter Inhalt erscheint nie.
Die Bedingung ist nicht erfüllt oder sie zeigt ins Leere, weil die Spot-IDs nach dem Kopieren des Events oder einem Neu-Upload nicht mehr stimmen.
Prüfe die ID in der Rätselübersicht und teste die Stelle.
Im Roadbook-Ausdruck stehen die Keywords wörtlich drin.
Das ist normal: Das Roadbook entsteht vor dem Event, ohne Team-Daten. Ersetzt wird nur im Spiel.
Die Begrüßung zeigt den Anmeldenamen statt des Teamnamens.
[show_teamname] enthält den Account-Namen, bis das Team selbst einen Teamnamen eingegeben hat.
Setze den Platzhalter erst nach der Teamnamen-Eingabe ein.
Kann ich abfragen, welche Antwort ein Team gegeben hat?
Nein, abfragbar ist nur der Status eines Spots (gespielt, gelöst, falsch, offen). Der übliche Weg: pro Antwort-Option einen eigenen Konsequenz-Spot anlegen und dessen Status abfragen.
Funktionieren Keywords in Lösungen?
Die Standard-Keywords funktionieren nicht in Lösungen.
Custom Keywords schon:Damit pflegst du z. B. ein zentrales Codewort. Verwende dort nur reinen Text.
Zählt ein falsch beantworteter Spot als „gespielt“?
Ja, „gespielt“ heißt beantwortet, egal ob richtig oder falsch. „
Gelöst“ zählt nur richtige, „falsch beantwortet“ nur falsche Antworten, „offen“ die noch unbeantworteten.
Kann ich das Ergebnis vorab sehen?
Im Editor nicht, dort bleiben Keywords roher Text. Das Ergebnis prüfst du im Testlauf: Lege dir ein Testteam an und spiele die betroffenen Stellen in App oder Browser-Version an.
