Item: Unterschied zwischen den Versionen

Aus AntamarWiki
Wechseln zu: Navigation, Suche
K (alten Code und Beispiel entfernt, bringt im Endeffekt mehr Arbeit und Aufwand als Nutzen)
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, 12:11 Uhr

Der Item-Tag liefert den Namen eines mehr oder weniger zufällig aus der DB ausgelesenen Items.

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