Include

Durch <include> kann mit dem Attribut 'target' ein weiteres Script aufgerufen werden, welches direkt an dieser Stelle eingefügt und ausgeführt wird. Dies ist insbesondere für Questen praktisch, da bei vier verschiedenen Ausgängen sonst oft entweder Texte kopiert werden müssten oder die Szenen kurz vor dem tatsächlichen Ende nur noch ein einziges choice-Tag hätten.

Die Ziel-Szene im target-Attribut wird relativ zum Verzeichnis des aktuellen Skriptes und ohne die Extension ('xml') angegeben. die Angabe von Unterverzeichnissen ist möglich, ebenso '../', um wieder ein Verzeichnis hoch zu gehen.

<include target="neue_szene"/>

Ruft die Datei neue_szene.xml im gleichen Verzeichnis auf.

Stellen wir uns eine größere Quest mit mehreren Handlungsorten vor, z. B. ein Herrenhaus und ein Dorf in der Nähe. Wegen der besseren Übersicht verteilen wir die Dateien der Quest auf zwei Verzeichnisse:

/quest+
      +/Dorf+
      |     +tsa-schrein.xml
      |     +...
      +/Herrenhaus+
                  +eingangshalle.xml
                  +speisesaal.xml
                  +...

Um von der Beschreibung der Eingangshalle die Datei speisesaal.xml einzubinden:

<include target="speisesaal"/>

Um die Datei tsa-schrein.xml im Verzeichnis quest/Dorf einzubinden, muss man erst ein Verzeichnis nach oben (../) und dann in das Unterverzeichnis Dorf/ wechseln:

<include target="../Dorf/tsa-schrein"/>

Und dran denken: Wir befinden uns möglicherweise in einem Linux-System. Groß-/Kleinschreibung beachten!