Item: Unterschied zwischen den Versionen
Aidan (Diskussion | Beiträge) K (alten Code und Beispiel entfernt, bringt im Endeffekt mehr Arbeit und Aufwand als Nutzen) |
Aidan (Diskussion | Beiträge) K (Änderung 72219 von Aidan (Diskussion) rückgängig gemacht.) |
||
Zeile 1: | Zeile 1: | ||
+ | Der Item-Tag liefert den Namen eines mehr oder weniger zufällig aus der DB ausgelesenen Items. | ||
+ | |||
+ | ==Syntax== | ||
+ | <code xml n> | ||
+ | # entweder | ||
+ | <item freq="" [must="" mustnot="" cost_min="" cost_max="" name=""] /> | ||
+ | # ODER | ||
+ | <item tag="" [cost_min="" cost_max=""] /> | ||
+ | </code> | ||
+ | |||
+ | Parameter: | ||
+ | *'''freq''' wie oft kommt der Gegenstand vor (oft/selten/rar) | ||
+ | *'''cost_min''' (optional) Muss mindestens dies kosten | ||
+ | *'''cost_max''' (optional) Darf höchstens dies kosten | ||
+ | *'''must''' (optional) [[#Eigenschaften|Eigenschaften]] die der Gegenstand haben MUSS (getrennt per |) | ||
+ | *'''mustnot''' (optional) [[#Eigenschaften|Eigenschaften]] die der Gegenstand NICHT haben darf (getrennt per |) | ||
+ | Kommt eine Eigenschaft weder in ''must'' noch in ''mustnot'' vor ist sie beliebig. | ||
+ | |||
+ | *'''name''' (optional) Wenn gesetzt, wird der Name des Gegenstandes nicht ausgegeben sondern in der angegebenen Variable gespeichert. (ACHTUNG: das ist inkonsquent und wird geändert) | ||
+ | *'''tag''' (optional) Wenn angegeben, wird eine Ware auf Basis des [[Waren-Tags]] geholt. Diese Option ist nur mit den Attributen ''cost_min'' und ''cost_max'' kombinierbar. | ||
+ | |||
+ | |||
+ | ==Beispiele== | ||
+ | |||
+ | ===Item erzeugen auf Basis von spezifizierten Eigenschaften=== | ||
+ | <code xml n><item freq="oft" must="werkzeug" mustnot="magisch|daemon|geweiht|exotisch" cost_max="100" /></code> | ||
+ | |||
+ | Liefert ein weit verbreitetes Werkzeug das nicht magisch, daemonisch, geweiht oder exotisch ist und weniger als 100 wert ist | ||
+ | |||
+ | Beispielsweise: Flickzeug oder Knüppel oder Steinernes Messer oder Handbohrer | ||
+ | |||
+ | |||
+ | Um dem Held jenes zu geben: | ||
+ | <code xml n> | ||
+ | <store name="zufallsding"><item freq="oft" must="werkzeug" mustnot="magisch|daemon|geweiht|exotisch" cost_max="100" /></store> | ||
+ | |||
+ | <take item="${zufallsding}"/> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | |||
+ | ====Erlaubte Ausprägungen für 'must' und 'mustnot'==== | ||
+ | Liste der möglichen Eigenschaften | ||
+ | |||
+ | *magisch | ||
+ | *geweiht | ||
+ | *daemon | ||
+ | *transportmittel | ||
+ | *exotisch | ||
+ | *wertgegenstand | ||
+ | *lebendig | ||
+ | *kunst | ||
+ | *werkzeug | ||
+ | *handwerk | ||
+ | *spielbar | ||
+ | *lesbar | ||
+ | *natur | ||
+ | *medizinisch | ||
+ | *tragbar | ||
+ | *meeresbezogen | ||
+ | *pulver | ||
+ | |||
+ | |||
===Item erzeugen auf Basis eines Waren-Tags=== | ===Item erzeugen auf Basis eines Waren-Tags=== | ||
Version vom 29. August 2012, 11:11 Uhr
Der Item-Tag liefert den Namen eines mehr oder weniger zufällig aus der DB ausgelesenen Items.
Inhaltsverzeichnis
Syntax
# entweder
<item freq="" [must="" mustnot="" cost_min="" cost_max="" name=""] />
# ODER
<item tag="" [cost_min="" cost_max=""] />
Parameter:
- freq wie oft kommt der Gegenstand vor (oft/selten/rar)
- cost_min (optional) Muss mindestens dies kosten
- cost_max (optional) Darf höchstens dies kosten
- must (optional) Eigenschaften die der Gegenstand haben MUSS (getrennt per |)
- mustnot (optional) Eigenschaften die der Gegenstand NICHT haben darf (getrennt per |)
Kommt eine Eigenschaft weder in must noch in mustnot vor ist sie beliebig.
- name (optional) Wenn gesetzt, wird der Name des Gegenstandes nicht ausgegeben sondern in der angegebenen Variable gespeichert. (ACHTUNG: das ist inkonsquent und wird geändert)
- tag (optional) Wenn angegeben, wird eine Ware auf Basis des Waren-Tags geholt. Diese Option ist nur mit den Attributen cost_min und cost_max kombinierbar.
Beispiele
Item erzeugen auf Basis von spezifizierten Eigenschaften
<item freq="oft" must="werkzeug" mustnot="magisch|daemon|geweiht|exotisch" cost_max="100" />
Liefert ein weit verbreitetes Werkzeug das nicht magisch, daemonisch, geweiht oder exotisch ist und weniger als 100 wert ist
Beispielsweise: Flickzeug oder Knüppel oder Steinernes Messer oder Handbohrer
Um dem Held jenes zu geben:
<store name="zufallsding"><item freq="oft" must="werkzeug" mustnot="magisch|daemon|geweiht|exotisch" cost_max="100" /></store>
<take item="${zufallsding}"/>
Erlaubte Ausprägungen für 'must' und 'mustnot'
Liste der möglichen Eigenschaften
- magisch
- geweiht
- daemon
- transportmittel
- exotisch
- wertgegenstand
- lebendig
- kunst
- werkzeug
- handwerk
- spielbar
- lesbar
- natur
- medizinisch
- tragbar
- meeresbezogen
- pulver
Item erzeugen auf Basis eines Waren-Tags
Die Liste der gepflegten Waren-Tags gibt es auf der Seite: Waren-Tags
Folgender Code liefert einen zufälligen Alkohol:
<item tag="Alkohol"/>
Möchte man die Auswahl etwas eingrenzen, kann man einen Mindestpreis (cost_min) und/oder Maximalpreis (cost_max) angeben. Die Angabe erfolgt in Groschen.
<item tag="Alkohol" cost_max="300"/><!-- liefert einen zufälligen Alkohol, der höchstens 3 Gulden Wert ist -->
Um einen zufälligen Alkohol dem Held zu geben:
<store name="zufallsding"><item tag="Alkohol" /></store>
<take item="${zufallsding}"/>