===Einfacher ZB-Grundaufbau===

Einführungstext (Z4), dann erste Talentprobe (Z5) und wenn diese gelingt, eine weitere (Z11), danach EP-Vergabe (Z14,18) und wenn beide Proben positiv verliefen, auch Gewinn eines Gegenstands (Z19); Texte nur zwischen p und /p:

<?xml version="1.0" encoding="UTF-8"?>

<!-- Kommentar zu Auftreten, Autor, Besonderheiten (z.B. ob Humor-ZB) -->

</challenge>

</scene>

===Einfacher ZB-Grundaufbau mit variierenden Textstücken===

Viele Begegnungen haben variierende Textinhalte, die aber das gleiche beschreiben, dadurch wird für Abwechselung innerhalb einer ZB gesorgt und es ist nicht immer der gleiche langweilige Text, den man sofort erkennt. Die ist noch besser einsetzbar für gleichwertige Ereignisse, wo also nicht jeder Text innerhalb der ZB aufeinander aufbauen muss und sich auch von den gleichwertigen cases unterscheiden kann.

<?xml version="1.0" encoding="UTF-8"?>

<!-- Kommentar zu Auftreten, Autor, Besonderheiten (z.B. ob Humor-ZB) -->

</challenge>

</scene>

===ZB mit Voraussetzung===

In Z2 wird eine Talentvoraussetzung (auch möglich: Gegenstand X muss vorhanden sein - has item="X|Y|Z") abgefragt, der Char muss als eines der angegebenen Talent auf dem angegeben Mod haben, sonst wird der success-Zweig nicht ausgeführt (in dem der Charakter einen Gegenstand erhält) und es bleibt nur ein Trösttext (in diesem Falle mit einer anderen Probe, um noch etwas EP zu erhalten)...

<has talent="X|Y" mod="+X">

<success>

</failure>

</has>

==Talente==

===Einfache Talentprobe===

<challenge talent="Talent" mod="+X">

<success>

</failure>

</challenge>

===Erleichterte Talentprobe durch Gegenstände===

In Z1 wird abgefragt, ob einer der angegebenen Gegenstände vorhanden ist, wenn ja, wir die Probe erleichtert (Z3), ansonsten erschwert durchgeführt (Z13):

<has item="X|Y">

<success>

</failure>

</has>

===Alternative Talentabfrage===

Anmerkung: Dies betrifft vor allem Talente, die eher selten sind und wo der Held auf ein Talent ausweichen kann, das er ziemlich sicher hat. Ansonsten könnte im failure-Zweig des ersten has talent auch ein zweites has talent eingebaut werden.

<has talent="Talent1">

<success>

</failure>

</has>

===Verbesserte modifizierte Probe===

Mit dieser Methode kann man eine Probe recht übersichtlich mit mehreren Faktoren modifizieren. Neben Ausrüstung sind auch andere Sachen wie Variablen oder unterstützende Talente möglich.

<store name="probenvariable_1" scope="quest">5</store><!-- Probe ohne Ausrüstung um 5 erschwert. -->

</challenge>

===Mann oder Frau?===

In Z3 wird der Text für Männer ausgegeben, in Z6 der für Frauen.

<switch attribute="gender">

<case value="male">

</else>

</switch>

Oder auch direkt in den Text einbinden:

<if attribute="gender" equals="female" null="Ein geschlechtsloses Wesen" then="Eine junge Frau" else="Ein junger Mann"/> kommt dir entgegen.

===Hat der Held soundsoviel Geld?===

Wenn es wichtig ist, ob der Held einen Mindestbetrag an Geld dabei hat.

<has attribute="cash" min="X">

<success>

</failure>

</has>

===Wurde der Held verletzt?===

Wenn es wichtig ist, ob der Held in einem Kampf Schadenspunkte bekommen hatte.

<store name="LEPvorher" scope="quest"><get attribute="LEP"/></store>

#Prügelei ...

</else>

</switch>

==nützliche Gegenstands-Kombinationen==

===Schreibzeug?===

Für Schreibzeug gibt es viele Kombinationen, daher steht dafür ein Makro zur Verfügung

<store name="hatSchreibzeug"/>

<p>Der Held hat

</switch>

</p>

Ggf. stellt der Editor die Include-Datei als nicht vorhanden dar. Das bitte einfach ignorieren. Zum einen liegt das daran, dass der absolute Pfad noch nicht richtig aufgelöst wird, zum anderen daran, dass diese Datei ggf. lokal gar nicht zur Verfügung steht.

===Zufallstexte===

Eine normale Zufallsauswahl, jeder Case ist gleichberechtigt.

<random>

<case>

</case>

</random>

===Prozentuale Zufallsauswahl===

