3.459
Bearbeitungen
Änderungen
keine Bearbeitungszusammenfassung
===Storestore===
Das '''<store>'''-Tag speichert seinen (ausgewerteten) Inhalt persistent, z.B. zwischen verschiedenen Schritten eines Quests.
Das Attribut 'name' gibt dabei an, unter welchem Namen es gespeichert werden soll. Der Inhalt selbst wird an dieser Stelle nicht ausgegeben.
Der folgende Code speichert '''Inhalt der Variable''' unter dem Namen 'VariablenName' für die Dauer des laufenden Quests:
<code syntaxhighlight lang="xml n">
<store name="VariablenName" scope="quest">Inhalt der Variable</store>
</codesyntaxhighlight>
===Scopes/Geltungsbereiche===
Den Bereich und die Art wie eine Variable gespeichert wird kann man über das Attribut '''scope''' festlegen.
<syntaxhighlight lang====quest====Die Variable wird innerhalb dieser Quest gespeichert.Sobald die Quest beendet wurde wird die Variable gelöscht.Durch eine über den [[quest|Queststatus]] pending unterbrochene Quest werden Variablen mit dem Scope quest '''nicht''' gelöscht.<code "xml n"><store name="VariablenName" scope="questhero">Inhalt der Variable</store></codesyntaxhighlight>
===expire=dungeon====Die Variable ist für alle Helden die diese Quest erleben zugreifbar.Die Variable bleibt erhalten auch wenn ein Held die Quest schon beendet hat, bezieht sich aber im Gegensatz zum Scope 'hero' auf die Quest und nicht auf den sie absolvierenden Helden.
<syntaxhighlight lang="xml"><store name="VariablenName" scope=="hero" expire===="4d">Inhalt der Variable</store>Die Variable wird an den Helden gebunden, solange dieser existiert, kann auf sie zugegriffen werden.</syntaxhighlight>
...<code xml!-- Variable um weitere 2 Tage verlängern --><store name="VariablenNamemeineVariable" scope="globalhero" inc-expire="4d2d">neuer Inhalt der Variable</store><!-- die Variable ist somit insgesamt 6 Ingame-Tage aktiv --></codesyntaxhighlight>
Zu beachten ist, dass in [[Quest|Questen]] standardmäßig der scope "quest" eingestellt ist. Wird für eine Variable ein anderer Scope, z.B. 'hero', festgelegt und wird diese Variable später an einer anderen Stelle im Code verändert, dann muss der zugehörige Scope wieder explizit angegeben werden:
<syntaxhighlight lang="xml">
<store name="held-ist-ein-schwarzer-ritter" scope="hero">nein</store>
...
<store name="held-ist-ein-schwarzer-ritter" scope="hero">ja</store><!-- Scope 'hero' muss hier wieder angegeben werden, sonst wird Variable nicht überschrieben, sondern eine neue Variable mit dem Scope "quest" gesetzt! -->
</syntaxhighlight>
===Variablen Löschenlöschen===
Variablen können mittels
<code syntaxhighlight lang="xml">
<store name="meineVar">NULL</store>
<!-- oder-->
<store name="meineVar"/>
</codesyntaxhighlight>
gelöscht werden.
Die Variablen können zwar technisch frei benannt werden, aber bei scope="hero"-Variablen ist zwingend auf einen aussagekräftigen und eindeutigen Namen zu achten. Dazu wird zunächst der Questname (+ggf. Autor) und danach die Variablenkennung angegeben, z.B.
<code syntaxhighlight lang="xml n">
<store name="SchiffBlutrabe-Tagesablauf" scope="hero">Schlaf</store>
</codesyntaxhighlight>
Diese Konvention soll sicherstellen das , dass einzelne hero-/global-Variablen sich nicht gegenseitig überschreiben.
===fetch===
Folgendes bewirkt zum Beispiel die Ausgabe der Variable "papagei_name".
<code syntaxhighlight lang="xml">
<p><q>Hallo <fetch name="papagei_name"/>!</q></p>
</codesyntaxhighlight>
===Inhalte ändern===
Grundsätzlich kann eine Variable jederzeit überschrieben werden und beinhaltet damit den neuen Wert. Sollte gewünscht sein, einen Zahlenwert zu erhöhen oder zu erniedrigen, siehe [[set]].
[[Kategorie:AOQML-Tags]]