Has: Unterschied zwischen den Versionen

Aus AntamarWiki
Wechseln zu: Navigation, Suche
(neu: <has companion="">)
Zeile 3: Zeile 3:
 
== Syntax ==
 
== Syntax ==
 
<code xml>
 
<code xml>
<has [item="" [equipped=""]] [talent=""] [quality=""] [name=""] [attribute=""] [companion-type=""]
+
<has [item="" [equipped=""]] [talent=""] [quality=""] [name=""] [attribute=""] [companion=""] [companion-type=""]
 
     [val=""] [min=""] [max=""] [hero-quantity="1"] [companions-affected="true"] [show="result"] />
 
     [val=""] [min=""] [max=""] [hero-quantity="1"] [companions-affected="true"] [show="result"] />
 
</code>
 
</code>
Zeile 13: Zeile 13:
 
*'''attribute''': Bezeichnung des [[Held Attribute|Attributes]]
 
*'''attribute''': Bezeichnung des [[Held Attribute|Attributes]]
 
*'''name''': Bezeichnung einer Variablen, siehe u.a. [[Globale marker]], [[Store_fetch|Store/Fetch]]
 
*'''name''': Bezeichnung einer Variablen, siehe u.a. [[Globale marker]], [[Store_fetch|Store/Fetch]]
*'''companion-type''': Hiermit kann geprüft werden, ob der Held einen bestimmten Begleiter hat. Mögliche Ausprägungen sind: 'Hund', 'Esel', 'Pferd', 'Kamel'
+
*'''companion''': Hier kann geprüft werden, ob der Held einen bestimmten Begleiter (der Warenname!) hat wie z.B. 'Grauesel', 'Aivarunenpony', 'Mahburger Pferd', 'Papagei' usw.
*Achtung, ausgerüstete '''Begleiter''' können '''nicht''' mehr als Gegenstände erkannt werden!
+
*'''companion-type''': Hiermit kann geprüft werden, ob der Held einen bestimmten Begleitertyp hat. Mögliche Ausprägungen sind: 'Hund', 'Esel', 'Pferd', 'Kamel'
  
 +
Achtung, ausgerüstete '''Begleiter''' können '''nicht''' als Gegenstände bei der Abfrage &lt;has item="..."&gt; erkannt werden!
  
Optional zusätzlich dazu:
+
 
*'''val''' oder '''value''' (nur in Kombination mit '''attribute''' oder '''name'''!): prüft, ob das zu prüfende Attribut oder die zu prüfende Variable eine konkrete Ausprägung besitzt  
+
Optional zusätlich:
*'''min''': minimale Anzahl bzw. minimaler Wert, um in den </success>-Zweig zu gelangen
+
*'''val''' oder '''value''': prüft, ob das zu prüfende Attribut oder die zu prüfende Variable eine konkrete Ausprägung besitzt  
*'''max''': maximale Anzahl bzw. maximaler Wert, um in den </success>-Zweig zu gelangen
+
*'''min''': minimale Anzahl bzw. minimaler Wert, um in den <success>-Zweig zu gelangen
Das max-Attribut ist damit praktisch eine Negierung derselben Abfrage mit min und umgekehrt.
+
*'''max''': maximale Anzahl bzw. maximaler Wert, um in den <success>-Zweig zu gelangen
 
*'''hero-quantity''': (greift nur bei [[Gruppe|Gruppenbegegnungen]]) Wenn z.B. 2 angegeben, müssen zwei Helden die Bedingung erfüllen. Standardmäßig reicht es, wenn ein Held die Bedingung erfüllt.
 
*'''hero-quantity''': (greift nur bei [[Gruppe|Gruppenbegegnungen]]) Wenn z.B. 2 angegeben, müssen zwei Helden die Bedingung erfüllen. Standardmäßig reicht es, wenn ein Held die Bedingung erfüllt.
 