Wenn man die Ereignisse einer Zufallsauswahl etwas steuern will, weil manches häufiger als anderes auftreten soll.

Zuerst die Variable "zufall" setzen, so:

oder so:

Dann die möglichen Ergebnisse:

<switch name="zufall">

<case min="1" max="49">

</else>

</switch>

==Bewertung unterschiedlicher Ausrüstung bei Proben==

Bei Proben sind unterschiedliche Gegenstände oft unterschiedlich nützlich. Folgendes System erlaubt eine einfache aber detaillierte Nutzung verschiedener Gegenstände. Man muss nur noch die entsprechenden Gegenstände einfügen (Getrennt mit | wenn mehrere in Frage kommen) und den Modi auf die Probe festlegen. Bei fehlender Ausrüstung entscheidet der Schreiber, ob und wie es weiter geht (hoher Malus auf die Probe oder einfach nicht möglich):

<has item="Gute Ausrüstung|Andere gute Ausrüstung">

</challenge>

==Mehrmaliges Verwenden mit <store> und <switch> verhindern==

Mittels <store> und <switch> kann man zB eine mehrmalige Benutzung bzw. mehrmaligen Besuch eines Ortes unterbinden.

<switch name="ValName">

<null>

</else>

</switch>

''ValName''stellt den Variablennamen dar, dieser kann frei vergeben werden.

<switch name="besuchtTaverne">

<null>

</else>

</switch>

==Gruppenzeug==

<p>Name: <get attribute="name"/></p>

</for>

===Einer Gruppe (von selektierten) Helden X eines Gegenstandes wegnehmen===

'''Achtung Stolperstein:''' Nach Aufruf dieser Routine ist nurnoch ein Held selektiert. Außerdem wird die Variable ''anzahl_wegzuwerfen'' überschrieben (verringert)!

<!-- Routine wirft bis zu "anzahl_wegzuwerfen" Gegenstände "wegzuwerfender_gegenstand" weg. Bonus: Speichert die Anzahl tatsächlich weggeworfenen Gegenstände in "anzahl_weggeworfen". Funktioniert auch für Einzelhelden. -->

<retain name="entferne_x_dieses_gegenstandes" id="entferne_gegenstaende">

</for>

</retain>

==Sonstiges==

Datei 1:

<q>Text informiert SC darüber, dass er einige Zeit in der Queste verbleiben muss.</q>

</ul>

Datei 2 (raus.xml):

<has name="held_wird_eingesperrt">

</failure>

</has>

=== Jahreszeiten ===

''Nordhalbkugel''

<switch attribute="monat">

</switch>

Für die ''Südhalbkugel'' gilt entsprechend der nachfolgende Quelltext. Beachte bitte, dass der Äquator ''sehr'' weit im Süden verläuft und nicht zwischen den zwei Kontinenten, siehe dazu [[Antamar_Welt#Der_Kontinent|hier]] einige Karten.

<switch attribute="monat">

</switch>

=== Zufällige Zuweisung einer anderen ZB ===

Folgende Funktion gilt für ZBs, um es zu ermöglichen, dass bei einer misslungenen Startbedingung, statt der ursprünglichen ZB, eine andere, zufällige ZB ausgeführt wird.

<failure>

<quest status="rejected"/>

</failure>

=== Abfrage der Landessprache ===

AOQML ermöglichst eine Abfrage der Region, in der sich ein Char gerade befindet, nicht aber der dort vorwiegend gesprochenen Landessprache. Folgender Code speichert die Landessprache in der Variable "name" ab. Ob der Held diese spricht, ist in der Variable "kannsprache" gespeichert.

<switch attribute="site_staatenbund">

<case val="Heiliges Kaiserreich">

</success>

</has>

=== Heldeneinstellungen bei Kämpfen im Orkreich beachten ===

Diese Vorlage dient zur Abfrage der Heldeneinstellungen (Auftreten: offen-heimlich; im Kampf: aggressiv-beschwichtigend). Um einen Konsens zu finden, wie man die Heldeneinstellungen berücksichtigen könnte, werden Richtlinien angeboten. Jeder Autor ist jedoch frei in seinen Entscheidungen und kann auch von den Richtlinien abweichen.

<switch attribute="vorgehen" >

<case val="offen">

</else>

</switch>

<switch attribute="vorgehen" >

<case val="offen">

</else>

</switch>

=== Mondphasen durchgehen ===

Folgender Code beinhaltet sämtliche mögliche Mondphasen in ihren Kombinationsmöglichkeiten. Je nach Anwendungsbereich, kann der ''switch'' auf das Attribut ''tag'' auch ausgegliedert werden.

<switch attribute="monat">

<case value="Lichtmond|Liebesmond|Ahnenmond">

</case>

</switch>

=== Permanente Steigerungen ===