AOQML-Editor

Queste schreiben soll fast so viel Spaß machen wie Queste erleben (Lowlander, 13.3.2009 im Spielentwicklungsforum)

Zu diesem Zweck haben Lowlander und Enno einen Quest-Editor in Java implementiert. Weitere Informationen zu diesem Editor finden sich im Forum - dort vom Ende her bitte die aktuell freigegebene Version zum Download suchen! Testversionen (nicht unbedingt freigegeben) finden sich in Lowlanders Download-Bereich.

FAQ

Diese Sammlung von Fragen und Antworten soll auch von der Community gepflegt werden.

Grundlegende Fragen

Was ist der Editor und was kann er alles?

Er dient der Erstellung und Bearbeitung von Rollenspielquesten und Zufallsbegegnungen, welche innerhalb des Browsergames Antamar ausgeführt.

Wie kann ich loslegen? Was muss ich dazu machen?

Über den Menüpunkt "Quest"/"Quest anlegen" eine Quest anlegen und dann auf die Fläche "Start" doppelklicken. Damit wird der Editor für die Startszene geöffnet.

Was muss ich noch wissen?

Ein bisschen XML, da AOQML eine XML-basierte Sprache ist.

Wo finde ich eine Anleitung für AOQML?

Hier im Wiki. Dazu am besten die Seite AOQML besuchen, von dort aus sind Tutorials und Manuals verlinkt.

Installiert sich der Editor irgendwo? Als ich draufklickte, ist er einfach gestartet.