*'''companions-affected''': (standardmäßig ''true'') Wenn 'true' und ein ''item'' angegeben, wird auch das Gepäck von evtl. vorhandenen [[Begleiter|Begleitern]] des Helden durchsucht. Wenn 'false' werden die Gepäckgegenstände der Begleiter ignoriert.
 
*'''companions-affected''': (standardmäßig ''true'') Wenn 'true' und ein ''item'' angegeben, wird auch das Gepäck von evtl. vorhandenen [[Begleiter|Begleitern]] des Helden durchsucht. Wenn 'false' werden die Gepäckgegenstände der Begleiter ignoriert.
Zeile 43: Zeile 44:
 
   <failure>
 
   <failure>
 
     [Probe auf Wildnisleben +3 um ein Feuer zu entfachen]
 
     [Probe auf Wildnisleben +3 um ein Feuer zu entfachen]
 +
  </failure>
 +
</has>
 +
</code>
 +
 +
Das PLUS-Zeichen "+" gibt an, dass all die angegebenen Items vorhanden sein müssen, z.B.:
 +
<code xml>
 +
<has item="Porzellanstatue+Zinnstatuette">
 +
  <success>
 +
    <p>Beide Statuen dabei!</p>
 +
  </success>
 +
  <failure>
 +
    <p>Mindestens eine (oder beide) Statuetten fehlen dir!</p>
 
   </failure>
 
   </failure>
 
</has>
 
</has>
Zeile 156: Zeile 169:
 
     <p>Ihr seid rechtschaffende Helden!</p>
 
     <p>Ihr seid rechtschaffende Helden!</p>
 
   </success>
 
   </success>
 +
</has>
 +
</code>
 +
 +
=== companion ===
 +
Prüft, ob der Held einen konkreten Begleiter hat. Funktioniert genauso wie &lt;has item="..."&gt;
 +
<code xml>
 +
<has companion="Grauesel">
 +
  <success>
 +
    <p>Mind. ein Grauesel als Begleiter!</p>
 +
  </success>
 +
  <failure>
 +
    <p>Kein Grauesel als Begleiter!</p>
 +
  </failure>
 +
</has>
 +
 +
<has companion="Grauesel|Maulesel">
 +
  <success>
 +
    <p>Mind. ein Grauesel oder ein Maulesel Begleiter!</p>
 +
  </success>
 +
  <failure>
 +
    <p>Kein Grauesel oder Maulesel als Begleiter!</p>
 +
  </failure>
 +
</has>
 +
 +
<has companion="Papagei" min="2">
 +
  <success>
 +
    <p>Mind. zwei Papageie als Begleiter!</p>
 +
  </success>
 +
  <failure>
 +
    <p>Keine zwei Papageie (oder mehr) als Begleiter!</p>
 +
  </failure>
 +
</has>
 +
 +
<has companion="Maulesel+Papagei">
 +
  <success>
 +
    <p>Sowohl Maulesel als auch Papagei als Begleiter!</p>
 +
  </success>
 +
  <failure>
 +
    <p>Maulesel und Papagei in der Kombination nicht als Begleiter!</p>
 +
  </failure>
 
</has>
 
</has>
 
</code>
 
</code>
  
 
=== companion-type ===
 
=== companion-type ===
Erlaubt die Prüfung, ob der Held ein bestimmtes Tier als Begleiter hat:
+
Erlaubt die Prüfung, ob der Held ein bestimmten Typ an Begleiter hat:
<code xml n>
+
<code xml>
 
<!-- Hund aktiv? -->
 
<!-- Hund aktiv? -->
 
<has companion-type="Hund">
 
<has companion-type="Hund">

Version vom 3. November 2013, 13:16 Uhr

Mit dem <has>-Tag kann in AOQML überprüft werden, ob ein Held ein Talent oder eine Eigenschaft oder einen Gegestand oder eine gespeicherte Variable hat.

Syntax

