Get: Unterschied zwischen den Versionen

Aus AntamarWiki
Wechseln zu: Navigation, Suche
(neu: object="selected-item")
(Neuen Paramter eingefügt)
 
(9 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
 
== Syntax ==
 
== Syntax ==
 
<code xml n>
 
<code xml n>
<get [object="hero"] [attribute=""] [quality=""] />
+
<get [object="hero"] [attribute=""] [quality=""] [talent=""] />
 
</code>
 
</code>
  
*'''object''': Standardmäßig wird auf dem Held "gearbeitet" und alle seine Werte abgefragt. Ist jedoch ''object="selected-item"'' angegeben, wird auf einem zuvor selektierten Gegenstand (siehe [[item-select]]) gearbeitet und dessen Attribute abgefragt.
+
*'''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]].
 
*'''attribute''' beim Helden alle möglichen [[Held Attribute|Heldenattribute]].
Bei einem Gegenstand ''(object="selected-item")'' existieren die zwei Attribute 'quality' (Zustand, Wert zwischen 0 und 100) und 'name' (der Name der Ware).
+
: 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).
*'''quality''' beim Helden alle Eigenschaften: MU (Mut), IQ (Intelligenz), IN (Intuition), WI (Willenskraft), CH (Charisma), FF (Fingerfertigkeit), GE (Gewandheit), KO (Konstitution), ST (Stärke)
+
: 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 ==
 
== Beispiele für den Held ==
Zeile 24: Zeile 28:
  
 
Die abfragbaren Attribute stehen auf der Seite [[Held Attribute]].
 
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") ==
 
== Beispiele für einen Gegenstand (object="selected-item") ==
  
Wurde zuvor ein Gegenstand via [[item-select]] ausgewählt, können die zwei Warenattribute 'name' und 'quality' herangezogen werden:
+
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>
 
<code xml n>
 
<!-- Qualität der Ware (Wert zwischen 0 und 100) -->
 
<!-- Qualität der Ware (Wert zwischen 0 und 100) -->
Zeile 35: Zeile 70:
 
<!-- Name der Ware -->
 
<!-- Name der Ware -->
 
<get object="selected-item" attribute="name" />
 
<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>
 
</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]]
 
[[Kategorie:AOQML-Tags]]
[[Kategorie:AOQML]]
 

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.

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.
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>