AOQML-Manual: Unterschied zwischen den Versionen

Aus AntamarWiki
Wechseln zu: Navigation, Suche
K (→‎AOQML-Tags)
(→‎AOQML-Tags)
 
(104 dazwischenliegende Versionen von 15 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
'''Wichtig für die Bearbeitung und Darstellung hier im Wiki:''' Es gibt ein SyntaxDarstellungssystem. Um wunderbare Beispiele anzeigen zu lassen, muss ein xml-Code lediglich von diesem Tag umschlossen sein: <nowiki><syntaxhighlight lang="xml">...</syntaxhighlight></nowiki>.
 +
 +
 
==AOQML Syntax==
 
==AOQML Syntax==
  
Zeile 4: Zeile 7:
  
 
Tags werden in spitze Klammern eingeschlossen. Jeder Tag erfordert ein öffnendes (z. B. &lt;challenge&gt;) und ein schließendes Element. Schließende Elemente werden mit einem / nach der Klammer begonnen (&lt;/challenge&gt;). Alles, was zwischen den beiden Tags steht, ist der Bedingung oder Aktion unterworfen, die das Tag bestimmt. Tags können verschachtelt werden, dabei muss darauf geachtet werden, dass die Ebenen sauber getrennt sind. Das heißt, man darf kein Tag schließen, wenn nicht alle unterhalb dieses Tags geöffneten geschlossen sind:<br/>
 
Tags werden in spitze Klammern eingeschlossen. Jeder Tag erfordert ein öffnendes (z. B. &lt;challenge&gt;) und ein schließendes Element. Schließende Elemente werden mit einem / nach der Klammer begonnen (&lt;/challenge&gt;). Alles, was zwischen den beiden Tags steht, ist der Bedingung oder Aktion unterworfen, die das Tag bestimmt. Tags können verschachtelt werden, dabei muss darauf geachtet werden, dass die Ebenen sauber getrennt sind. Das heißt, man darf kein Tag schließen, wenn nicht alle unterhalb dieses Tags geöffneten geschlossen sind:<br/>
−
'''richtig'''
+
'''richtig:'''
−
&lt;tag1&gt;
+
<syntaxhighlight lang="xml">
−
  &lt;tag2&gt;
+
<tag1>
−
  &lt;/tag2&gt;
+
  <tag2>
−
&lt;/tag1&gt;
+
  </tag2>
 +
</tag1>
 +
</syntaxhighlight>
  
−
'''falsch'''
+
'''falsch:'''
−
&lt;tag1&gt;
+
<syntaxhighlight lang="xml">
−
  &lt;tag2&gt;
+
<tag1>
−
  &lt;/tag1&gt;
+
  <tag2>
−
&lt;/tag2&gt;
+
  </tag1>
 +
</tag2>
 +
</syntaxhighlight>
  
 
Es gibt einige Tags, die kein zweites zum Schließen erfordern. Bei diesen wird das / an das Ende gesetzt:
 
Es gibt einige Tags, die kein zweites zum Schließen erfordern. Bei diesen wird das / an das Ende gesetzt:
−
&lt;set attribute="cash" inc="20"/&gt;
+
<syntaxhighlight lang="xml"><set attribute="cash" inc="20"/></syntaxhighlight>
 +
 
 +
Außerdem kann man eine Szene (beispielsweise nach einem include oder choice, das zu einer Abzweigung führt) vorzeitig abbrechen lassen, wenn folgender Code eingegeben wird:
 +
 
 +
<syntaxhighlight lang="xml"><quest status="continue" /></syntaxhighlight>
  
 
==Aufbau der XML-Datei==
 
==Aufbau der XML-Datei==
 +
link: [[Beispiel einer Zufallsbegnung in aoqml]] zur Veranschaulichung
  
 
===Grundgerüst===
 
===Grundgerüst===
  
 
Jede Datei muss mit diesem Grundgerüst beginnen:
 
Jede Datei muss mit diesem Grundgerüst beginnen:
−
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+
<syntaxhighlight lang="xml">
−
&lt;scene&gt;
+
<?xml version="1.0" encoding="UTF-8"?>
−
...
+
<scene xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://eisentrutz.antamar.eu/aoqml.xsd">
−
&lt;/scene&gt;
+
...
−
Erst wird der Inhalt der datei als XML nach Sprachversion 1.0 definiert, danach folgt das Tag &lt;scene&gt;...&lt;/scene&gt;. Außerhalb dieses Tags darf nichts außer der XML-Definition stehen!
+
</scene>
 +
</syntaxhighlight>
 +
Erst wird der Inhalt der datei als XML nach Sprachversion 1.0 definiert, danach folgt das Tag &lt;scene&gt;...&lt;/scene&gt;. Außerhalb dieses Tags darf nichts stehen, mit Ausnahme der XML-Definition und Kommentare, die wie folgt gemacht werden können:
 +
<syntaxhighlight lang="xml">
 +
<!-- hier folgt eine Erklärung -->
 +
</syntaxhighlight>
  
 
===Formatierung===
 
===Formatierung===
−
Für bessere Lesbarkeit und Übersicht bitte alle Ebenen um zwei Stellen gegenüber der darüberliegenden Ebene einrücken:
+
Für bessere Lesbarkeit und Übersicht bitte alle Ebenen um zwei Stellen (zwei Leerzeichen) gegenüber der darüber liegenden Ebene einrücken:
−
Ebene1
+
<syntaxhighlight lang="xml">
−
  Ebene2
+
<Ebene1>
−
    Ebene3
+
  <Ebene2>
−
      Ebene4
+
    <Ebene3>
−
      /Ebene4
+
      <Ebene4>
−
    /Ebene3
+
      </Ebene4>
−
  /Ebene2
+
    </Ebene3>
−
/Ebene1
+
  </Ebene2>
 +
</Ebene1>
 +
</syntaxhighlight>
  
 
===Zeichensatz===
 
===Zeichensatz===
−
Im Kopf der Datei wird als Kodierung UTF-8 festgelegt. Das muss dann auch eingehalten werden. Das lässt sich in den (Speichern-)Optionen eures Editors einstellen. (Kodierung, Format, Zeichensatz oder wie auch immer das benannt ist.)
+
Im Kopf der Datei wird als Kodierung '''UTF-8''' festgelegt. Das muss dann auch eingehalten werden. Das lässt sich in den (Speichern-)Optionen eures Editors einstellen. (Kodierung, Format, Zeichensatz oder wie auch immer das benannt ist.) Ohne BOM (Byte Order Mark).
 +
 
 +
===Sonstige Formalitäten===
 +
*Einrückungen immer zwei Leerzeichen
 +
*keine Zeilenumbrüche im Text
 +
 
 +
==HTML-Tags==
 +
 
 +
Viele üblichen (X)HTML-Tags können verwendet werden, um Text darzustellen und zu formatieren. So kann z. B. das HTML-&lt;p&gt;-Tag verwendet werden, um Textabsätze zu erzeugen. Der &lt;q&gt;-Tag sollte für wörtliche Rede benutzt werden. Anderes XHTML sollte aber sparsam verwendet werden, um das CSS-Design von Antamar berücksichtigen.
 +
 
 +
===String Interpolation===
 +
In allen Text-Inhalten kann sogenannte String-Interpolation verwendet werden, also Platzhalter (${...}) durch Variablen ersetzt werden:
 +
 
 +
'''String-Interpolation:'''
 +
<syntaxhighlight lang="xml">
 +
<store name="titel">Baron von Tannenbrück</store>
 +
<p>Dir wurde der Titel ${titel} verliehen.</p>
 +
</syntaxhighlight>
 +
 
 +
Dabei ist <store ...> ein AOQML-Tag, in diesem Fall zum Speichern des Textes "Baron von Tannenbrück" in einer Variable mit dem Namen "titel", die dann durch String-Interpolation (${titel}) wieder abgerufen wird. Zu AOQML-Tags mehr im folgenden Abschnitt.
  
 
==AOQML-Tags==
 
==AOQML-Tags==
Zeile 48: Zeile 86:
 
Bisher können folgende Tags benutzt werden (alphabetische Liste):
 
Bisher können folgende Tags benutzt werden (alphabetische Liste):
  
−
*case - für Fallunterscheidungen &rarr; [[switch]] und Zufallsauswahlen &rarr; [[random]]
+
*[[action]] - Aktionen die den Helden betreffen, z.B. Annahme einer Arbeit / Einsperren im Kerker
 +
*[[add-EP]] - geb. EP für Fertigkeiten vergeben
 +
*[[case]] - für Fallunterscheidungen &rarr; [[switch]] und Zufallsauswahlen &rarr; [[random]]
 
*[[challenge]] - für Proben auf Talente und Eigenschaften
 
*[[challenge]] - für Proben auf Talente und Eigenschaften
 +
*[[Chat (Tag)|chat]] - für das Einbinden eines Chatfensters.
 
*[[choice]] - gibt dem Spieler verschiedene Auswahlmöglichkeiten vor
 
*[[choice]] - gibt dem Spieler verschiedene Auswahlmöglichkeiten vor
−
*[[fight#death|death]] - Kampfergebnis: Held tot (noch nicht implementiert) &rarr; [[fight]]
+
*[[countdown]] - zeigt an, wie lange eine Variable noch besteht
 
*[[fight#defeat|defeat]] - Kampfergebnis: Held besiegt &rarr; [[fight]]
 
*[[fight#defeat|defeat]] - Kampfergebnis: Held besiegt &rarr; [[fight]]
 
*[[delay]] - Reise des Helden verzögern
 
*[[delay]] - Reise des Helden verzögern
−
*[[take_drop|drop]] - Gegenstand aus Ausrüstungsliste entfernen
+
*[[AOQML:desc|desc]] - Liefert eine Beschreibung
 +
*[[damage]] - verursacht Schadenspunkte beim Held (auf Wunsch mit/ohne Wunden)
 +
*[[debug]] - Inhalte zum Testen auf dem Testserver bereitstellen
 +
*[[div]] - erzeugt eine OOC-Box
 +
*[[drop]] - Gegenstand aus Ausrüstungsliste entfernen
 +
*[[eval]] - Tag zum berechnen einfacher und komplexer mathematischer Funktionen
 
*[[switch|else]] - Fallunterscheidungen: Default-Option &rarr; [[switch]]
 
*[[switch|else]] - Fallunterscheidungen: Default-Option &rarr; [[switch]]
 
*[[fight#escape|escape]] - Kampfergebnis: Held flüchtet &rarr; [[fight]]
 
*[[fight#escape|escape]] - Kampfergebnis: Held flüchtet &rarr; [[fight]]
 
*failure - Prüfergebnis / Probe negativ &rarr; [[challenge]], [[has]]
 
*failure - Prüfergebnis / Probe negativ &rarr; [[challenge]], [[has]]
−
*[[store_fetch|fetch]] - gespeicherten Wert abrufen &rarr; [[store]]
+
*[[for]] - Erstellen von Schleifen
 +
*[[store_fetch|fetch]] - gespeicherten Wert abrufen &rarr; [[store_fetch|store]]
 
*[[fight]] - Kampf
 
*[[fight]] - Kampf
−
*[[get_set|get]] - Attribute des Helden abfragen
+
*[[function]] - spezielle Funktionen
 +
*[[generateName]] - Zufallsnamen generieren
 +
*[[get]] - Attribute des Helden oder eines Gegenstandes oder eines Gebäudes abfragen
 
*[[has]] - auf vorhandene Ausrüstung und Talente prüfen
 
*[[has]] - auf vorhandene Ausrüstung und Talente prüfen
 +
*[[hero]] - Held aus Gruppe heraussuchen
 +
*[[if]] - für bedingte Text- oder Wertauswahl
 +
*[[img]]- um Bilder einzubinden
 
*[[include]] - andere Questdateien einbinden
 
*[[include]] - andere Questdateien einbinden
−
*[[q]] - wörtliche Rede (?)
+
*[[input]] - ein Eingabefeld anzeigen
−
*[[quest]] - zur Steuerung der Queste, z. B. um eine Quest als (noch nicht) abgeschlossen zu markieren
+
*[[inventar]]- Tag der verschiedene Gegenstände in sich speichert um z.B. Truhen oder ähnliches zu simulieren.
 +
*[[AOQML:item|item]] wählt ein zufälligen Gegenstand aus der DB
 +
*[[item-select]] - einen Gegenstand vom Spieler auswählen lassen
 +
*[[map]] - fügt eine Grafik ein, auf der Questlinks platziert werden (z.B. für grafische Dungeons)
 +
*[[maze]] - fügt eine Karte der gesehenen+erinnerten "Räume" aus Kachel-Grafiken ein (für grafische Dungeons)
 +
*[[paths]] - geografische Richtungsnavigation
 +
*[[q]] - wörtliche Rede
 +
*[[Quest (Tag)|quest]] - zur Steuerung der Queste, z. B. um eine Quest als (noch nicht) abgeschlossen zu markieren
 
*[[random]] - Zufallsauswahl
 
*[[random]] - Zufallsauswahl
−
*[[retain_replay|replay]] - gespeicherte Aktionsfolge abrufen &rarr; [[retain]]
+
*[[ranged-defence]] - NPCs attackieren den Held mit Fernkampfwaffen
−
*[[retain_replay|retain]] - Aktionsfolge speichern &rarr; [[replay]]
+
*[[Regeneration (AOQML)|regeneration]] - Stoppt die Regeneration für den Held in der Quest.
 +
*[[restrict]] - Stellt sicher das bestimmte AOQML-Teile nur einmal pro Held ausgeführt werden.
 +
*[[retain_replay|replay]] - gespeicherte Aktionsfolge abrufen &rarr; [[retain_replay|retain]]
 +
*[[retain_replay|retain]] - Aktionsfolge speichern &rarr; [[retain_replay|replay]]
 
*[[reverse]] - Held muss an den zuletzt besuchten Ort zurückkehren
 
*[[reverse]] - Held muss an den zuletzt besuchten Ort zurückkehren
−
*[[fight#rivals|rivals]] - Kampf: Gegner festlegen
+
*[[fight#rivals|rivals]] - im Kampf Gegner festlegen
 
*[[scene]] - oberstes Tag, definiert Beginn und Ende der XML-Datei
 
*[[scene]] - oberstes Tag, definiert Beginn und Ende der XML-Datei
−
*[[get_set|set]] - Werte des Helden verändern
+
*[[select]] - Wahl des handelnden/betroffenen Helden in der Gruppe
−
*[[store_fetch|store]] - Wert speichern um später darauf zugreifen zu können &rarr; [[fetch]]
+
*[[set]] - Werte des Helden verändern
 +
*[[steal]] - Begleiter entfernen (= gemeiner Viehraub!)
 +
*[[store_fetch|store]] - Wert speichern um später darauf zugreifen zu können &rarr; [[store_fetch|fetch]]
 
*success - Prüfergebnis / Probe positiv &rarr; [[challenge]], [[has]]
 
*success - Prüfergebnis / Probe positiv &rarr; [[challenge]], [[has]]
 
*[[switch]] - Fallunterscheidung
 
*[[switch]] - Fallunterscheidung
−
*[[take_drop|take]] - Gegenstand in die Ausrüstungsliste legen
+
*[[take]] - Gegenstand in die Ausrüstungsliste legen
 +
*[[transfer]] - Austausch von Gegenständen zwischem Held und einem Behälter
 +
*[[travel]] - startet eine Reise
 +
*[[var-dump]] - gibt gesetzte Variablen aus -> hilft beim Debuggen
 
*[[fight#victory|victory]] - Kampfergebnis: Gegner durch Held besiegt
 
*[[fight#victory|victory]] - Kampfergebnis: Gegner durch Held besiegt
  
−
Weiter können auch die üblichen (X)HTML-Tags verwendet werden um Text zu formatieren. Es kann z. B. das HTML-&lt;p&gt;-Tag verwendet werden, um Textabsätze zu erzeugen. XHTML sollte aber sparsam verwendet werden und das CSS-Design von Antamar berücksichtigen.
+
==Sonstiges==
 +
 
 +
[[Besondere Werte]] (Würfelergebnisse berechnen, Zufall und Wahrscheinlichkeit, ..)
 +
 
 +
'''Zufälligen Gegenstand aus der Datenbank auswählen'''<br/>
 +
s. [[AOQML:item|item-Tag]]
 +
 
 +
'''Zählen'''<br/>
 +
 
 +
Beispiel eines [[AOQML-Zahlencounter]] zum zählen von irgendwas.  
 +
 
 +
===Zufallsauswahl aus mehreren Möglichkeiten===
 +
Will man z.B. einen von mehreren Gegenständen einer Liste abfragen, dann kann man einen [[random]]-Block vorschalten:
 +
<syntaxhighlight lang="xml">
 +
<random>
 +
<case><store name="Gegenstand">Holzkamm</store></case>
 +
<case><store name="Gegenstand">Dolch</store></case>
 +
<case><store name="Gegenstand">Amboss</store></case>
 +
</random>
 +
<take item="${Gegenstand}"/>
 +
</syntaxhighlight>
 +
 
 +
Alternativ kann das [[take]] auch direkt in den jeweiligen case reingeschrieben werden.
 +
 
 +
===ODER und UND===
 +
Will man prüfen, ob der Held einen von mehreren möglichen Gegenständen bei sich trägt, kann man das mit dem Operator "|" (entspricht einem ODER) erreichen:
 +
<syntaxhighlight lang="xml">
 +
<has item="Messer|Dolch|Schwert">
 +
<success>
 +
  Entweder Messer oder Dolch oder Schwert vorhanden.
 +
</success>
 +
<failure>
 +
  Weder Messer noch Dolch noch Schwert vorhanden.
 +
</failure>
 +
</has>
 +
</syntaxhighlight>
 +
 
 +
Man kann auch auf überprüfen, ob mehrere Gegenstände vorhanden sind:
 +
<syntaxhighlight lang="xml">
 +
<has item="Messer+Dolch">
 +
<success>
 +
  Messer und Dolch vorhanden.
 +
</success>
 +
<failure>
 +
  Entweder nur Messer oder nur Dolch oder keins von beiden vorhanden.
 +
</failure>
 +
</has>
 +
</syntaxhighlight>
 +
 
 +
Das "+" entspricht also einem UND.<br />
 +
Das "|" entspricht einem ODER.
  
−
==Sonstige Abfragen aus der A&O-Datenbank==
+
Diese zwei Operatoren sind jedoch nur bei [[has|&lt;has&gt;]] und [[switch|&lt;switch&gt;]] verfügbar.
  
−
Manchmal benötigt man spezielle Angaben aus der Datenbank. Die dazu benötigten Angaben sollen hier aufgelistet werden.
+
===nützliche Listen===
 +
* [[Held Attribute]]
 +
* [[NPC Liste]]
 +
* [[Waffenliste]]
 +
* [[Aktuelle_Warenliste|Warenliste]]
  
−
'''Zufälligen Gegenstand aus der Datenbank auswählen'''
+
[[Kategorie: AOQML]]
−
<take item="$(name FROM ant_ware WHERE preis -le 5 AND NOT att_selten AND NOT att_rare)"/>
 
−
Der Befehl hinter dem "$" ist eine SQL-Abfrage. Sie liefert den Namen eines zufällig ausgewählten Gegenstands aus der Tabelle ant_ware mit einem Preis von höchstens 5 Heller (-le = lower or equal) und ohne die Attribute selten (att_selten) oder rare (att_rare). Mit &lt;take item="..."&gt; wird der Gegenstand ins Inventar des Helden gelegt.
 
−
Mit den Optionen -ge (greater or equal), -lt  (lower than) und -gt (greater than) kann man dementsprechend zufällige Dinge auswählen, die 5H oder mehr, bzw. weniger oder mehr wert sind.
 
−
(Möglicherweise wird das später noch in eine einfachere Form gegossen.)
 

Aktuelle Version vom 20. April 2022, 12:27 Uhr

Wichtig für die Bearbeitung und Darstellung hier im Wiki: Es gibt ein SyntaxDarstellungssystem. Um wunderbare Beispiele anzeigen zu lassen, muss ein xml-Code lediglich von diesem Tag umschlossen sein: <syntaxhighlight lang="xml">...</syntaxhighlight>.


AOQML Syntax

Das Grundprinzip von AOQML entspricht dem von HTML/XML: Texte zwischen den Tags werden grundsätzlich, d.h. ggf. unter den durch die Tags bestimmten Bedinungen, ausgegeben, also dem Spieler angezeigt. Alle Texte, die vom Programm ausgewertet werden, sind also als Attribute angegeben. Auch diese werden ggf. ausgegeben, aber eben erst nach einer Bearbeitung durch den ZB-XML-Player. Mit anderen Worten: Steuerwerte befinden sich niemals zwischen den Tags.

Tags werden in spitze Klammern eingeschlossen. Jeder Tag erfordert ein öffnendes (z. B. <challenge>) und ein schließendes Element. Schließende Elemente werden mit einem / nach der Klammer begonnen (</challenge>). Alles, was zwischen den beiden Tags steht, ist der Bedingung oder Aktion unterworfen, die das Tag bestimmt. Tags können verschachtelt werden, dabei muss darauf geachtet werden, dass die Ebenen sauber getrennt sind. Das heißt, man darf kein Tag schließen, wenn nicht alle unterhalb dieses Tags geöffneten geschlossen sind:
richtig: 

<tag1>
  <tag2>
  </tag2>
</tag1>

falsch: 

<tag1>
  <tag2>
  </tag1>
</tag2>

Es gibt einige Tags, die kein zweites zum Schließen erfordern. Bei diesen wird das / an das Ende gesetzt: 

<set attribute="cash" inc="20"/>

Außerdem kann man eine Szene (beispielsweise nach einem include oder choice, das zu einer Abzweigung führt) vorzeitig abbrechen lassen, wenn folgender Code eingegeben wird: 

<quest status="continue" />

Aufbau der XML-Datei

link: Beispiel einer Zufallsbegnung in aoqml zur Veranschaulichung

Grundgerüst

Jede Datei muss mit diesem Grundgerüst beginnen: 

<?xml version="1.0" encoding="UTF-8"?>
<scene xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://eisentrutz.antamar.eu/aoqml.xsd">
...
</scene>

Erst wird der Inhalt der datei als XML nach Sprachversion 1.0 definiert, danach folgt das Tag <scene>...</scene>. Außerhalb dieses Tags darf nichts stehen, mit Ausnahme der XML-Definition und Kommentare, die wie folgt gemacht werden können: 

<!-- hier folgt eine Erklärung -->

Formatierung

Für bessere Lesbarkeit und Übersicht bitte alle Ebenen um zwei Stellen (zwei Leerzeichen) gegenüber der darüber liegenden Ebene einrücken: 

<Ebene1>
  <Ebene2>
    <Ebene3>
      <Ebene4>
      </Ebene4>
    </Ebene3>
  </Ebene2>
</Ebene1>

Zeichensatz

Im Kopf der Datei wird als Kodierung UTF-8 festgelegt. Das muss dann auch eingehalten werden. Das lässt sich in den (Speichern-)Optionen eures Editors einstellen. (Kodierung, Format, Zeichensatz oder wie auch immer das benannt ist.) Ohne BOM (Byte Order Mark).

Sonstige Formalitäten

  • Einrückungen immer zwei Leerzeichen
  • keine Zeilenumbrüche im Text

HTML-Tags

Viele üblichen (X)HTML-Tags können verwendet werden, um Text darzustellen und zu formatieren. So kann z. B. das HTML-<p>-Tag verwendet werden, um Textabsätze zu erzeugen. Der <q>-Tag sollte für wörtliche Rede benutzt werden. Anderes XHTML sollte aber sparsam verwendet werden, um das CSS-Design von Antamar berücksichtigen.

String Interpolation

In allen Text-Inhalten kann sogenannte String-Interpolation verwendet werden, also Platzhalter (${...}) durch Variablen ersetzt werden:

String-Interpolation: 

<store name="titel">Baron von Tannenbrück</store>
<p>Dir wurde der Titel ${titel} verliehen.</p>

Dabei ist <store ...> ein AOQML-Tag, in diesem Fall zum Speichern des Textes "Baron von Tannenbrück" in einer Variable mit dem Namen "titel", die dann durch String-Interpolation (${titel}) wieder abgerufen wird. Zu AOQML-Tags mehr im folgenden Abschnitt.

AOQML-Tags

Bisher können folgende Tags benutzt werden (alphabetische Liste):

  • action - Aktionen die den Helden betreffen, z.B. Annahme einer Arbeit / Einsperren im Kerker
  • add-EP - geb. EP für Fertigkeiten vergeben
  • case - für Fallunterscheidungen → switch und Zufallsauswahlen → random
  • challenge - für Proben auf Talente und Eigenschaften
  • chat - für das Einbinden eines Chatfensters.
  • choice - gibt dem Spieler verschiedene Auswahlmöglichkeiten vor
  • countdown - zeigt an, wie lange eine Variable noch besteht
  • defeat - Kampfergebnis: Held besiegt → fight
  • delay - Reise des Helden verzögern
  • desc - Liefert eine Beschreibung
  • damage - verursacht Schadenspunkte beim Held (auf Wunsch mit/ohne Wunden)
  • debug - Inhalte zum Testen auf dem Testserver bereitstellen
  • div - erzeugt eine OOC-Box
  • drop - Gegenstand aus Ausrüstungsliste entfernen
  • eval - Tag zum berechnen einfacher und komplexer mathematischer Funktionen
  • else - Fallunterscheidungen: Default-Option → switch
  • escape - Kampfergebnis: Held flüchtet → fight
  • failure - Prüfergebnis / Probe negativ → challenge, has
  • for - Erstellen von Schleifen
  • fetch - gespeicherten Wert abrufen → store
  • fight - Kampf
  • function - spezielle Funktionen
  • generateName - Zufallsnamen generieren
  • get - Attribute des Helden oder eines Gegenstandes oder eines Gebäudes abfragen
  • has - auf vorhandene Ausrüstung und Talente prüfen
  • hero - Held aus Gruppe heraussuchen
  • if - für bedingte Text- oder Wertauswahl
  • img- um Bilder einzubinden
  • include - andere Questdateien einbinden
  • input - ein Eingabefeld anzeigen
  • inventar- Tag der verschiedene Gegenstände in sich speichert um z.B. Truhen oder ähnliches zu simulieren.
  • item wählt ein zufälligen Gegenstand aus der DB
  • item-select - einen Gegenstand vom Spieler auswählen lassen
  • map - fügt eine Grafik ein, auf der Questlinks platziert werden (z.B. für grafische Dungeons)
  • maze - fügt eine Karte der gesehenen+erinnerten "Räume" aus Kachel-Grafiken ein (für grafische Dungeons)
  • paths - geografische Richtungsnavigation
  • q - wörtliche Rede
  • quest - zur Steuerung der Queste, z. B. um eine Quest als (noch nicht) abgeschlossen zu markieren
  • random - Zufallsauswahl
  • ranged-defence - NPCs attackieren den Held mit Fernkampfwaffen
  • regeneration - Stoppt die Regeneration für den Held in der Quest.
  • restrict - Stellt sicher das bestimmte AOQML-Teile nur einmal pro Held ausgeführt werden.
  • replay - gespeicherte Aktionsfolge abrufen → retain
  • retain - Aktionsfolge speichern → replay
  • reverse - Held muss an den zuletzt besuchten Ort zurückkehren
  • rivals - im Kampf Gegner festlegen
  • scene - oberstes Tag, definiert Beginn und Ende der XML-Datei
  • select - Wahl des handelnden/betroffenen Helden in der Gruppe
  • set - Werte des Helden verändern
  • steal - Begleiter entfernen (= gemeiner Viehraub!)
  • store - Wert speichern um später darauf zugreifen zu können → fetch
  • success - Prüfergebnis / Probe positiv → challenge, has
  • switch - Fallunterscheidung
  • take - Gegenstand in die Ausrüstungsliste legen
  • transfer - Austausch von Gegenständen zwischem Held und einem Behälter
  • travel - startet eine Reise
  • var-dump - gibt gesetzte Variablen aus -> hilft beim Debuggen
  • victory - Kampfergebnis: Gegner durch Held besiegt

Sonstiges

Besondere Werte (Würfelergebnisse berechnen, Zufall und Wahrscheinlichkeit, ..)

Zufälligen Gegenstand aus der Datenbank auswählen
s. item-Tag

Zählen

Beispiel eines AOQML-Zahlencounter zum zählen von irgendwas.

Zufallsauswahl aus mehreren Möglichkeiten

Will man z.B. einen von mehreren Gegenständen einer Liste abfragen, dann kann man einen random-Block vorschalten: 

<random>
 <case><store name="Gegenstand">Holzkamm</store></case>
 <case><store name="Gegenstand">Dolch</store></case>
 <case><store name="Gegenstand">Amboss</store></case>
</random>
<take item="${Gegenstand}"/>

Alternativ kann das take auch direkt in den jeweiligen case reingeschrieben werden.

ODER und UND

Will man prüfen, ob der Held einen von mehreren möglichen Gegenständen bei sich trägt, kann man das mit dem Operator "|" (entspricht einem ODER) erreichen: 

<has item="Messer|Dolch|Schwert">
 <success>
  Entweder Messer oder Dolch oder Schwert vorhanden.
 </success>
 <failure>
  Weder Messer noch Dolch noch Schwert vorhanden.
 </failure>
</has>

Man kann auch auf überprüfen, ob mehrere Gegenstände vorhanden sind: 

<has item="Messer+Dolch">
 <success>
  Messer und Dolch vorhanden.
 </success>
 <failure>
  Entweder nur Messer oder nur Dolch oder keins von beiden vorhanden.
 </failure>
</has>

Das "+" entspricht also einem UND.
Das "|" entspricht einem ODER.

Diese zwei Operatoren sind jedoch nur bei <has> und <switch> verfügbar.

nützliche Listen

Abgerufen von „https://wiki.antamar.eu/index.php?title=AOQML-Manual&oldid=111145“