Der <item-select>-Tag ermöglicht in AOQML die Auflistung von Gegenständen. Der Spieler kann einen der angezeigten Gegenstand anklicken und somit auswählen. Der ausgewählte Gegenstand kann danach durch Attribute wie get ausgelesen und durch set verändert werden.
Inhaltsverzeichnis
Syntax
<item-select item="" ODER instance-id="" target="" [show=""] [continue=""] />
| Attribut | Erforderlich? | Datentyp | Erklärung |
|---|---|---|---|
| item | item oder instance-id | String | Der Warenname, z.B. 'Heiltrank', oder die WareID, z.B. '#921'. Es ist auch möglich, mehrere Items anzugeben, z.B. 'Schwert|Dolch|Messer' oder '*Alkohol' um Waren-Tags auszuwerten. |
| instance-id | item oder instance-id | Integer | Die interne Waren-Instanz-ID siehe: get, wird instance-id genutzt wird automatisch die in target angegebene Szene aufgerufen. ACHTUNG: Das wirkt wie ein include, folglich ist ein altes selektiertes Item noch ausgewählt. Das ändert sich erst in der Folge-Szene. |
| target | ja | String | Gibt die nächste Szene an. In dieser Szene ist dann automatisch der vom Spieler gewählte Gegenstand selektiert. |
| show | optional | String | Wenn nichts angegeben, werden nur die Warennamen als Link angezeigt. Wenn show="quality" angegeben, wird dahinter auch noch die Qualität des Gegenstandes vermerkt (siehe Beispiel unten). |
| continue | optional | Bool | Wenn 'true' und wenn der Spieler nur 1 Item der angegebenen Ware hat, dann wird direkt die unter target angegebene Szene ausgeführt. |
Beispiele
Select mit "item"
Der Spieler soll einen Heiltrank auswählen. In szene2.xml ist dann intern ein Heiltrank markiert als Object selected-item.
<p>Bitte wähle einen Heiltrank aus.</p>
<item-select item="Heiltrank" target="szene2" show="quality"/>
Sollte der Held keine Ware besitzen, die der Angabe unter item entspricht, werden konsequenterweise auch keine Links ausgegeben. Man sollte also zusätzlich immer noch ein anderes choice bereitstellen.
show="quality" bewirkt, dass nicht nur für jeden Heiltrank ein Link erzeugt wird, sondern hinter jedem Link auch noch der Zustand (Qualität) des Heiltrankes angegeben ist. Hat der Held in diesem Beispiel also mehrere Heiltränke im Gepäck, könnte die Ausgabe wie folgt sein:
In szene2.xml ist dann automatisch intern einer der Heiltränke markiert, sodass Änderungen auf dieser Wareninstanz vorgenommen werden können. Beispielsweise könnte man den Heiltrank trinken lassen und abhängig von der Qualität (Wert zwischen 0 und 100) einen Text ausgeben:
<!-- szene2.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<scene xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://eisentrutz.antamar.eu/aoqml.xsd">
<store name="heiltrank-quality" scope="quest"><get object="selected-item" attribute="quality"/></store>
<switch name="heiltrank-quality">
<case val="0">
<p>Pfui bäh!!!!</p>
<drop object="selected-item" />
</case>
<case min="1" max="20">
<p>Naja.</p>
<drop object="selected-item" />
</case>
<case min="21" max="50">
<p>Mittelgut.</p>
<drop object="selected-item" />
</case>
<case min="51" max="80">
<p>Lecker.</p>
<drop object="selected-item" />
</case>
<case min="81" max="100">
<p>WOW Super!!!.</p>
<drop object="selected-item" />
</case>
<else>
<p>Ein Fehler ist aufgetreten. Die Ware liegt außerhalb der Qualitätsskala.</p>
</else>
</switch>
<quest status="ended"/>
</scene>
Select mit "instance-id"
In einer vorhergehenden Szene wurde ein Gegenstand mittels "item" ausgewählt und die Instanz-ID wird gespeichert:
<store name="instanzID"><get object="selected-item" attribute="instance_id"/></store>
Später wurde ein anderes item ausgewählt und man möchte zurück zum gespeicherten Objekt:
<item-select instance-id="${instanzID}" target="include-szene" />
Die Szene bindet das target automatisch per include ein. Dies bedeutet das auswählen des alten Objekts ist erst in der darauf folgenden Szene abgeschlossen. Also muss man einen Link zum klicken einfügen, DANN ist das Objekt wieder ausgewählt.