Get: Unterschied zwischen den Versionen
K (Weiterleitung nach Get Set erstellt) |
Helix (Diskussion | Beiträge) (Neuen Paramter eingefügt) |
||
(12 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | + | Die Tags [[get]] und [[set]] geben Zugriff auf die Werte des Helden, also die Eigenschaften, Lebensenergie, Ausdauer, Abenteuerpunkte, Talentwerte etc. '''Get''' liest die Werte aus, mit '''set''' kann man sie verändern um z.B. Schadenspunkte oder Erfahrungspunkte zu verteilen. | |
+ | |||
+ | == Syntax == | ||
+ | <code xml n> | ||
+ | <get [object="hero"] [attribute=""] [quality=""] [talent=""] /> | ||
+ | </code> | ||
+ | |||
+ | *'''object''': Standardmäßig wird auf dem Held "gearbeitet" und alle seine Werte abgefragt. | ||
+ | : Ist ''object="selected-item"'' angegeben, wird auf einem zuvor selektierten Gegenstand (siehe [[item-select]]) gearbeitet und dessen Attribute abgefragt. | ||
+ | : Ist ''object="taverne"'' angegeben, werden die Werte der Taverne (in der sich der Held befindet) abgefragt. | ||
+ | : Ist ''object="ordenshaus"'' angegeben, werden die Werte des Ordenshauses (in dem sich der Held befindet) abgefragt. | ||
+ | *'''attribute''' beim Helden alle möglichen [[Held Attribute|Heldenattribute]]. | ||
+ | : Bei einem Gegenstand ''(object="selected-item")'' existieren die zwei Attribute 'instance_id' (WareninstanzID), 'quality' (Zustand; ein Wert zwischen 0 und 100), 'name' (der Name der Ware). | ||
+ | : Bei der Taverne ''(object="taverne")'' existieren die Attribute 'name', 'beschreibung', 'quality', 'preis' und 'schlafplaetze'. | ||
+ | : Bei einem Ordenshaus ''(object="ordenshaus")'' existieren die Attribute 'anwesende_helden', 'flaeche_bebaut', 'flaeche_gesamt', 'flaeche_verfuegbar', 'grund_id', 'schatz', 'schatz_max' | ||
+ | *'''quality''' beim Helden alle [[Eigenschaften]]: MU (Mut), IQ (Intelligenz), IN (Intuition), WI (Willenskraft), CH (Charisma), FF (Fingerfertigkeit), GE (Gewandtheit), KO (Konstitution), ST (Stärke) | ||
+ | *'''talent''' beim Helden alle [[Fertigkeiten]], z.B. 'Sinnenschärfe', 'Wuchtwaffen' usw. | ||
+ | |||
+ | == Beispiele für den Held == | ||
+ | |||
+ | <code xml n> | ||
+ | <get quality="ST"/><!-- gibt den aktuellen Wert der Körperkraft an. --> | ||
+ | |||
+ | <get attribute="LEP"/> <!-- gibt den aktuellen Wert der Lebensenergie an --> | ||
+ | |||
+ | <get attribute="LEPmax"/> <!-- gibt den maximalen Wert der Lebenspunkte an --> | ||
+ | </code> | ||
+ | |||
+ | Die abfragbaren Attribute stehen auf der Seite [[Held Attribute]]. | ||
+ | |||
+ | |||
+ | == Beispiele für die Taverne (object="taverne") == | ||
+ | Es stehen die folgenden Attribute zur Verfügung: | ||
+ | *name | ||
+ | *beschreibung | ||
+ | *preis | ||
+ | *schlafplaetze | ||
+ | *quality (Wert zwischen 0 und 10) | ||
+ | |||
+ | Auf Basis der Qualität der Absteige (Taverne/Gasthaus) sollen unterschiedliche Texte ausgegeben werden: | ||
+ | |||
+ | <code xml n> | ||
+ | <store name="taverne_quali"><get object="taverne" attribute="quality"/></store> | ||
+ | |||
+ | <switch name="taverne_quali"> | ||
+ | <case val="0|1|2|3"> | ||
+ | <p>Ganz schön runtergekommen hier.</p> | ||
+ | </case> | ||
+ | <case val="4|5|6"> | ||
+ | <p>Nicht besonders dekorativ ausgestattet, aber wenigstens sind keine Kakerlaken in Sichtweite.</p> | ||
+ | </case> | ||
+ | <case val="7|8"> | ||
+ | <p>Hui, das Besteck ist sogar poliert!</p> | ||
+ | </case> | ||
+ | <else><!-- größer als 8 --> | ||
+ | <p>Ein edles Etablissement!</p> | ||
+ | </else> | ||
+ | </switch> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | |||
+ | == Beispiele für einen Gegenstand (object="selected-item") == | ||
+ | |||
+ | Wurde zuvor ein Gegenstand via [[item-select]] ausgewählt, können die Warenattribute 'name', 'weight', '[[Quality (AOQML-Attribut)|quality]]' und 'instance_id' ausgelesen werden: | ||
+ | <code xml n> | ||
+ | <!-- Qualität der Ware (Wert zwischen 0 und 100) --> | ||
+ | <get object="selected-item" attribute="quality" /> | ||
+ | |||
+ | <!-- Name der Ware --> | ||
+ | <get object="selected-item" attribute="name" /> | ||
+ | |||
+ | <!-- Gewicht der Ware --> | ||
+ | <get object="selected-item" attribute="weight" /> | ||
+ | |||
+ | <!-- InstanzID der Ware (für weitere Verwendung, dem Spieler nicht zeigen!) --> | ||
+ | <store name="instanzID"><get object="selected-item" attribute="instance_id"/></store> | ||
+ | </code> | ||
+ | |||
+ | == Beispiele für ein Ordenshaus (object="ordenshaus") == | ||
+ | |||
+ | Folgende Attribute stehen für ''object="ordenshaus"'' zur Verfügung: | ||
+ | * anwesende_helden -> liefert eine Anzahl der anwesenden Helden, die Ordensmitglieder des Ordens sind | ||
+ | * flaeche_bebaut -> liefert die bisher bebaute Größe in QS aller Gebäude auf dem Grundstück | ||
+ | * flaeche_gesamt -> liefert die gesamte nutzbare Fläche (in QS) des Ordensgrundstücks | ||
+ | * flaeche_verfuegbar -> liefert die bisher unbebaute Fläche in QS am Standort | ||
+ | * grund_id -> liefert die ID des Ordensgrundstücks. | ||
+ | * schatz -> liefert den aktuellen Goldbetrag des Schatzes | ||
+ | * schatz_max -> liefert die Höchstsumme, die in der Schatzkammer aufgewahrt werden kann | ||
+ | |||
+ | Beispiel: | ||
+ | <code xml n> | ||
+ | <store name="gold_aktuell"><get object="ordenshaus" attribute="schatz"/></store> | ||
+ | <store name="gold_max"><get object="ordenshaus" attribute="schatz_max"/></store> | ||
+ | |||
+ | <switch name="gold_aktuell"> | ||
+ | <case name="gold_max"> | ||
+ | <p>Die Schatzkammer ist randvoll!</p> | ||
+ | </case> | ||
+ | <else> | ||
+ | <p>In der Schatzkammer ist noch Platz.</p> | ||
+ | </else> | ||
+ | </switch> | ||
+ | |||
+ | </code> | ||
+ | |||
+ | [[Kategorie:AOQML-Tags]] |
Aktuelle Version vom 14. Februar 2022, 21:55 Uhr
Die Tags get und set geben Zugriff auf die Werte des Helden, also die Eigenschaften, Lebensenergie, Ausdauer, Abenteuerpunkte, Talentwerte etc. Get liest die Werte aus, mit set kann man sie verändern um z.B. Schadenspunkte oder Erfahrungspunkte zu verteilen.
Inhaltsverzeichnis
Syntax
<get [object="hero"] [attribute=""] [quality=""] [talent=""] />
- object: Standardmäßig wird auf dem Held "gearbeitet" und alle seine Werte abgefragt.
- Ist object="selected-item" angegeben, wird auf einem zuvor selektierten Gegenstand (siehe item-select) gearbeitet und dessen Attribute abgefragt.
- Ist object="taverne" angegeben, werden die Werte der Taverne (in der sich der Held befindet) abgefragt.
- Ist object="ordenshaus" angegeben, werden die Werte des Ordenshauses (in dem sich der Held befindet) abgefragt.
- attribute beim Helden alle möglichen Heldenattribute.
- Bei einem Gegenstand (object="selected-item") existieren die zwei Attribute 'instance_id' (WareninstanzID), 'quality' (Zustand; ein Wert zwischen 0 und 100), 'name' (der Name der Ware).
- Bei der Taverne (object="taverne") existieren die Attribute 'name', 'beschreibung', 'quality', 'preis' und 'schlafplaetze'.
- Bei einem Ordenshaus (object="ordenshaus") existieren die Attribute 'anwesende_helden', 'flaeche_bebaut', 'flaeche_gesamt', 'flaeche_verfuegbar', 'grund_id', 'schatz', 'schatz_max'
- quality beim Helden alle Eigenschaften: MU (Mut), IQ (Intelligenz), IN (Intuition), WI (Willenskraft), CH (Charisma), FF (Fingerfertigkeit), GE (Gewandtheit), KO (Konstitution), ST (Stärke)
- talent beim Helden alle Fertigkeiten, z.B. 'Sinnenschärfe', 'Wuchtwaffen' usw.
Beispiele für den Held
<get quality="ST"/><!-- gibt den aktuellen Wert der Körperkraft an. -->
<get attribute="LEP"/> <!-- gibt den aktuellen Wert der Lebensenergie an -->
<get attribute="LEPmax"/> <!-- gibt den maximalen Wert der Lebenspunkte an -->
Die abfragbaren Attribute stehen auf der Seite Held Attribute.
Beispiele für die Taverne (object="taverne")
Es stehen die folgenden Attribute zur Verfügung:
- name
- beschreibung
- preis
- schlafplaetze
- quality (Wert zwischen 0 und 10)
Auf Basis der Qualität der Absteige (Taverne/Gasthaus) sollen unterschiedliche Texte ausgegeben werden:
<store name="taverne_quali"><get object="taverne" attribute="quality"/></store>
<switch name="taverne_quali">
<case val="0|1|2|3">
<p>Ganz schön runtergekommen hier.</p>
</case>
<case val="4|5|6">
<p>Nicht besonders dekorativ ausgestattet, aber wenigstens sind keine Kakerlaken in Sichtweite.</p>
</case>
<case val="7|8">
<p>Hui, das Besteck ist sogar poliert!</p>
</case>
<else><!-- größer als 8 -->
<p>Ein edles Etablissement!</p>
</else>
</switch>
Beispiele für einen Gegenstand (object="selected-item")
Wurde zuvor ein Gegenstand via item-select ausgewählt, können die Warenattribute 'name', 'weight', 'quality' und 'instance_id' ausgelesen werden:
<!-- Qualität der Ware (Wert zwischen 0 und 100) -->
<get object="selected-item" attribute="quality" />
<!-- Name der Ware -->
<get object="selected-item" attribute="name" />
<!-- Gewicht der Ware -->
<get object="selected-item" attribute="weight" />
<!-- InstanzID der Ware (für weitere Verwendung, dem Spieler nicht zeigen!) -->
<store name="instanzID"><get object="selected-item" attribute="instance_id"/></store>
Beispiele für ein Ordenshaus (object="ordenshaus")
Folgende Attribute stehen für object="ordenshaus" zur Verfügung:
- anwesende_helden -> liefert eine Anzahl der anwesenden Helden, die Ordensmitglieder des Ordens sind
- flaeche_bebaut -> liefert die bisher bebaute Größe in QS aller Gebäude auf dem Grundstück
- flaeche_gesamt -> liefert die gesamte nutzbare Fläche (in QS) des Ordensgrundstücks
- flaeche_verfuegbar -> liefert die bisher unbebaute Fläche in QS am Standort
- grund_id -> liefert die ID des Ordensgrundstücks.
- schatz -> liefert den aktuellen Goldbetrag des Schatzes
- schatz_max -> liefert die Höchstsumme, die in der Schatzkammer aufgewahrt werden kann
Beispiel:
<store name="gold_aktuell"><get object="ordenshaus" attribute="schatz"/></store>
<store name="gold_max"><get object="ordenshaus" attribute="schatz_max"/></store>
<switch name="gold_aktuell">
<case name="gold_max">
<p>Die Schatzkammer ist randvoll!</p>
</case>
<else>
<p>In der Schatzkammer ist noch Platz.</p>
</else>
</switch>