<has [item="" [equipped=""]] [talent=""] [quality=""] [name=""] [attribute=""] [companion=""] [companion-type=""]
     [val=""] [min=""] [max=""] [hero-quantity="1"] [companions-affected="true"] [show="result"] />
  • item: Bezeichnung des Gegenstandes, z.B. "Angelschnur mit Haken". Es können auch Waren-Tags verwendet werden.
  • equipped: (nur in Kombination mit item) Wenn nicht angegeben, wird der Gegenstand sowohl im Gepäck als auch bei getragener Kleidung/Rüstung/Waffen gesucht. Wenn equipped="true" wird nur in der getragenen Kleidung/Rüstung/Waffe gesucht. Wenn equipped="false" wird nur im Gepäck gesucht.
  • talent: Bezeichnung des Talentes, z.B. "Zechen"
  • quality: Kurz-Bezeichnung der Eigenschaft, z.B. "ST" (für Stärke)
  • attribute: Bezeichnung des Attributes
  • name: Bezeichnung einer Variablen, siehe u.a. Globale marker, Store/Fetch
  • companion: Hier kann geprüft werden, ob der Held einen bestimmten Begleiter (der Warenname!) hat wie z.B. 'Grauesel', 'Aivarunenpony', 'Mahburger Pferd', 'Papagei' usw.
  • companion-type: Hiermit kann geprüft werden, ob der Held einen bestimmten Begleitertyp hat. Mögliche Ausprägungen sind: 'Hund', 'Esel', 'Pferd', 'Kamel'

Achtung, ausgerüstete Begleiter können nicht als Gegenstände bei der Abfrage <has item="..."> erkannt werden!


Optional zusätlich:

  • val oder value: prüft, ob das zu prüfende Attribut oder die zu prüfende Variable eine konkrete Ausprägung besitzt
  • min: minimale Anzahl bzw. minimaler Wert, um in den <success>-Zweig zu gelangen
  • max: maximale Anzahl bzw. maximaler Wert, um in den <success>-Zweig zu gelangen
  • hero-quantity: (greift nur bei Gruppenbegegnungen) Wenn z.B. 2 angegeben, müssen zwei Helden die Bedingung erfüllen. Standardmäßig reicht es, wenn ein Held die Bedingung erfüllt.
  • companions-affected: (standardmäßig true) Wenn 'true' und ein item angegeben, wird auch das Gepäck von evtl. vorhandenen Begleitern des Helden durchsucht. Wenn 'false' werden die Gepäckgegenstände der Begleiter ignoriert.

Mit show="none" wird die has-Abfrage für den Spieler nicht sichtbar durchgeführt (sie wird versteckt durchgeführt).

In allen Attributen ist die Verwendung besonderer Werte möglich.

Für die Auswertung siehe <success>...</success> und <failure>...</failure> unter challenge.

Beispiele

has item

Mit <has item=""> lässt sich prüfen, ob der Held einen oder mehrere bestimmte Gegenstände dabei hat.

<has item="Zunderdose" companions-affected="true">
  <success>
    [Probe auf Wildnisleben normal um ein Feuer zu entfachen]
  </success>
  <failure>
    [Probe auf Wildnisleben +3 um ein Feuer zu entfachen]
  </failure>
</has>

Das PLUS-Zeichen "+" gibt an, dass all die angegebenen Items vorhanden sein müssen, z.B.:

<has item="Porzellanstatue+Zinnstatuette">
  <success>
    <p>Beide Statuen dabei!</p>
  </success>
  <failure>
    <p>Mindestens eine (oder beide) Statuetten fehlen dir!</p>
  </failure>
</has>

Das ODER-Zeichen "|" erlaubt auch alternative Gegenstände, z.B.:

<has item="Zunderdose|Wasserdichte Zunderdose|Feuerstein und Stahl" companions-affected="true">
  <success>
    [Probe auf Wildnisleben normal um ein Feuer zu entfachen]
  </success>
  <failure>
    [Probe auf Wildnisleben +3 um ein Feuer zu entfachen]
  </failure>
</has>

Das PROZENT-Zeichen "%" steht für beliebige Zeichen und erlaubt so Gegenstände mit Teilinformationen zu prüfen, z.B.:

