Set

Aus AntamarWiki
Version vom 13. April 2013, 21:18 Uhr von Lowlander (Diskussion | Beiträge) (expire statt duration (Vereinheitlichung mit store, duration funktioniert aber weiterhin) und scope eingeführt)
Wechseln zu: Navigation, Suche

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

<set [object="hero"] [scope="quest"] [attribute=""] [quality=""] [talent=""] [name=""] [inc=""] [dec=""] [val=""] [expire=""] />
  • object: Standardmäßig wird der aktive Held betrachtet und dessen Werte manipuliert. Es lassen sich jedoch noch weitere Objekte manipulieren:
Ist object="selected-item" angegeben, wird auf einem zuvor selektierten Gegenstand (siehe item-select) gearbeitet und dessen Attribute verändert.
Ist object="ordenshaus" angegeben, werden Werte des Ordenshauses, in dem sich der Held befindet, verändert.
  • scope und die Art wie eine Variable gespeichert wird. Hierbei verschiedene Möglichkeiten.
  • attribute beim Helden alle möglichen Heldenattribute. Beachte: Es lassen sich nicht alle Heldenattribute verändern, einige Attribute sind nur lesbar.
Bei einem Gegenstand (object="selected-item") kann das Attribut 'quality' (Zustand des Items, ein Wert zwischen 0 und 100) verändert werden.
Bei einem Ordenshaus (object="ordenshaus") kann das Attribut 'schatz' verändert werden (nur mittels inc oder dec, nicht mittels val/value!)
  • quality beim Held kann man Eigenschaften temporär verändern, siehe Beispiele weiter unten
  • talent beim Held kann man Fertigkeitswerte temporär verändern, siehe Beispiele weiter unten
  • name der Name einer Variable, die verändert werden sol
  • inc zur Erhöhung von Zahlenwerten bei Variablen oder Attributen
  • dec zur Verringerung von Zahlenwerten bei Variablen oder Attributen
  • expire diese Angabe wird benötigt, wenn beim Held eine Eigenschaft oder eine Fertigkeit temporär verändert werden soll

Beispiele für den Held

Um Heldenwerte mit set zu verändern, muss das Tag um ein Attribut erweitert werden, das entweder die neue Höhe angibt oder den Betrag um den der Wert verändert wird:

<set attribute="LEP" dec="5"/>

Verringert die Lebensenergie um 5.

<set attribute="LEP" inc="1...6"/>

Hingegen erhöht die LP um 1 bis 6 ("W6") Punkte, aber nur bis zum möglichen Maximum.

  • dec - Wert um den Betrag verringern
  • inc - Wert um den Betrag erhöhen
  • val - neuer Wert (absolut)

dec, inc, val, attribute und name können alle auch Besondere Werte annehmen.

Eigenschaften temporär ändern

Eigenschaften können mittels set temporär verändert werden. Beispiele:

<set quality="ST" inc="4" duration="10 days" /><!-- erhöht Stärke um 4 für 10 Tage -->
<set quality="FF" dec="2" duration="3 hours" /><!-- verringert Fingerfertigkeit um 2 für 3 Stunden -->

Fertigkeiten temporär ändern

Fertigkeitswerte (Talentwerte) können ebenfalls temporär verändert werden. Beispiele:

<set talent="Sinnenschärfe" inc="4" duration="10 days" /><!-- erhöht den FeW "Sinnenschärfe" um 4 für 10 Tage -->
<set talent="Schwimmen" dec="2" duration="3 hours" /><!-- verringert den FeW "Schwimmen" um 2 für 3 Stunden -->

Eigene Variablen verändern

Statt Attributen können auch Variablen-Werte gesetzt werden. Damit kann man beispielsweise im Laufe der Quest EP ansammeln:

<set name="questEP" inc="5" show="none"/>

Und dann am Ende der Quest gesammelt vergeben:

<set attribute="EP" inc="${questEP}"/>

Es handelt sich dabei um dieselben Variablen wie bei Store_fetch.


Beispiele für einen Gegenstand (object="selected-item")

Wurde zuvor ein Gegenstand via item-select ausgewählt, kann das Warenattribut quality (der Zustand des Gegenstandes) verändert werden:

<!-- die Qualität um 10 erhöhen (Obergrenze ist automatisch 100, das prüft die Engine von alleine) -->
<set object="selected-item" attribute="quality" inc="10" />

<!-- die Qualität um 7 verringern (Untergrenze ist automatisch 0, das prüft die Engine von alleine) -->
<set object="selected-item" attribute="quality" dec="7" />

<!-- die Qualität auf 100 setzen (Bestwert) -->
<set object="selected-item" attribute="quality" val="100" />


Beispiele für das Ordenshaus (object="ordenshaus")

Beim Ordenshaus kann bisher das Attribut schatz verändert werden, mittels inc oder dec, jedoch nicht mittels val/value, weil dies bei parallelen Ein-/Auszahlungen zu Problemen führen könnte.

<!-- Diebe klauen 15 Gulden aus der Schatzkammer -->
<store name="gold_aktuell"><get object="ordenshaus" attribute="schatz"/></store>
<has name="gold_aktuell" min="15000">
  <success>
    <!-- Diebe erhalten 15 Gulden -->
    <select role="Anführer"/>
    <set attribute="cash" inc="15000" />

    <!-- Ordens-Gold anpassen -->
    <set object="ordenshaus" attribute="schatz" dec="15000" />
  </success>
  <failure>
    <p>Es sind keine 15 Gulden in der Schatzkammer.</p>
  </failure>
</has>