''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 Weitere Informationen zu diesem Editor finden sich momentan im Betatest und kann über die [http://aoqmlforum.isonwebantamar-community.de/ Homepage von Lowlanderviewtopic.php?f=77&t=9662 im Forum] sowohl als Offline, als auch als Java-Webstart-dort vom Ende her bitte die aktuell freigegebene Version bezogen werdenzum Download suchen! Testversionen (nicht unbedingt freigegeben) finden sich in Lowlanders [https://repo. Mit der Javajavagil.de/releases/aoqml-Webstarteditor/ Download-Version geht ihr auf Nummer sicher, immer die aktuellste Version zu verwendenBereich].
== 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? ====
TODOEr 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? ====
==== Was muss ich noch wissen? ====
TODO ==== Wo finde ich Ein bisschen [http://de.wikipedia.org/wiki/Extensible_Markup_Language XML], da [[AOQML]] eine Anleitung zum Editor? ====TODOXML-basierte Sprache ist.
==== Wo finde ich eine Anleitung für AOQML? ====
TODOHier 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. ====
TODOWenn 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? ====
TODOJa, auch das ist möglich. [[Gruppe|Gruppen-Zufallsbegegnungen]] basieren beispielsweise ausschließlich auf [[AOQML]].
==== Kann der Editor zu testzwecken Testzwecken das Abenteuer/die ZB abspielen? ====TODODas 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? ====
TODONein. Zum Speichern muss der Button "Speichern" geklickt werden.
==== Wo speichert er sie? ====
TODOIm Quest-Wurzelverzeichnis. Dies ist das Verzeichnis welches bei der Questerstellung angelegt wurde. Es trägt denselben Namen wie das Quest.
==== Kann ich damit Grafiken in Questen/ZB einbinden? ====TODOJa. Das [[img|<img>]]-Tag wird unterstützt.
==== Wer implementiert meine Quest/ZB? ====TODOAlle 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.
==== Wie erstelle ich eine weitere Szene? ====
TODOMittels <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? ====
TODODurch 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? ====
TODOEin 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“ ====
TODOGrü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. ====TODOManchmal 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? ====
TODOJa. 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? ====
TODOPfeile 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? ====
TODOEs 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? ====
==== Kann der Editor auch logische Abfolgefehler finden? ====
TODONur 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? ====
TODOIm Forum gibt es einen großen Bereich für AOQML - dort wird gerne geholfen!
==== Mein Programm ist abgestürzt, was soll ich machen? ====
TODOErstmal 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? ====
TODOIm 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? ====
TODOWenn 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 [http://en.wikipedia.org/wiki/GPL_3#Version_3 GPL v3].
[[Kategorie:AOQML]]
[[Kategorie:Mitarbeit]]
