AOQML für Anfänger
WICHTIG: Momentan ist diese Seite noch nicht fertig! Bitte erst dann als Vorlage nutzen, wenn sie freigegeben ist.
Inhaltsverzeichnis
1. Den Editor benutzen
XML ist nicht so leicht lesbar, wie die Programmierer immer behaupten. Der AOQML-Editor erleichtert das Programmieren gerade für Einsteiger erheblich, da er einen geeigneten Rahmen bietet und zumindest einen Teil der üblichen Fehler im Vorfeld erkennen kann. Ladet ihn einfach herunter (http://aoqml.isonweb.de/) und speichert ihn in einem Ordner für eure eigenen Questen. Damit die nachfolgenden Schritte funktionieren braucht ihr Java in einer einigermaßen aktuellen Version. Diese könnt ihr hier herunterladen.
Ein Doppelklick öffnet ihn.
Das Feld "Quest" öffnet 3 Möglichkeiten: Man kann eine neue Quest anlegen, eine schon im Ordner vorhandene Quest laden oder durch Beenden den Editor schließen.
Wir müssen natürlich erst einmal eine erste Quest anlegen.
Gespeichert wird sie im entsprechenden Ordner, in dem auch der Editor ist. Natürlich benötigt sie einen Namen. Er sollte einfach und eindeutig sein und einen Hinweis auf den Inhalt bieten. Wir nennen die erste Quest fantasievoll testquest 01.
Die Queste wird jetzt als eigener Unterordner für die einzelnen Dateien in dem Questordner angelegt. Außerdem erscheint im Editor jetzt die grafische Übersicht über die einzelnen Dateien. Da wir noch keine Datei geschrieben haben ist auch noch keine zu sehen - außer der Datei start, die immer vorhanden sein muss und daher automatisch erstellt wird. Da sie noch nicht auf der Festplatte existiert, wird sie rot dargestellt.
Ein Doppelklick öffnet die Datei start.
Wenn man auf einem Netbook mit "kompaktem" Monitor arbeitet, so wie ich, kann es vom Platz her etwas eng werden... In dem Fall sollte man als erstes einige Leerzeilen unter </szene> setzen. Große Monitore sind deutlich von Vorteil. Man kann das Fenster verschieben und in der Größe verändern.
2. Die erste Szene schreiben
Nachdem die Szene "start" geöffnet ist, beginnen wir mit einer einfachen Queste.
Die Zeile <quest status="running"/> am Anfang steht nur in der Szene start, in den anderen ist sie nicht nötig. Die Zeile </scene> steht am Ende der Dateien (=Szenen), um diese zu schließen. Der restliche Code wird zwischen diese beiden Zeilen geschrieben.
Wir beginnen die Queste mit einem kleinen Einführungstext. Dazu schreiben wir zwischen die beiden Zeilen < p>. Der Editor erweitert dies sofort zu < p>< /p>. Hinweis: Das Leerzeichen zwischen < und p dient nur dazu, das Wiki zu überlisten - das würde sonst die Befehle interpretieren... Gilt auch im folgenden.
< p> öffnet die Textausgabe, < /p> schließt sie wieder. Den Text kann man direkt dazwischen schreiben. Er wird dann in der Quest als normaler Text ausgegeben. Wörtliche Rede von Charakteren wird zwischen < q></ q> geschrieben und dann automatisch kursiv und mit Anführungszeichen ausgegeben. Wir nehmen folgenden Text:
Gerade als du beim Wirt etwas zu Essen bestellen willst, fällt dein Blick auf einen Zettel an der Wand der Kneipe. Anders als die anderen Aushänge und Notizen, die schon von Kerzenruß und Staub vergilbt sind, scheint er ziemlich neu zu sein.
Wenn wir das so lassen, würde die Queste nur den Text anzeigen und keine weiteren Funktionen bieten. Der SC würde festhängen. Aber natürlich lassen wir sie nicht so! Stattdessen geben wir dem Spieler zwei Optionen vor, wie er weiter verfahren kann.
Dafür tippen wir erst einmal hinter dem < /p> Enter, um eine Zeile nach unten zu kommen, und geben dann < ul> ein, was sich wie gewohnt zu < ul>< /ul> verändert. Dieses < ul> sorgt dafür, das die geplanten Links in der Queste schön untereinander gezeigt werden, nicht hintereinander.
Um Platz zu haben setzen wir den Cursor zwischen die beiden Befehle und drücken drei mal Enter, dann die Taste <--. Jetzt haben wir zwischen den ul zwei freie Zeilen. Der Editor rückt automatisch alles ein, was wir dazwischen eingeben. Das vereinfacht die Übersicht erheblich, wenn wir größere Szenen schreiben.
In die beiden leeren Zeilen geben wir < li> ein. Das sorgt dafür, das die Optionslinks mit einem Aufzählungspunkt beginnen, was hübscher aussieht.
Wenn der | zwischen den Befehlen sitzt (so: < li>|< /li> ) klicken wir links auf die Taste <choice.../>. Dadurch wird automatisch der Befehl <choice target="">...</choice> eingefügt. Dieser Befehl erzeugt in der Queste dann den eigentlichen Link. Er muss zwischen beiden li eingefügt werden!
So leer würde der Link aber nur ... anzeigen - und, wenn man ihn anklickt, ins leere führen! Also müssen wir beide Befehle füllen. Zunächst einmal mit den Texten, die als anklickbarer Link angezeigt werden. Wir nehmen die beiden Texte "Desinteressiert wendest du dich deinem Essen zu." und "Das siehst du dir aus der Nähe an.". Sie ersetzen die ... .
Jetzt würde die Queste zwar die Texte als Links anzeigen, die würden aber immer noch ins leere führen. Also muss noch jeweils eine Zieldatei angegeben werden, und zwar zwischen die "". Da es noch keine Dateien außer start gibt, können wir uns die Namen frei aussuchen. Wir nehmen für die obere Option abbruch und für die untere zettel. Hinweis: Bitte klein schreiben, ä, ö, ü und ß vermeiden und _ statt Leerzeichen benutzen, sonst kann es Probleme geben!
Damit wäre die Datei "start" soweit fertig. Also klicken wir oben auf speichern. Dann schließen wir die Datei mit dem kleinen grauen x oben rechts (das große rote schließt den ganzen Editor). Jetzt sollte etwa folgendes zu sehen sein:
3. Szenen ordnen
Das Fenster kann man vergrößern, den Zoom benutzen und die Dateien hin und her ziehen, bis sie gut liegen. Es sollte übersichtlich sein, etwa so:
Die Funktion Explodieren sollte mit Vorsicht genossen werden, sie ordnen alle Szenen als Kreis an - was die Ordnung nicht unbedingt verbessert. Justieren hingegen ist nützlich, wenn man viele Szenen hat, denn dann wird die Ansicht neu zentriert. Die durchgehenden schwarzen Pfeile bedeuten, dass man von der Szene "start" zu den beiden anderen Szenen springen kann. Da sie noch leer sind, sind sie rot dargestellt. "start" hingegen ist grün, was bedeutet, das der Editor keine Fehler erkannt hat. Der dünne braune Rand bedeutet, dass die Queste in dieser Szene nicht beendet wurde. Achtung, ein roter Rand zeigt an, dass keine Folgeszene angegeben wurde und die Quest nicht explizit mit < quest status=.. beendet wurde. Dies bedeutet ein totes Ende an dem der SC festhängt. Derart gekennzeichnete Szenen dürfen im Livesystem nicht vorkommen!
4. Die Queste abbrechen
Wenden wir uns der Szene "abbruch" zu. Wir öffnen sie per Doppelklick. Der | wird oberhalb von </scene> platziert und dann auf <quest.../> geklickt. Zwischen die "" tippen wir "ended" ein. Damit endet die Queste hier ohne weitere Fisematenten. Man könnte auch noch einen Abschlusstext eingeben, aber das lassen wir erst einmal.
Außerdem müssen wir noch angeben, mit welcher Häufigkeit sich die Quest wiederholt. Dafür fügen wir zwischen " und / noch mit einem Leerzeichen frequency="selten" ein, damit die Quest (Überraschung:) selten auftritt. Man könnte auch "rar" angeben, damit sie noch seltener auftritt, oder "nie", damit sie nur einmal gespielt werden kann. Bei "oft" tritt sie sehr oft auf, ebenso, wenn man auf die Angabe der Häufigkeit verzichtet - was ziemlich nervig sein kann!
Bild 18B (kommt noch...)
Wieder speichern wir. "abbruch" ist jetzt grün und hat einen dicken braunen Rand. Also ist die Szene korrekt geformt und die Queste endet hier. Pfeile zu anderen Szenen gibt es nicht.
Es gibt auch andere Möglichkeiten, eine Quest zu beenden, aber vorerst reicht ended völlig aus.
5. Has-Abfragen
Weiter geht es mit der Szene "zettel". Wir öffnen sie wie gehabt und bauen einen kleinen Text ein.
Aber kann der SC überhaupt lesen? Um das herauszufinden setzen wir eine neue Zeile unter den Text und klicken <has.../> an. Es erscheint wieder ein Befehls-Rohling, in dem allerdings mehr enthalten ist als wir gebrauchen können.
Da wir feststellen wollen, ob der SC das Talent "Imperiale Zeichen" beherrscht, löschen wir die Optionen item (= Gegenstand im Inventar), attribute und quality (= Rasse, Volk etc.) samt den |. Zwischen die "" setzen wir Imperiale Zeichen. Achtung, es ist wichtig, die korrekten Namen der Talente zu benutzen!
Damit wird jetzt festgestellt, ob das Talent überhaupt aktiviert wurde. Wir fügen aber hinter das zweite " noch min="1" ein. Damit wird festgestellt, ob das Talent auch mindestens mit dem Wert 1 oder höher erlernt wurde. Man könnte auch eine höhere Zahl abfragen, wenn es ein besonders komplizierter Text wäre.
Die Queste würde jetzt in orange etwa folgendes anzeigen: hat Imperiale Schrift >1. Da das optisch nicht sehr schön ist, verstecken wir die Anzeige, indem wir noch show="none" anfügen. Damit bleibt die Abfrage für den Spieler unsichtbar. So kann man auch Proben verstecken, wenn der Spieler nicht wissen soll, ob oder was geprobt wird.
Was und wie abgefragt wird steht fest - aber noch nicht, was das Ergebnis ist. Also fügen wir zunächst einmal zwischen <failure></failure> einen entsprechenden Text ein, damit der Spieler erfährt, dass sein SC die Schrift gar nicht beherrscht. Danach fügen wir per Klick auf <include...> in der nächsten Zeile eine direkte Weiterleitung zu "abbruch" ein, indem wir zwischen die "" das Ziel "abbruch" eintippen. Wenn der SC also nicht mindestens "Imperiale Zeichen" auf TaW 1 beherrscht, kann er den Zettel gar nicht lesen und die Queste bricht automatisch ab.
Wenn der SC aber die Fertigkeit beherrscht, steht noch nicht fest, ob er das Gekrakel auch entziffern kann. Dafür benutzen wir eine Probe.
6. Proben
Zwischen das <success></success> setzen wir per Klick auf <challenge...|> einen Rohling für eine Probe.
Da die Probe auf ein Talent gewürfelt wird, entfernen wir quality und setzen wieder Imperiale Zeichen zwischen die "". Außerdem können wir die Probe modifizieren, indem wir bei mod="" +X oder -Y eingeben. Der Zettel ist einfach zu lesen, daher setzen wir +0 ein. Dann folgen wieder zwei Texte für Erfolg und Misserfolg. Ein Misserfolg führt zur Szene abbruch, bei einem Erfolg hingegen gibt es nach dem Text wieder zwei Links als Auswahl.
Als Belohnung für den misslungenen Versuch, den Zettel zu lesen, soll es aber ein Bisschen Erfahrung geben - immerhin zeigt der Misserfolg, dass der SC dringend Übung nötig hat... Dafür setzen wir durch die Taste set <set name|mark|attribute=""/> zwischen die Zeilen und löschen name und mark (wird später erklärt). Zwischen die "" tippen wir EP ein, um die Erfahrung des SC zu verändern. Dahinter kommt ein Leerzeichen und dann inc="1" (inc = erhöhen, dec = senken). Hinweis: Seit neuestem ist auch bei aoqml die Degression wirksam, das heißt, höherstufige SC werden den EP nur mit geringer Wahrscheinlichkeit erhalten.
Bild 27
Nach dem Speichern haben wir 3 korrekte Szenen und eine weitere leere, die gefüllt werden muss. Die gepunkteten Pfeile werden durch das include erzeugt. Das bedeutet, dass die entsprechenden Szenen im Spiel dann direkt untereinander gezeigt werden. Da abbruch leer ist, fällt das aber nicht weiter auf.
Bild 28
7. Variable setzen und Zeit verstreichen lassen
Normalerweise vergeht die Zeit in einer Quest genau so schnell, wie der Spieler sich hindurch klicken kann. Manchmal muss der SC aber innerhalb einer Queste einige Stunden, Tage oder gar Monate mit etwas verbringen, dass ihn von anderen Tätigkeiten abhält - Reisen, Arbeit, Gefangenschaft... Eine Möglichkeit, dieses Verstreichen der Zeit zu simulieren, wird jetzt dargestellt. Zunächst einmal lassen wir den Wirt erklären, dass der Auftraggeber seine Kaninchenzucht einige Wegstunden außerhalb der Stadt betreibt.
Dann speichern wir eine Variable ein, die nach einiger Zeit verschwindet. Dafür klicken wir unter dem Text store und entfernen das mark (veraltet, dürfte bald aus dem Editor fliegen).
Das Expire beschreibt, wann die Variable sich selbst löscht. 5d bedeutet nach 5 Antamartagen oder 20 Minuten Realzeit. Wir ändern es in 3h, also 30 Sekunden Realzeit. Es werden nur h und d als Zeiteinheiten akzeptiert, für längere Zeiten dann also viele Tage. Wenn man auf das expire verzichtet, bleibt die Variable ewig bestehen! Das ist manchmal sinnvoll, wenn man eine permanente Veränderung speichern will, meist ist es aber sinnvoller, die Variablen nach einiger Zeit verschwinden zu lassen.
Der Name der Variable sollte so gewählt sein, dass nicht andere Questschreiber versehentlich den selben Namen benutzen - sonst wird die Variable noch von fremden Questen überschrieben! Auch wenn diese Variable nur 30 Sekunden lang bestehen bleibt, nehmen wir also einen eindeutigen Namen.
Als Inhalt hat die Variable derzeit nur ... , was nicht sehr aussagekräftig ist. Man kann hier fast beliebige Texte einspeichern, sollte aber wiederum auf Umlaute verzichten. Für unsere Quest reicht aber die bloße Existenz der Variable aus.
Zum store muss man immer auch ein scope angeben! Das beschreibt, mit welchem Bezug die Variable gespeichert wird. Wir nehmen scope="quest", die Variable wird also nur für dieses Quest gespeichert und danach direkt gelöscht. Dadurch wird verhindert, dass die SC mit unnötigen Variablen vollgemüllt werden. Alternativ könnte auch scope="hero" genutzt werden, um die Variable am SC zu verankern. Das ist dann sinnvoll, wenn die Variable länger bestehen bleiben soll, als das Quest dauert. Achtung: Der Editor erkennt ein scope im store immer noch als falsch - es ist dennoch richtig und notwendig! Das mag für Anfänger verwirrend sein, wird aber hoffentlich bald geändert. Dann sollte der Editor auch schon ein scope="hero" oder so vorgeben.
Am Ende setzen wir noch ein choice darunter, dass zur nächsten Szene führt.
Bild 29
In der nächsten Szene (weg) lesen wir am Anfang per has aus, ob die Variable noch vorhanden ist. Dafür löschen wir item|talent|attribute|quality und geben mark ein, zwischen die "" den Namen der Variablen (ist wie gesagt eigentlich veraltet, wird aber vom Editor als richtig erkannt und funktioniert auch noch - name funktioniert auch, wird vom Editor aber (noch) als falsch bemängelt...). Wenn die Variable noch da ist, dann geben wir einen hinhaltenden Text aus und einen Link, der wiederum zur Szene weg führt. Egal wie oft der Spieler klickt - so lange die Variable noch besteht, kommt er also nicht weiter! Erst wenn die Variable erloschen ist, geht es für den SC weiter.
Die Namen und Inhalte von Variablen müssen unbedingt fehlerfrei übertragen und immer genau gleich benutzt werden! Viele Fehler in Questen beruhen darauf, dass eine Variable anders gespeichert als abgefragt wird. Am besten, man nutzt copy&paste. Dies ist im Editor nur über Strg+C (kopieren) und Strg+V (einfügen) möglich, nicht per Rechtsklick.
Bild 30
8. Random
Immer nur die selben Texte in einer Queste oder Zufallsbegegnung auszugeben wäre langweilig. Es gibt aber eine einfache Möglichkeit, sie zu variieren. Dafür ersetzen wir den einfachen Text durch eine Zufallsauswahl per Taste Random.
Bild 31
In die <case>...</case> kann man an Stelle der ... jeweils einen Text eingeben, oder auch eine andere Befehlszeile. Man kann auch beliebig viele case untereinander setzen. Uns sollen 3 mehr als genügen. Dafür kopieren wir einfach eine case-Zeile und ersetzen dadurch die ... . Dann fügen wir jeweils einen kleinen Text ein. Die < p>< /p> nicht vergessen!
Bild 32
Die Wahrscheinlichkeit ist für jedes case gleich (auch wenn es im Spiel oft ganz anders erscheint...). Um die Wahrscheinlichkeiten per Random gezielter zu verteilen, kann man einfach häufig vorkommende case-Zeilen kopieren und mehrfach einfügen.
Es gibt auch noch andere Möglichkeiten der Zufallsverteilung, aber dazu später.
9. Die Wahl der Taktik
Eigentlich hat es weniger mit aoqml als vielmehr mit den Grundlagen der Questgestaltung zu tun, aber da die Stelle gerade günstig ist, hier ein wichtiger Hinweis:
Gib dem Spieler wenn möglich immer die Wahl, wie er seinen SC führen will! Es ist einfach und bequem für den Questschreiber, nur einen möglichen Handlungsverlauf einzubauen. Aber für den Spieler ist es eine unschöne Einengung. Natürlich kann kein Questschreiber alle Lösungswege, die einem Spieler einfallen mögen, vorher in seine Questen einbauen. Schon 2 oder 3 Optionen erhöhen den Arbeitsaufwand enorm! Aber es lohnt den Aufwand. Zumindest bei drohenden Kämpfen sollte es immer die Möglichkeit geben, auch einen oder zwei friedliche Wege zu versuchen. Für die Testquest bieten wir dem Spieler 3 Optionen an: Kämpfen, Heimlichkeit oder Verhandeln.
Bild 33