RollCheck: Unterschied zwischen den Versionen

Aus Sternenschweif Wiki
Wechseln zu: Navigation, Suche
 
(10 dazwischenliegende Versionen von 2 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>
  
Zeile 10: Zeile 11:
  
 
''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 - oder "wskill" für ein Waffentalent
+
''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)
  
'''Ergebnisfelder:'''
+
''cost:'' nur verwendbar bei Zaubern, um die AE-Kosten zu definieren.
  
''id:'' ID des Chars, der die Probe durchgeführt hat (interessant bei "best")
+
''withbe:'' nur verwendbar bei Talenten, false um den (etwaigen) Einfluss von Behinderung zu unterbinden (standard: true)
 
+
''ok:'' Probe gelungen
+
 
+
''notok:'' Probe misslungen
+
 
+
''resrem:'' übrig behaltene TaP* bzw. ZfP*
+
  
 +
'''Ergebnisfelder:'''
  
 +
Ein Objekt vom Typ [[Würfelwurf]]
  
 
'''Beispiel für die Weiterverarbeitung des Ergebnisses:'''
 
'''Beispiel für die Weiterverarbeitung des Ergebnisses:'''

Aktuelle Version vom 17. Januar 2017, 14: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)