<has item="%dolch">
  <success>
    [Bestättigung, wenn Gegenstände mit DOLCH am Ende vorhanden sind.]
  </success>
  <failure>
    [Bestättigung, wenn keine Gegenstände mit DOLCH am Ende vorhanden sind.]
  </failure>
</has>

Wenn z.B. %dolch% benutzt wird, werden alle Gegenstände gewertet, die das Wort dolch im Namen haben. So würde zum Beispiel auch "Geheime Dolchscheide" gelten.

equipped

Wenn equipped nicht angegeben, wird der Gegenstand (item) sowohl im Gepäck (Rucksack) als auch bei getragener Kleidung/Rüstung/Waffen gesucht.
Wenn equipped="true" wird nur in der getragenen Kleidung/Rüstung/Waffe gesucht.
Wenn equipped="false" wird nur im Gepäck gesucht.

<!-- prüfen, ob der Held einen Schuppenpanzer angelegt hat (gerade trägt) -->
<has item="Schuppenpanzer" equipped="true">
  <success>
    <p>Ein schöner Schuppenpanzer, den du da trägst!</p>
  </success>
</has>

min und max

<!-- prüfen, ob der Held das Talent "Fechtwaffen" auf mindestens 5 gesteigert hat -->
<has talent="Fechtwaffen" min="5">
  <success>
    <p>Du verstehst etwas von Fechtwaffen!</p>
  </success>
  <failure>
    <p>Du kennst dich mit Fechtwaffen bisher nicht besonders gut aus!</p>
  </failure>
</has>

<!-- prüfen, ob der Held die Eigenschaft FF <= 12 hat -->
<has quality="FF" max="12">
  <success>
    <p>Du bist nicht besonders fingerfertig!</p>
  </success>
</has>

<!-- prüfen, wie gut die Sprache 'Zwergisch' bekannt -->
<has talent="Zwergisch" max="3">
  <success>
    <p>Du verstehst kein Wort, von dem, was die Zwerge sagen.</p>
  </success>
</has>


val

Das Attribut val ermöglicht die Prüfung auf ganz bestimmte Ausprägungen. Es steht bisher nur in Kombination mit attribute und name zur Verfügung und sollte nicht mit min- oder max- kombiniert werden.

<!-- Beispiel 1: Variable auf bestimmte Ausprägung prüfen -->
<store name="meine-testvariable" scope="quest">Leberkäs</store>
...
<has name="meine-testvariable" val="Leberkäs">
  <success>
    <!-- die Variable hat den Inhalt 'Leberkäs' -->
  </success>
  <failure>
    <!-- die Variable ist nicht mehr mit 'Leberkäs' beschrieben. Der Wert wurden zwischendurch geändert. -->
  </failure>
</has>

<!-- Beispiel 2: ein Heldattribut auf bestimmte Ausprägung testen -->
<has attribute="race" val="Mensch">
  <success>
    <p>Du bist ein Mensch.</p>
  </success>
  <failure><
    <p>Du bist kein Mensch.</p>
  </failure>
</has>

hero-quantity

Für Gruppen-Begegnungen wurde das Attribut hero-quantity eingeführt, das eine Zahl als Parameter erwartet. hero-quantity gibt an, wie viele Helden die Bedingung erfüllen müssen, um in den success-Pfad zu gelangen. Standardmäßig ist der Wert 1, d.h. es reicht normalerweise, wenn ein Held die Bedingung erfüllt. In einigen Fällen macht es jedoch Sinn, wenn mehrere Helden die Bedingung erfüllen müssen, z.B.:

<!-- NUR FÜR GRUPPENBEGEGNUNGEN !!! Anwendung von hero-quantity
zwei Helden müssen mindestens ein Charisma von 15 aufweisen -->
<has quality="CH" min="15" hero-quantity="2">
  <success>
    <p>Ihr seid ja ganz schön beeindruckend!</p>
  </success>
</has>

