Take

Mit Hilfe von <take> können in AOQML Waren/Gegenstände aufgenommen werden.

Syntax

<take [item=""] [count="1"] [max=""] [from=""] [target=""] [takeAllAtOnce=""] [immediately=""] [group-sync="true"] [equip="false"] [quality=""] [show="none"]/>
<take [item=""] [count="1"] [max=""] [from=""] [target=""] [takeAllAtOnce=""] [immediately=""] [group-sync="true"] [equip="false"] [quality=""] [show="none"]>Bezeichnung</take>
<take [item=""] [count="1"] [max=""] [quality=""]>
  <contains item="" [count="1"] [quality=""] />
</take>

• item: die Bezeichnung des Gegenstandes (siehe Aktuelle_Warenliste).
• count: für die Anzahl (default ist 1)
• max: Maximale Anzahl, die der Held hinterher haben soll. Wirkt nicht bei Inventaren und begrenzt nur zusätzliche Items, nicht die der Held bereits hat.
• from: Ermöglicht die Entnahme von Items aus einem zuvor festgelegten Inventar.
• target: Sobald die unter count angegebene Menge an Gegenständen aufgenommen wurde, wird automatisch die Szene aufgerufen, die unter target angegeben ist. Wird kein target angegeben, findet keine Weiterleitung auf eine andere Szene statt.
• takeAllAtOnce: (nur in Verbindung mit 'from' und ohne 'count') zeigt bei der Entnahme aus einem Inventar einen Link an, der es ermöglicht alle Gegenstände aufzunehmen (alles mitnehmen)
• immediately: Wenn 'true' werden die Gegenstände unmittelbar aus einem Inventar aufgenommen, ohne dass das Inventar erst angezeigt wird.
• group-sync: Diese Einstellung greift für Inventare mit scope="hero" in Gruppenquests. Standardmäßig (wenn group-sync="true") wird der Inventarinhalt für ALLE Gruppenmitglieder synchronisiert. Sollte es nur für die selektierten Gruppenmitglieder gewünscht sein, dann muss group-sync="false" angegeben werden.
• equip (nur für ZBs!): Greift nur in Verbindung mit dem from-Attribut in Zufallsbegegnungen. Wenn 'true' wird versucht, aufgenommene Waren direkt anzulegen (auszurüsten).
• quality: Ein Zahlenwert zwischen 0 und 100, der die Qualität der Ware festlegt. 100 bedeutet "Superior" (perfekt), 0 bedeutet "Murks" (unbrauchbar)
• show: wenn 'none' erfolgt keine sichtbare Ausgabe für den Spieler über die aufgenommenen Waren.

Wenn das take-Tag keinen Inhalt hat, wird die Anzahl und Bezeichnung des Gegenstandes ausgegeben. Falls ein Inhalt vorhanden ist, wird dieser ausgewertet und ausgegeben.

Zudem ist es möglich, gefüllte Behälter zu vergeben. Dazu kann das Subtag contains verwendet werden, siehe Beispiel weiter unten.

Beispiele

Item aufnehmen

<take item="Schwert" />

legt dem Helden ein Schwert ins Inventar.

<take item="Schneeball" count="5" />

gibt dem Helden fünf Schneebälle.

<take item="Schneeball" count="2" max="5"/>

Hat der Held 3 oder weniger Schnellbälle, so er hält er 2 dazu, hat er schon 4, erhält er nur noch 1. Hat er schon 5 oder mehr, erhält er keinen zusätzlichen Schneeball.

Man kann auch die WarenID angeben, sofern sie bekannt ist.

<take item="#623"/><!-- der Held erhält einen unbearbeiteten Feueropal -->

Dies macht jedoch nur Sinn, wenn es mehrere Waren mit demselben Namen gibt (meist Edelsteine mit unterschiedlichen Schliffen)

Item aus Inventar entnehmen

<take from="ein-inventar" takeAllAtOnce="true" />

Der Spieler bekommt ein Inventar (das vorher definiert worden sein muss) angezeigt, aus das er Waren entnehmen kann. Das Attribut 'takeAllAtOnce' ermöglicht zudem die Entnahme aller Gegenstände mit einem Klick ('alles mitnehmen').

Auf diese Art und Weise können in Questen die Waffen des Helden abgelegt werden - und nach einiger Zeit wieder angelegt werden:

<!-- Achtung: Das Beispiel gilt nur für Quests und nicht für ZB, da bei ZB dem Held automatisch ein Knüppel in die Hand gedrückt wird, sollte er seine Waffen verlieren -->

<!-- Waffen werden auf den Boden gelegt -->
<drop weapon="true" to="Boden"/>

<!-- ... hier passiert etwas, z.B. ein Kampf ... -->

<!-- Waffen werden wieder vom Boden genommen und angelegt -->
<take from="Boden" equip="true"/>

Gefüllten Behälter aufnehmen

Einige Gegenstände können andere beinhalten, wie z.B. ein Schmuckkästchen mit kleineren Items oder eine Dolchscheide mit einem Dolch oder ein Köcher mit Pfeilen oder oder ...

Bereits befüllte Behälter können auf diese Art dem Held gegeben werden:

<take item="Schmuckkästchen">
  <contains item="Perle" />
  <contains item="Diamant" />
</take>

Oder ein befüllter Köcher:

<take item="Hölzerner Köcher für 20 Pfeile">
  <contains item="Jagdpfeil" count="20" />
</take>

Oder möchte mit verschiedenen Pfeilen und einem gewissen Etwas:

<take item="Hölzerner Köcher für 20 Pfeile">
  <contains item="Jagdpfeil" count="10" />
  <contains item="Kriegspfeil" count="4" />
  <contains item="Diamant" count="1" />
</take>

Hierbei ist zu beachten, dass versteckte Behälter anders strukturiert sind als normale und nicht befüllt werden können, ohne Fehler zu verursachen.

Einen zufälligen Gegenstand aus einem Warentag vergeben

Siehe: Item.