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…“) |
|||
| Zeile 7: | Zeile 7: | ||
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 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 |
| − | mod: eine mögliche Probenerschwernis oder -erleichterung (optional) | + | ''mod:'' eine mögliche Probenerschwernis oder -erleichterung (optional) |
| + | |||
| + | '''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* übrige behalten wurden, wird zu ID 5 verzweigt. | ||
Version vom 12. März 2014, 09:27 Uhr
Beispiel:
var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0});
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)
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
mod: eine mögliche Probenerschwernis oder -erleichterung (optional)
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* übrige behalten wurden, wird zu ID 5 verzweigt.