<!-- prüfen, ob alle Helden der Gruppe die Gesinnung 'getreu' (steht für gesetzestreu) haben -->
<has attribute="gesinnung" val="getreu" hero-quantity="all">
  <success>
    <p>Ihr seid rechtschaffende Helden!</p>
  </success>
</has>

companion

Prüft, ob der Held einen konkreten Begleiter hat. Funktioniert genauso wie <has item="...">

<has companion="Grauesel">
  <success>
    <p>Mind. ein Grauesel als Begleiter!</p>
  </success>
  <failure>
    <p>Kein Grauesel als Begleiter!</p>
  </failure>
</has>

<has companion="Grauesel|Maulesel">
  <success>
    <p>Mind. ein Grauesel oder ein Maulesel Begleiter!</p>
  </success>
  <failure>
    <p>Kein Grauesel oder Maulesel als Begleiter!</p>
  </failure>
</has>

<has companion="Papagei" min="2">
  <success>
    <p>Mind. zwei Papageie als Begleiter!</p>
  </success>
  <failure>
    <p>Keine zwei Papageie (oder mehr) als Begleiter!</p>
  </failure>
</has>

<has companion="Maulesel+Papagei">
  <success>
    <p>Sowohl Maulesel als auch Papagei als Begleiter!</p>
  </success>
  <failure>
    <p>Maulesel und Papagei in der Kombination nicht als Begleiter!</p>
  </failure>
</has>

companion-type

Erlaubt die Prüfung, ob der Held ein bestimmten Typ an Begleiter hat:

<!-- Hund aktiv? -->
<has companion-type="Hund">
  <success>
    <p><q>Ooooh, du hast aber einen süüüüüßen Hund!</q>.</p>
  </success>
  <failure>
    <p>Du hast keinen Hund als Begleiter.</p>
  </failure>
</has>

<!-- Esel aktiv? -->
<has companion-type="Esel">
  <success>
    <p>Dein Esel ist heute wieder sturr.</p>
  </success>
</has>

Geprüft werden können: 'Hund', 'Katze', 'Papagei', 'Esel', 'Pferd' und 'Kamel'.

Waffentypus abfragen

Möchte man z.B. wissen, ob der Held gerade einen Dolch trägt, kann man dies wie folgt tun:

<has item="waffe_typ=Dolche" equipped="true">

Möchte man z.B. wissen, ob der Held eine Wuchtwaffe irgendwo dabei hat (gerüstet oder nicht, auf Begleiter oder im Gepäck - ganz egal):

<has item="waffe_typ=Wuchtwaffen">

Ist auch kombinierbar. Möchte man z.B. wissen, ob der Held eine beliebige Zweihandwuchtwaffe oder Zweihandflegel angelegt hat:

<has item="waffe_typ=Zweihandwuchtwaffen|waffe_typ=Zweihandflegel" equipped="true">

usw.

Zur Info: Es existieren die folgenden Waffentypen: Anderthalbhänder Dolche Fechtwaffen Kettenstäbe Kettenwaffen Peitsche Raufen Schwerter Speere Stangenwaffen Stäbe Säbel Wuchtwaffen Zweihandflegel Zweihandklingen Zweihandwuchtwaffen

Waren-Tags

Waren-Tags können in AOQML bei has und drop beim Attribut item (anstelle der Angabe eines Gegenstandes) benutzt werden. Dazu muss lediglich ein * gefolgt von der Tag-Bezeichnung angegeben werden, Beispiel:

<has item="*Lichtquelle">
  <success>
    <p>Du machst dir erstmal Licht.</p>
  </success>
  <failure>
    <p>Du kannst nichtmal deine Hand vor den Augen sehen, so dunkel ist es hier.</p>
  </failure>
</has>

<!-- prüfen, ob mind. 15 Nahkampfwaffen dabei -->
<has item="*Nahkampfwaffe" min="15">
  <success>
    <p>Du trägst ja ein ganz schönes Waffenarsenal mit dir herum...</p>
  </success>
</has>