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. Dieser befindet sich momentan im Betatest und kann über die Homepage von Lowlander sowohl als Offline, als auch als Java-Webstart-Version bezogen werden. Mit der Java-Webstart-Version geht ihr auf Nummer sicher, immer die aktuellste Version zu verwenden.

FAQ

Diese Sammlung von Fragen und Antworten soll auch von der Community gepflegt werden. Alle beantworteten und von Lowlander oder Enno abgesegneten Einträge werden in kommenden Versionen des Java-basierten Editors, nach Nutzen/Kosten-Verhältnis abgewägt, berücksichtigt.

Den Anfang machen die von DarkSideOfIsle gestellten Fragen:

Grundlegende Fragen

Was ist der Editor und was kann er alles?

Er dient der Erstellung und Bearbeitung von Rollenspielquesten, diese werden 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 zum Editor?

Diese FAQ sollte schon genügen, falls mehr Fragen da sind, oder die Fragen hier unbeantwortet sind, dann schau einfach ins Forum. Bei gaaaanz dringenden Sachen einfach eine Nachricht an Enno schicken.

Wo finde ich eine Anleitung für AOQML?

Hier im Wiki. Es gibt ein Manual mit der Erklärung aller Tags schau dir einfach die Seite AOQML an.

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

Die Java-Web-Start Version installiert sich im Java-Webstart Laufzeit-Cache, dies sorgt dafür, dass die gecachte Version benutzt wird, falls noch keine neuere zur Verfügung steht. Sobald die Version auf dem Server aktualisiert wird, lädt Webstart die neueste Version von Server. Dies geschieht vollautomatisch, sodass der Benutzer bis auf eine längere Ladezeit im letzteren Fall nichts davon mitbekommt und jedes anklicken des Web-Start-Links zu einem Starten der Anwendung führt. Falls die Offline - Version benutzt wird, ist ebenfalls keine Installation nötig. Das jar-Archiv kann mittels java -jar ausgeführt werden. Wenn die Java-Laufzeitumgebung korrekt installiert wurde kann das jar-Archiv auf den meisten System sogar per Doppelklick ausgeführt werden.

Kann ich damit auch ZBs schreiben?

Im Moment sind alle ZBs in PHP codiert. Vorerst unterstützt Antamar nur Questen in AOQML.

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

Dies ist für eine der nächsten Versionen geplant.

Speichert der Editor automatisch die Szenen?

Nein.

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 damit Grafiken einbinden?

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

Wer implementiert meine Quest?

Alle Questen werden erst nach sorgfältiger Prüfung in Antamar aktiviert. Manchmal übernimmt Athuran diese Rolle, aber falls er es zeitlich nicht schafft, können auch andere Mitglieder das A-Teams oder der Programmierer angesprochen werden.

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?

Dies deutet auf einen Fehler hin, ein roter Rand heißt, dass ein "totes Ende" festgestellt wurde. 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 ausserhalb 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?

TODO

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?

TODO

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

TODO

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.