GetBest / getWorst: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: „Category:NLTScript Referenz Ermittelt den Besten oder Schlechtesten Charakter der aktuell aktiven Gruppe bei einem bestimmten Attribut, Talent oder Zauber…“) |
|||
| Zeile 4: | Zeile 4: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| − | var result = getBest({"which":"schwerter","type":"skill","queryAll":true}); | + | var result = getBest({"which":"schwerter","type":"skill","queryAll":true,"ignore":3}); |
var raworst = getWorst({"which":"RA"}); | var raworst = getWorst({"which":"RA"}); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Zeile 13: | Zeile 13: | ||
'''which''': Welche Eigenschaft abgefragt werden soll, interne Bezeichnung (siehe skills.xml bzw. Savegame für Attribute)<br> | '''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> | '''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 | + | '''queryAll''': ''(optional)'' true, um auch bewusstlose Charaktere einzubeziehen, Standard false<br> |
| + | '''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== | ==Rückgabewert== | ||
Aktuelle Version vom 14. Juni 2016, 14:34 Uhr
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"});
Inhaltsverzeichnis
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
