BlueGit

timfa questward

Files

questward / shared / combat / rolls.js

rolls.js

rolls.js 2.1 KiB Download Raw
1import { damageTypeMultiplier } from "../definitions/attackTypes.js";
2
3/** Uniform integer roll in [0, skillLevel]. */
4export function rollSkill (skillLevel, rng = Math.random)
5{
6 const max = Math.max(0, Math.floor(Number(skillLevel)) || 0);
7 return Math.floor(rng() * (max + 1));
8}
9
10/** Effective Str/Dex/Mind level used for combat damage rolls (quarter tier, rounded up). */
11export function combatDamageRollLevel (effectiveLevel)
12{
13 const level = Math.max(0, Math.floor(Number(effectiveLevel)) || 0);
14 return Math.max(0, Math.ceil(level / 4));
15}
16
17/** Damage roll in [0, combatDamageRollLevel(effectiveLevel)]. */
18export function rollCombatDamage (effectiveLevel, rng = Math.random)
19{
20 return rollSkill(combatDamageRollLevel(effectiveLevel), rng);
21}
22
23/**
24 * Melee and ranged physical attack resolution (shared rules).
25 * 1. Roll hit skill vs defender Agility — miss if toHitRoll < agilityRoll
26 * 2. Always roll attacker damage skill (for dodge XP even on miss)
27 * 3. On hit: defender rolls Defence — block if defenceRoll > toHitRoll
28 * 4. On hit and not blocked: apply rolled damage × attack-type affinities
29 */
30export function resolvePhysicalAttack ({
31 hitSkillLevel,
32 agilitySkillLevel,
33 damageSkillLevel,
34 defenceSkillLevel,
35 attackType = null,
36 targetAffinities = {},
37 rng = Math.random
38})
39{
40 const toHitRoll = rollSkill(hitSkillLevel, rng);
41 const agilityRoll = rollSkill(agilitySkillLevel, rng);
42 const damageRoll = rollCombatDamage(damageSkillLevel, rng);
43 if (toHitRoll < agilityRoll)
44 {
45 return {
46 outcome: "miss",
47 toHitRoll,
48 agilityRoll,
49 damageRoll,
50 damage: 0,
51 blocked: false,
52 multiplier: 1
53 };
54 }
55
56 const defenceRoll = rollSkill(defenceSkillLevel, rng);
57 if (defenceRoll > toHitRoll)
58 {
59 return {
60 outcome: "block",
61 toHitRoll,
62 agilityRoll,
63 damageRoll,
64 defenceRoll,
65 damage: 0,
66 blocked: true,
67 multiplier: 1
68 };
69 }
70
71 const multiplier = damageTypeMultiplier(attackType, targetAffinities);
72 const damage = Math.max(0, Math.floor(damageRoll * multiplier));
73
74 return {
75 outcome: "hit",
76 toHitRoll,
77 agilityRoll,
78 damageRoll,
79 defenceRoll,
80 damage,
81 blocked: false,
82 multiplier
83 };
84}