GetBest / getWorst

Aus Sternenschweif Wiki
Version vom 14. Juni 2016, 15:34 Uhr von Chrisfirefox (Diskussion | Beiträge)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche


Ermittelt den Besten oder Schlechtesten Charakter der aktuell aktiven Gruppe bei einem bestimmten Attribut, Talent oder Zauberspruch.

var result = getBest({"which":"schwerter","type":"skill","queryAll":true,"ignore":3});
var raworst = getWorst({"which":"RA"});

Parameter

Folgende Parameter sind möglich:

which: Welche Eigenschaft abgefragt werden soll, interne Bezeichnung (siehe skills.xml bzw. Savegame für Attribute)
type: (optional) Auf welchen Typ sich "which" bezieht, möglich sind "skill" (Fertigkeit), "spell" (Zauberspruch) oder "attribute" (Attribut, Standardwert)
queryAll: (optional) true, um auch bewusstlose Charaktere einzubeziehen, Standard false
ignore: (optional welche char-ids von der Prüfung ausgeschlossen werden sollen. Kann entweder eine einzelne Zahl oder ein Array im Format [1,2,3] sein

Rückgabewert

Als Ergebnis gibt es ein Objekt mit folgenden Eigenschaften:

charid: die Charakter-ID innerhalb der Party
shortname: Der Name des Besten/Schlechtesten Charakters
uniqueid: Eindeutige ID des Charakters
which: Der abgefragte Wert
type: Der Typ des abgefragten Werts (Skill/Spell/Attribute)
value: Der tatsächliche Wert

Sollte es ein Problem gegeben haben (zB unbekanntes "which", keine Charaktere verfügbar, zB keine magisch Begabten bei einer Spell-Abfrage), so kommt als "charid" -1 zurück und als "value" -99.

Sonderfälle

Abfrage negative Attribute

Grundsätzlich wird der höchste Wert als der "Best"e interpretiert, der Niedrigste als der Schlechteste. Bei negativen Attributen ist das durch die Regeln umgedreht, d.h. die "best"e Raumangst ist der niedrigste Wert der anwesenden Charaktere, die Schlechteste ist die Höchste.

Abfrage Waffentalente

Es werden die tatsächlichen Talentwerte abgefragt, NICHT die Effektivwerte für Attacke / Parade / Fernkampf