RollCheck: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: „Beispiel: <syntaxhighlight lang="javascript"> var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0}); </syntaxhighlight> Das Ergebn…“) |
|||
| (14 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| + | [[Category:NLTScript Referenz]] | ||
Beispiel: | Beispiel: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| − | var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0}); | + | var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0, "cost":10, "withbe": false}); |
</syntaxhighlight> | </syntaxhighlight> | ||
Das Ergebnis der Funktion wird in die Variable "res" geschrieben. Für den Aufruf werden folgende Parameter übergeben: | Das Ergebnis der Funktion wird in die Variable "res" geschrieben. Für den Aufruf werden folgende Parameter übergeben: | ||
| − | which: Talent/Zauber, auf den die Probe abgelegt werden soll (wie in skills.xml definiert) | + | ''which:'' Talent/Zauber, auf das/den die Probe abgelegt werden soll (wie in skills.xml definiert) |
| − | who: die ID des Chars, der die Probe ablegen soll. Der 1. Char hat die ID 0, der 6. Char die ID 5. | + | ''who:'' die ID des Chars, der die Probe ablegen soll. Der 1. Char hat die ID 0, der 6. Char die ID 5. |
| − | Beim Parameter "best" wird automatisch der beste Char für die Probe ausgewählt. Achtung: "best" funktioniert nicht bei Zaubern. | + | Beim Parameter "best" wird automatisch der beste Char für die Probe ausgewählt, je nach "withbe"-Parameter auch unter Berücksichtigung der Behinderung. Achtung: "best" funktioniert nicht bei Zaubern. |
| − | type: "skill" oder "spell" - ist wohl selbsterklärend | + | ''type:'' "skill" oder "spell" - ist wohl selbsterklärend - oder "wskill" für ein Waffentalent, oder "attrib" für ein Attribut |
| − | mod: eine mögliche Probenerschwernis oder -erleichterung (optional) | + | ''mod:'' eine mögliche Probenerschwernis oder -erleichterung, negative Zahlen erschweren, positive erleichtern (optional) |
| + | |||
| + | ''cost:'' nur verwendbar bei Zaubern, um die AE-Kosten zu definieren. | ||
| + | |||
| + | ''withbe:'' nur verwendbar bei Talenten, false um den (etwaigen) Einfluss von Behinderung zu unterbinden (standard: true) | ||
| + | |||
| + | '''Ergebnisfelder:''' | ||
| + | |||
| + | Ein Objekt vom Typ [[Würfelwurf]] | ||
| + | |||
| + | '''Beispiel für die Weiterverarbeitung des Ergebnisses:''' | ||
| + | |||
| + | <syntaxhighlight lang="javascript"> | ||
| + | |||
| + | if (res && res.ok) return 3; | ||
| + | </syntaxhighlight> | ||
| + | Wenn es ein Resultat gibt (wenn der Char nicht handlungsfähig ist, gibt es nämlich kein Resultat) UND die Probe gelungen ist, wird zu ID 3 verzweigt. | ||
| + | |||
| + | <syntaxhighlight lang="javascript"> | ||
| + | |||
| + | if (res && res.notok) return 4; | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | Bei Misslingen der Probe wird zu ID 4 verzweigt. | ||
| + | |||
| + | <syntaxhighlight lang="javascript"> | ||
| + | |||
| + | if (res && res.ok && res.resrem > 4) return 5; | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | Wenn die Probe gelungen ist und mehr als 4 TaP* übrig behalten wurden, wird zu ID 5 verzweigt. | ||
| + | |||
| + | |||
| + | --lunatic 15:46, 12. Mär. 2014 (CET) | ||
Aktuelle Version vom 17. Januar 2017, 15:51 Uhr
Beispiel:
var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0, "cost":10, "withbe": false});
Das Ergebnis der Funktion wird in die Variable "res" geschrieben. Für den Aufruf werden folgende Parameter übergeben:
which: Talent/Zauber, auf das/den die Probe abgelegt werden soll (wie in skills.xml definiert)
who: die ID des Chars, der die Probe ablegen soll. Der 1. Char hat die ID 0, der 6. Char die ID 5. Beim Parameter "best" wird automatisch der beste Char für die Probe ausgewählt, je nach "withbe"-Parameter auch unter Berücksichtigung der Behinderung. Achtung: "best" funktioniert nicht bei Zaubern.
type: "skill" oder "spell" - ist wohl selbsterklärend - oder "wskill" für ein Waffentalent, oder "attrib" für ein Attribut
mod: eine mögliche Probenerschwernis oder -erleichterung, negative Zahlen erschweren, positive erleichtern (optional)
cost: nur verwendbar bei Zaubern, um die AE-Kosten zu definieren.
withbe: nur verwendbar bei Talenten, false um den (etwaigen) Einfluss von Behinderung zu unterbinden (standard: true)
Ergebnisfelder:
Ein Objekt vom Typ Würfelwurf
Beispiel für die Weiterverarbeitung des Ergebnisses:
if (res && res.ok) return 3;
Wenn es ein Resultat gibt (wenn der Char nicht handlungsfähig ist, gibt es nämlich kein Resultat) UND die Probe gelungen ist, wird zu ID 3 verzweigt.
if (res && res.notok) return 4;
Bei Misslingen der Probe wird zu ID 4 verzweigt.
if (res && res.ok && res.resrem > 4) return 5;
Wenn die Probe gelungen ist und mehr als 4 TaP* übrig behalten wurden, wird zu ID 5 verzweigt.
--lunatic 15:46, 12. Mär. 2014 (CET)
