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…“) |
|||
| (10 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}); |
</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. 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. | ||
| + | |||
| + | '''Ergebnisfelder:''' | ||
| + | |||
| + | ''id:'' ID des Chars, der die Probe durchgeführt hat (interessant bei "best") | ||
| + | |||
| + | ''ok:'' Probe gelungen | ||
| + | |||
| + | ''notok:'' Probe misslungen | ||
| + | |||
| + | ''resrem:'' übrig behaltene TaP* bzw. ZfP* | ||
| + | |||
| + | |||
| + | |||
| + | '''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 14. September 2016, 22:16 Uhr
Beispiel:
var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0, "cost":10});
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. 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.
Ergebnisfelder:
id: ID des Chars, der die Probe durchgeführt hat (interessant bei "best")
ok: Probe gelungen
notok: Probe misslungen
resrem: übrig behaltene TaP* bzw. ZfP*
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)
