BlueGit

timfa questward

Files

questward / shared / combat / rolls.js

rolls.js

rolls.js 2.7 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 * Attack-spell damage roll cap: quarter-scaled Mind plus (spell tier − 1).
25 * Tier 1 adds nothing; tier 5 adds +4 to the Mind cap.
26 */
27export function spellDamageRollLevel (mindEffectiveLevel, spellTier = 1)
28{
29 const base = combatDamageRollLevel(mindEffectiveLevel);
30 const tier = Math.max(1, Math.floor(Number(spellTier) || 1));
31 return Math.max(0, base + tier - 1);
32}
33
34/** Damage roll in [0, spellDamageRollLevel(mind, tier)]. */
35export function rollSpellDamage (mindEffectiveLevel, spellTier, rng = Math.random)
36{
37 return rollSkill(spellDamageRollLevel(mindEffectiveLevel, spellTier), rng);
38}
39
40/**
41 * Melee and ranged physical attack resolution (shared rules).
42 * 1. Roll hit skill vs defender Agility — miss if toHitRoll < agilityRoll
43 * 2. Always roll attacker damage skill (for dodge XP even on miss)
44 * 3. On hit: defender rolls Defence — block if defenceRoll > toHitRoll
45 * 4. On hit and not blocked: apply rolled damage × attack-type affinities
46 */
47export function resolvePhysicalAttack ({
48 hitSkillLevel,
49 agilitySkillLevel,
50 damageSkillLevel,
51 defenceSkillLevel,
52 attackType = null,
53 targetAffinities = {},
54 rng = Math.random
55})
56{
57 const toHitRoll = rollSkill(hitSkillLevel, rng);
58 const agilityRoll = rollSkill(agilitySkillLevel, rng);
59 const damageRoll = rollCombatDamage(damageSkillLevel, rng);
60 if (toHitRoll < agilityRoll)
61 {
62 return {
63 outcome: "miss",
64 toHitRoll,
65 agilityRoll,
66 damageRoll,
67 damage: 0,
68 blocked: false,
69 multiplier: 1
70 };
71 }
72
73 const defenceRoll = rollSkill(defenceSkillLevel, rng);
74 if (defenceRoll > toHitRoll)
75 {
76 return {
77 outcome: "block",
78 toHitRoll,
79 agilityRoll,
80 damageRoll,
81 defenceRoll,
82 damage: 0,
83 blocked: true,
84 multiplier: 1
85 };
86 }
87
88 const multiplier = damageTypeMultiplier(attackType, targetAffinities);
89 const damage = Math.max(0, Math.floor(damageRoll * multiplier));
90
91 return {
92 outcome: "hit",
93 toHitRoll,
94 agilityRoll,
95 damageRoll,
96 defenceRoll,
97 damage,
98 blocked: false,
99 multiplier
100 };
101}