# Story

## Einsatz

Eine Story beschreibt den geschichtlichen Ablauf in einem Exit Game. Die Story wird über ein Verzeichnis und die Datei `story.json`definiert. Der Verzeichnisname entspricht dabei der ID der Story, die in dem Event referenziert wird.

Die Story referenziert auf der anderen Seite in unterschiedlichen Kapitels (Chapters) in der Regel die von den Spielern zu lösende Rätsel (Quest).

## Definition

### Funktionen

#### {eventname}

Gibt an der angegeben Posiotion den Namen des Event aus. Der Name wird in der `event.json` unter `name` beschrieben.

#### {storyname}

Gibt an der angegeben Position den Namen der Story aus. Der Name wird in der `story.json` unter `name` beschrieben.

#### {image: }

Bindet an der angegebenen Position eine Bilddatei ein, die aus dem Verzeichnis der Story gelesen wird. Es ist der Dateinamen mit Dateiendung anzugeben.

#### {audio: }

Bindet an der angegebenen Position eine Bilddatei ein, die aus dem Verzeichnis der Story gelesen wird. Es ist der Dateinamen mit Dateiendung anzugeben.

Folgende Parameter sind zulässig

| Parameter | Beschreibung | Werte |
| -------- | -------- | -------- |
| autoplay | Startet die Wiedergabe beim Laden der Seite. | true/false |
| loop | Spielt die Audio-Datei in einer Endlosschleife ab. | true/false |
| controls | Zeigt die Kontrollelemente an. | ture/false |
| volume | Bestimmt die Lautstärke der Audio-Datei. | 0..1 |
| type | Bestimmt den MIME-Type der Audio-Datei. | mp3, ogg, wav |
| description | Beschreibt die Audio-Datei. Diese ANgabe wird auf dem Button zum Mute/Unmute angezeigt.| Die ist ein Klang |
| credits | Definiert Hinweise zu dem Autor bzw. der Quelle und Lizenz. Die Hinweise sind URL-konform anzugeben. | (c)%202020%20... |

### Navigation

#### _chapterid_

##### #random

##### #junction

#### #redirect (tbd

(Weiterleitung auf eine weitere Seite mit der Absicht, den Fortschritt dieses Kapitels zu erfassen, Punkte gutzuschreiben und ggf. die Vorausetzungen für eine precondition zu setzen)

### Countdown