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}"/>