Quelltext der Seite AOQML Library / 028 - Prüfung auf Vorhandensein bestimmter Elemente (Lichtquelle, Schreibzeug usw...)

'''[[AOQML Library]]'''

'''Eintrag 028''' - Prüfung auf Vorhandensein bestimmter Elemente (Lichtquelle, Schreibzeug usw...).

'''Beschreibung der Anwendung:'''

Das Vorhandensein bestimmer Items oder Fertigkeiten soll abgefragt werden, und Konsequenzen zu bestimmen.

== Prüfungen auf Vorhandensein bestimmer Elemente ==

=== Prüfung auf Lichtquelle ===
Wenn du abfragen möchtest, ob ein Held eine Lichtquelle dabei hat, kannst du dies wie folgt tun:
<code xml n>
<include target="/lib/_lichtquelle"/> <!-- prüft, ob der Held Licht dabei hat oder Licht entfachen kann -->
<has name="Lichtquelle">
  <success>
    <!-- Held hat nun Licht -->  
  </success>
  <failure>
    <!-- Held tappt im Dunkeln. Entweder keine Lichtquelle dabei oder Probe zum Entfachen ist misslungen. -->
  </failure>
</has>
</code>

Ergebnis-Variablen:

*Lichtquelle     (scope="hero")
 (NULL)              - Variable ist nicht gesetzt, wenn kein Licht verfügbar
 Disareg             - wenn Disaregstein genutzt
 Fackel              - wenn Pechfackel genutzt
 Sturmlaterne        - wenn Öl-Sturmlaterne genutzt
 Lampe               - wenn Kerzenlaterne oder Öllampe genutzt
 Kerze               - wenn Stundenkerze oder Spannenlange Kerze
*AOQML_Bibliothek_Lichtquelle_feuer_entfacht     (scope="scene")
 (NULL)              - Variable ist nicht gesetzt, wenn kein Feuer entfacht werden musste.
 ja                  - Falls Lichtquelle entzündet werden musste und der Held dies erfolgreich getan hat
 nein                - Falls Held nicht die nötigen Materialien hat und nicht per Improvisation (Probe Wildnisleben) eine Lichtquelle entzünden konnte.

=== Prüfung auf Lichtquelle (Gruppen-Variante) ===
Wenn du eine Gruppen-Quest/-ZB schreibst, kannst du wie folgt abfragen, ob die Gruppe Licht hat.
<code xml n>
<include target="/lib/_lichtquelle"/> <!-- prüft, ob die Gruppe Licht dabei hat oder Licht entfachen kann -->
<has name="Lichtquelle">
  <success>
    <!-- Gruppe hat nun Licht -->  
  </success>
  <failure>
    <!-- Gruppe tappt im Dunkeln. Entweder keine Lichtquelle dabei oder Probe zum Entfachen ist misslungen. -->
  </failure>
</has>
</code>

Ergebnis-Variablen:

*Lichtquelle     (scope="hero")  Nicht bei allen Gruppenmitgliedern, sondern nur bei demjenigen, der die Lichtquelle hat.
 (NULL)              - Variable ist nicht gesetzt, wenn kein Licht verfügbar
 Disareg             - wenn Disaregstein genutzt
 Fackel              - wenn Pechfackel genutzt
 Sturmlaterne        - wenn Öl-Sturmlaterne genutzt
 Lampe               - wenn Kerzenlaterne oder Öllampe genutzt
 Kerze               - wenn Stundenkerze oder Spannenlange Kerze
*AOQML_Bibliothek_Lichtquelle_Gruppe_id_held           (scope="quest")
 (NULL)              - Variable ist nicht gesetzt, wenn kein Licht verfügbar
 <HeldID>            - HeldID desjenigen, der die Lichtquelle trägt
*AOQML_Bibliothek_Lichtquelle_Gruppe_feuer_entfacht    (scope="scene")
 (NULL)              - Variable ist nicht gesetzt, wenn kein Feuer entfacht werden musste.
 ja                  - Falls Lichtquelle entzündet werden musste und der Held dies erfolgreich getan hat
 nein                - Falls Helden nicht die nötigen Materialien haben und nicht per Improvisation (Probe Wildnisleben) eine Lichtquelle entzünden konnten.

=== Prüfung auf Schreibzeug ===
Wenn du prüfen möchtest, ob der Held entsprechendes Material dabei hat um sich Sachen zu notieren, kannst du dies wie folgt tun:
<code xml n>
<include target="/lib/_hatSchreibzeug"/> <!-- prüft, ob der Held Schreibzeug dabei hat -->
<switch name="hatSchreibzeug">
  <case val="true">
    <!-- Held hat Schreibzeug -->
  </case>
  <else>
    <!-- Held hat kein Schreibzeug -->
  </else>
</switch>
</code>


Ergebnis-Variablen:
<code>
- hatSchreibzeug    (scope="quest")     'true' oder 'false'
</code>

===Prüfung auf Landessprache===
Wenn du prüfen möchtest, ob der Held die hiesige Landessprache beherrscht, kannst du dies wie folgt tun:
<code xml n>
<include target="/lib/_landessprache" />

<switch name="KannSprache">
  <case val="ja">
    <p>Du verstehst alles, was hier in <fetch name="Landessprache" /> gesprochen wird.</p>
  </case>
  <else>
    <p>Du kannst den Einwohnern nicht folgen.</p>
  </else>
</switch>
</code>

Optionale Input-Variablen:
<code xml>
- LandesspracheFeW
      Falls diese Variable gesetzt ist, wird der Wert als Mindestanforderung genutzt.
      Andernfalls wird FeW 8 als Voraussetzung benutzt.
</code>

Ergebnis-Variablen:
<code xml>
- KannSprache         (scope="quest")
    ja                Wenn Held die hiesige Landessprache beherrscht
    nein              Wenn Held die hiesige Landessprache nicht beherrscht
- Landessprache       (scope="quest") 
    Enthält die Fertigkeit (=Sprache), welche vorort die Landessprache ist
</code>