ChooseItem

chooseItem({"action":action, "callback":callback, "desc1":"", "desc2":"", "needchar":false, "showequipped":false, "itemon":null, "itemtype":null});

Ruft den Wähle-ein-Item-Dialog auf, und liefert das gewählte Item zurück.

action: Textuelle Beschreibung des Vorgangs, also zB "Wähle Waffe, die vergiftet werden soll"

callback: Name der Callback-Javascript-Funktion. Diese hat das folgende Format:

function callback_receiver( itemid, itembezeichnung, characterid )

Alle nachfolgenden Parameter sind optional

desc1, desc2: Zwei Beschreibungstexte für die Aktion, die unterhalb der Hauptbeschreibung eingeblendet werden können

needchar: Ob auch die Auswahl eines Charakters angezeigt werden soll

showequipped: Ob nur ausgerüstete (true) oder nur nicht ausgerüstete (false) Gegenstände angezeigt werden sollen

itemon: wenn gesetzt, filtert es das Inventar nach Items, die eine bestimmte "on"-Eigenschaft haben (zB "applypoison", um nur vergiftbare Waffen anzuzeigen)

itemtype: wenn gesetzt (nur in Kombination mit "on"), werden Items gefiltert, die eine bestimmte "Type"-Eigenschaft auch noch haben (zB on "carry" type "checkbonusap")

Intern wird "chosenItem" gespeichert, aus dem auch noch aktueller Träger, aktueller Slot usw. Abgelesen werden könnten, das ist allerdings noch nicht "exposed". Einzig mittels removeChosenItem kann derzeit auf diesen Datensatz zugegriffen werden.