Quelltext der Seite GetBest / getWorst

[[Category:NLTScript Referenz]]

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

<syntaxhighlight lang="javascript">
var result = getBest({"which":"schwerter","type":"skill","queryAll":true});
var raworst = getWorst({"which":"RA"});
</syntaxhighlight>

==Parameter==
Folgende Parameter sind möglich:

'''which''': Welche Eigenschaft abgefragt werden soll, interne Bezeichnung (siehe skills.xml bzw. Savegame für Attribute)<br>
'''type''': ''(optional)'' Auf welchen Typ sich "which" bezieht, möglich sind "skill" (Fertigkeit), "spell" (Zauberspruch) oder "attribute" (Attribut, Standardwert)<br>
'''queryAll''': ''(optional)'' true, um auch bewusstlose Charaktere einzubeziehen, Standard false

==Rückgabewert==
Als Ergebnis gibt es ein Objekt mit folgenden Eigenschaften:

'''charid''': die Charakter-ID innerhalb der Party<br>
'''shortname''': Der Name des Besten/Schlechtesten Charakters<br>
'''uniqueid''': Eindeutige ID des Charakters<br>
'''which''': Der abgefragte Wert<br>
'''type''': Der Typ des abgefragten Werts (Skill/Spell/Attribute)<br>
'''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