CodeSnippets
Hier entsteht eine Sammlung von Versatzstücken für die AOQML-Programmierung, sogenannten CodeSnippets. Es soll die möglichst eleganteste, sicherste und platzsparendste Methode hier stehen.
Inhaltsverzeichnis
ZB-Aufbau
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) -->
<scene xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://spiel.antamar.org/Antamar/xml/aoqml/aoqml.xsd">
<p></p>
<challenge talent="X">
<failure>
<p></p>
</failure>
<success>
<p></p>
<challenge talent="X">
<failure>
<p></p>
<set attribute="EP" inc="X"/>
</failure>
<success>
<p></p>
<set attribute="EP" inc="X"/>
<take item="X"/>
</success>
</challenge>
</success>
</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) -->
<scene xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://spiel.antamar.org/Antamar/xml/aoqml/aoqml.xsd">
<p>
<random>
<case></case>
<case></case>
<case></case>
<case></case>
</random>
</p>
<challenge talent="" mod="+X">
<failure>
<p>
<random>
<case></case>
<case></case>
<case></case>
<case></case>
</random>
</p>
</failure>
<success>
<p>
<random>
<case></case>
<case></case>
<case></case>
<case></case>
</random>
</p>
</success>
</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>
<p></p>
<take item="X"/>
</success>
<failure>
<challenge talent="" mod="+X">
<success>
<p></p>
<set attribute="EP" inc="X"/>
</success>
<failure>
<p></p>
<set attribute="EP" inc="X"/>
</failure>
</challenge>
</failure>
</has>
Talente
Einfache Talentprobe
<challenge talent="Talent" mod="+X">
<success>
<p></p>
</success>
<failure>
<p></p>
</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>
<challenge talent="">
<failure>
<p></p>
</failure>
<success>
<p></p>
</success>
</challenge>
</success>
<failure>
<challenge talent="" mod="+X">
<failure>
<p></p>
</failure>
<success>
<p></p>
</success>
</challenge>
</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>
<challenge talent="Talent1">
<success>
...
</success>
<failure>
...
</failure>
</success>
<failure>
<challenge talent="Talent2">
<success>
...
</success>
<failure>
...
</failure>
</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. -->
<has item="XXX"><!-- Man kann auch anderes mit has oder switch abfragen. -->
<success>
<set name="probenvariable_1" dec="2" show="none"/><!-- Malus wird um 2 erleichtert. -->
</success>
<failure>
<!-- Fehlt der Gegenstand, wird nicht modifiziert. -->
</failure>
</has>
<has item="YYY"><!-- Man kann auch anderes mit has oder switch abfragen. -->
<success>
<set name="probenvariable_1" dec="2" show="none"/><!-- Malus wird um 2 erleichtert. -->
</success>
<failure>
<!-- Fehlt der Gegenstand, wird nicht modifiziert. -->
</failure>
</has>
<challenge talent="AOQML-Programmierung" mod="${probenvariable_1}"><!-- Als Modi wird der Inhalt der Variable gezogen, also 5 ohne Ausrüstung und weniger (also leichter) wenn geeignete Ausrüstung vorhanden. -->
<success>
<!-- Hier dann Ergebnis Erfolg. -->
</success>
<failure>
<!-- Hier Misserfolg. -->
</failure>
</challenge>
Heldenspezifisches
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">
<p></p>
</case>
<else>
<p></p>
</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>
<p></p>
</success>
<failure>
<p></p>
</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 ...
<switch Attribute="LEP">
<case min="${LEPvorher}">
#Fall: vorher so viele LEP wie nachher oder mehr
</case>
<else>
#Fall: nachher weniger LEP als vorher
</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
<include target="/lib/_hatSchreibzeug"/>
<switch name="hatSchreibzeug">
<case val="true">
Schreibzeug dabei und könnte also etwas aufschreiben.
</case>
<else>
leider kein Schreibzeug dabei und könnte daher nichts aufschreiben.
</else>
</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.
Zufälle
Zufallstexte
Eine normale Zufallsauswahl, jeder Case ist gleichberechtigt.
<random>
<case>
<p></p>
</case>
<case>
<p></p>
</case>
<case>
<p></p>
</case>
<case>
<p></p>
</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:
<set name="zufall" value="1...100"/>
oder so:
<set name="zufall" value="$[W100]"/>
Dann die möglichen Ergebnisse:
<switch name="zufall">
<case min="1" max="49">
...für 0-49...
</case>
<case min="50" max="69">
...für 50-69...
</case>
<else>
...für den Rest...
</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">
<failure>
<has item="Mittlere Ausrüstung|Andere mittlere Ausrüstung">
<failure>
<has item="Schlechte Ausrüstung|Andere schlechte Ausrüstung">
<failure>
<p>Mangels geeigneter Ausrüstung kannst du das gleich vergessen!</p>
Weiter im Text/Versagt/Was auch immer...
</failure>
<success>
<challenge talent="Benutztes Talent" mod="+Hoher Malus in Zahlen" name="probemitausruestung1" show="none" />
</success>
</has>
</failure>
<success>
<challenge talent="Benutztes Talent" mod="+Mittlerer oder kein Malus in Zahlen" name="probemitausruestung1" show="none" />
</success>
</has>
</failure>
<success>
<challenge talent="Benutztes Talent" mod="+Kleiner Malus bis Bonus in Zahlen" name="probemitausruestung1" show="none" />
</success>
</has>
...
<challenge name="probemitausruestung1">
<failure>
...
...
</failure>
<success>
...
...
</success>
</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>
<!--Text beim ersten Durchlauf!-->
<store name="ValName">ja</store>
</null>
<case><!--Text beim erfüllter Bedingung!-->
</case>
<else>
<!--Alternativer Text!-->
</else>
</switch>
ValNamestellt den Variablennamen dar, dieser kann frei vergeben werden. <null>ist der Zweig, der im ersten Ablauf abgearbeitet wird, dort ist noch kein Variablenname vergeben. Erst am Ende des Zweiges wird mittels <store name="ValName">ja</store> ein Wert zugewiesen, in diesem Fall 'ja'. <case> ist der Zweig der Durchlaufen wird, wenn die Bedingung (ja) erfüllt ist. <else> wird Durchlaufen, wenn ein Wert in der Variable gespeichert ist, der aber nicht direkt einer Vorgabe entspricht.
Alternativ kann man auch das has-Tag verwenden.
In dem Beispiel wird durch das Beispiel das Betreten einer Lokalität verhindert. In diesem Beispiel gibt es nur zwei Möglichkeiten, der <case>-Fall wird somit unnötig.
<switch name="besuchtTaverne">
<null>
Hier die einmalige Möglichkeit in der Schmiede fragen zu stellen.
<store name="besuchtTaverne">ja</store>
</null>
<else>
<p>Der Schmied guck dich nur dumm an, was du schon wieder hier willst.</p>
</else>
</switch>
Gruppenzeug
Alle Helden durchgehen
<for all="${sys:heroes}" name="heldid">
<select hero="${heldid}"/>
<p>Name: <get attribute="name"/></p>
</for>
Sonstiges
Helden zeitweilig einsperren
Wer nicht gleich einkerkern möchte, kann für (kurzzeitiges) Einsperren in einer Queste folgende Möglichkeit nutzen. Bitte nicht länger als einige Stunden RL, sonst gibt es Gemecker. Mögliche Anwendungen: Schlaf, Bewusstlosigkeit, Reisen (danach dann site verändern), Arbeit...
Datei 1:
<q>Text informiert SC darüber, dass er einige Zeit in der Queste verbleiben muss.</q>
<store name="held_wird_eingesperrt" scope="quest" expire="2h">...</store>
<countdown variable="held_wird_eingesperrt"/><!-- Anzeige, damit der Spieler weiß, wie lange noch. -->
<ul>
<li><choice target="raus">Darf ich gehen?</choice></li>
</ul>
Datei 2 (raus.xml):
<has name="held_wird_eingesperrt">
<success><!-- Variable existiert noch, Held bleibt eingesperrt. -->
<q>NEIN!</q>
<countdown variable="held_wird_eingesperrt"/>
<ul>
<li><choice target="raus">Darf ich gehen?</choice></li>
</ul>
</success>
<failure>
<q>Text Held darf gehen/wacht auf.</q>
<quest status="ended"/><!-- Oder weiter in der Queste, je nachdem. -->
Jahreszeiten
Für Jahreszeitabhängige Texte... Wichtig: Die Jahreszeiten gelten so nur auf der Nordhalbkugel!
<switch attribute="monat">
<case val="Herdfeuermond|Maskenmond|Lichtmond">
</case>
<case val="Ehrenmond|Hoffnungsmond|Wassermond">
</case>
<case val="Liebesmond|Weisheitsmond|Erdmond">
</case>
<else>
</else>
</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">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Nuovo Imperio Aurecciani">
<store name="sprache" scope="quest">Aurento</store>
</case>
<case val="Großsultanat Emreia">
<store name="sprache" scope="quest">Bajidai</store>
</case>
<case val="Kaiserreich des Südsterns">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Godentum Nordahejmr">
<store name="sprache" scope="quest">Nordahejmisch</store>
<has talent="Nordahejmisch" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Orkreich">
<store name="sprache" scope="quest">Orkisch</store>
<has talent="Orkisch" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Zollunion Goblinia">
<store name="sprache" scope="quest">Goblinisch</store>
<has talent="Goblinisch" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Adelsrepublik Grauland">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Aivarunenlande">
<store name="sprache" scope="quest">Avarun</store>
<has talent="Avarun" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Xetoka">
<store name="sprache" scope="quest">Xeanhatl</store>
<has talent="Xeanhatl" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Eiskönigreich">
<store name="sprache" scope="quest">Urelfisch</store>
<has talent="Urelfisch" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Emirat El-Ahil">
<store name="sprache" scope="quest">Bajidai</store>
</case>
<case val="Emirat Karkasso">
<store name="sprache" scope="quest">Bajidai</store>
</case>
<case val="Emirat Seydjuk">
<store name="sprache" scope="quest">Bajidai</store>
</case>
<case val="Fürstentum Herzstein">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Fürstentum Thelessa">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Fürstentum Exondria">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Großfürstentum des Südmeers">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Herzogtum Galfar">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Kalifat Dorien">
<store name="sprache" scope="quest">Bajidai</store>
</case>
<case val="Königreich Lothrinien">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Königreich Lúnasadh">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Königreich Westendar">
<store name="sprache" scope="quest">Aurento</store>
</case>
<case val="Echsenreich">
<store name="sprache" scope="quest">ZheeZ</store>
<has talent="ZheeZ" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Sartogasso">
<store name="sprache" scope="quest">Imperial</store>
</case>
<case val="Sawajidden-Kalifat">
<store name="sprache" scope="quest">Bajidai</store>
</case>
<case val="Shogunate">
<store name="sprache" scope="quest">Oda</store>
<has talent="Oda" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Elfen">
<store name="sprache" scope="quest">Elfisch</store>
<has talent="Elfisch" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Zwerge">
<store name="sprache" scope="quest">Zwergisch</store>
<has talent="Zwergisch" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</case>
<case val="Magokratie Wiesczarna">
<store name="sprache" scope="quest">Imperial</store>
</case>
</switch>
<has name="sprache" val="Imperial" show="none">
<success>
<has talent="Imperial" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</success>
</has>
<has name="sprache" val="Aurento" show="none">
<success>
<has talent="Aurento" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</success>
</has>
<has name="sprache" val="Bajidai" show="none">
<success>
<has talent="Bajidai" min="6" show="none">
<success>
<store name="kannsprache" scope="quest">ja</store>
</success>
</has>
</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">
<has attribute="kampf" val="aktiv" show="none" >
<success>
</success>
<failure>
</failure>
</has>
</case>
<else>
<has attribute="kampf" val="aktiv" show="none" >
<success>
</success>
<failure>
</failure>
</has>
</else>
</switch>
Und hier noch einmal ohne inhaltliche Richtlinien:
<switch attribute="vorgehen" >
<case val="offen">
<has attribute="kampf" val="aktiv" show="none" >
<success>
</success>
<failure>
</failure>
</has>
</case>
<else>
<has attribute="kampf" val="aktiv" show="none" >
<success>
</success>
<failure>
</failure>
</has>
</else>
</switch>