Wenn die Java-Laufzeitumgebung korrekt installiert wurde kann das jar-Archiv auf den meisten System sogar per Doppelklick ausgeführt werden. Ansonsten kann das jar-Archiv mittels java -jar aoqml-...-jar-with-dependencies.jar ausgeführt werden ('...' mit der jeweiligen Versionsnummer ersetzen. Eine weitergehende Installation findet nicht statt.

Da die Unterstützung von Java-Web-Start in neueren Java-Versionen sehr umständlich geworden ist und zudem kostenpflichtige Zertifikate genötigt, wird dieses Verfahren derzeit nicht mehr unterstützt.

Kann ich damit auch ZBs schreiben?

Ja, auch das ist möglich. Gruppen-Zufallsbegegnungen basieren beispielsweise ausschließlich auf AOQML.

Kann der Editor zu Testzwecken das Abenteuer/die ZB abspielen?

Das wäre eine super Funktion und war auch mal geplant, aber die Funktionalität von Antamar und seiner Questengine war so schnell gewachsen, dass wir diese Idee bald nicht weiter verfolgen konnte.

Speichert der Editor automatisch die Szenen?

Nein. Zum Speichern muss der Button "Speichern" geklickt werden.

Wo speichert er sie?

Im Quest-Wurzelverzeichnis. Dies ist das Verzeichnis welches bei der Questerstellung angelegt wurde. Es trägt denselben Namen wie das Quest.

Kann ich Grafiken in Questen/ZB einbinden?

Ja. Das <img>-Tag wird unterstützt.

Wer implementiert meine Quest/ZB?

Alle Questen/ZB werden erst nach sorgfältiger Prüfung in Antamar aktiviert. Erstellte Questen/ZB könnten im Wiki unter Benutzung der zugehörigen Vorlage eingestellt werden. Andere Nutzer schauen sich Syntax & Inhalt nochmals genauer an und geben Feedback. Wenn die Quest/ZB von genug Nutzern kontrolliert wurde, wird sie von einem Programmierer ins Spiel implementiert.

Beim ersten Questen:

Wie erstelle ich eine weitere Szene?

Mittels <choice target="xyz">, <include target="xyz"> oder <quest status="pending" target="xyz"> werden neue Szenen angelegt. Diese erscheinen sobald die Szene mit diesen Tags gespeichert wird. Neue Szenen sind erstmal leer und werden rot dargestellt. Ein Doppelklick öffnet den Editor und ermöglicht deren Bearbeitung. Sobald sie gespeichert werden erscheinen sie nicht mehr rot.

Was bedeutet ein gestrichelter Pfeil zu einer anderen Szene?

Durch include-eingebundene Szenen werden mit gestrichelten Kanten verknüpft, auch die Kanten zu Scenen die aus <quest status="pending" target="xyz"> hervorgehen, sind gestrichelt.

Wieso haben bestimmte Szenen einen doppelten Rand?

Ein brauner Rand bedeuted, eine reguläre Endszene wurde erreicht.

Ein roter Rand heißt, dass ein "totes Ende" festgestellt wurde, dies deutet auf einen Fehler hin, denn der Questautor sollte dafür sorgen, dass jeder Handlungsstrang zu einem <quest status="ended"/> führt. Achtung: auch wenn keine Szene einen roten Rand hat, können "tote Enden" vorhanden sein. Aufgrund der vielen Möglichkeiten (z.B. Fallunterscheidungen mit unterschiedlichen includes) kann dem Programm ein fehlerhafter Handlungsstrang entwischt sein.

Was bedeuten die unterschiedlichen Farben der „Szenen“

Grün: Alles ok, Syntax wurde geprüft und ist korrekt.

Gelb: Es gibt mindestens einen Syntaxfehler.

Rot: Datei ist noch nicht auf der Festplatte vorhanden. Siehe oben->Erstellen einer weiteren Szene

Ich habe zwei neue Szenen erstellt, kann sie aber auf dem Brett nicht finden.

Manchmal geraten Scenen außerhalb des sichtbaren Bereichs, dieser kann durch Zoomen und Verschieben angepasst werden. Weiterhin gibt es das Steuerelement "Justieren" damit können die Scrollbars neu angepasst werden, falls ein Layoutfehler aufgetreten ist.

Kann man die Szenen auf dem Anzeigebrett verschieben?/ Ich blicke nicht mehr auf dem Brett durch, was kann ich tun?

Ja. Und zwar durch einfaches Klicken und Ziehen der Szene, oder mehrerer Szenen wenn sie mit einem Auswahlrahmen markiert wurden. Im Modus "transformieren" kann die komplette Ansicht verschoben werden.

Wieso führen von einer Szene zwei Pfeile zu einer anderen Szene?

Pfeile werden für jedes <include target=..>, <choice target=..> oder <quest status="pending" target..> Tag erzeugt, deshalb sind auch mehrere Pfeile pro Szene möglich.

Bei Fehler beim Questen:

Was bedeutet die gelbe Farbe bei einer Szene?

Es gibt mindestens einen Syntaxfehler. Öffne die Szene durch Doppelklick und lies dir die Fehlermeldung durch. Sie steht ganz unten in roter Schrift. Nach dem Speichern wird die Szene erneut geprüft. Falls weitere Fehler vorhanden sind, wirst du wieder auf diese aufmerksam gemacht.

Der Editor zeigt mir einen Fehler an (Zeile und Spalte) aber ich kann ihn nicht finden. Wo sehe ich die Spalten?

TODO

Kann der Editor auch logische Abfolgefehler finden?

Nur bedingt. Eine rudimentäre Prüfung auf "tote Enden", also Handlungsstränge ohne <quest status="ended"/> ist eingebaut. Dann wird ein roter Rahmen um die betreffende Szene gezeichnet. Allerdings können nicht alle "toten Enden" gefunden werden.

Eine weitergehende Abfolgeprüfung findet nicht statt.

Wer kann mir bei bestimmen Fehlern helfen?

Im Forum gibt es einen großen Bereich für AOQML - dort wird gerne geholfen!

Bei Fehler mit dem Editor:

Mein Programm ist abgestürzt, was soll ich machen?

Erstmal keine Panik. Dann versuche das Programm zu beenden. Wenn es gar nicht reagieren sollte, kannst du Java über den Taskmanager beenden. Dann wäre es nett wenn du die Entwickler über diesen Absturz informieren könntest. Dazu kannst du dich am besten über das Forum mit Lowlander oder Enno in Verbindung setzen. Falls du das vorhast, halte bitte folgende Informationen bereit: das zuletzt bearbeitete Quest, die Programmversion des Editors, deine Betriebsystemversion, deine Javaversion.

Wo kann ich mich wenden, wenn ich Probleme mit dem Programm habe?

Im Forum gibt es einen großen Bereich für AOQML - dort wird gerne geholfen!

Als der Editor abgestürzt ist, sind meine Daten beim Questen abhanden gekommen. Kann man die wiederherstellen?

Wenn du immer gespeichert hast, sind keine Daten verloren gegangen. Sie befinden sich auf der Festplatte im Stammverzeichnis des Quests. Dieses kannst du einfach per Dateibackup sichern. Im Stammverzeichnis befindet sich weiterhin die Datei .aoqml-editor, welche nur die Layoutinformationen bezüglich der Darstellung der Szenen enthält. Falls sie fehlt, wird sie beim nächsten Laden der Quest neu erstellt. Die Positionen der Szenen sind dann zwar zurückgesetzt, allerdings sind keine essentiellen Quest-Daten betroffen.

Fragen zur Lizenz:

Mein Freund spielt auch Antamar und möchte eine Quest schreiben. Darf ich ihm das Programm geben?

Natürlich, du darfst ihm sogar den Quellcode geben! Es steht unter der GPL v3.