ctan/pf1e-simulator
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(rules): apply the spell combat penalty to the spell attack

Browse Source 
PF1e (CRB Magus Spell Combat): "any attack roll made as part of this
spell also takes this penalty". _execute_spell_combat now threads the -2
through _cast_spell into the melee/ranged touch attack helpers, so e.g.
Shocking Grasp delivered via Spell Combat attacks at -2 too. No global
state is touched: the penalty is a keyword threaded per cast.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
Thien An
2026-09-12 11:14:30 +02:00
parent 068b49794e
commit a9b33e4055
2 changed files with 97 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/pf1e_simulator/combat.py
+45 -15
View File
@@ -4822,7 +4822,9 @@ class CombatEngine:
PF1e (CRB, Magus Spell Combat): as a full-round action the magus casts
a standard-action spell and makes all of his melee attacks at -2. The
penalty rides the full-attack chain to every swing and crit confirm.
penalty rides the full-attack chain to every swing and crit confirm,
and — "any attack roll made as part of this spell also takes this
penalty" — the spell's own melee/ranged touch attack too.
Simplification: the spell may target any resolved enemy (the RAW
spellcasting-as-move restriction and arcane pool cost are not modeled).
"""
@@ -4831,8 +4833,12 @@ class CombatEngine:
if not state.spend_resource("arcane_pool", 1):
# Arcane pool not tracked yet, allow for now
pass
# Cast the spell
self._cast_spell(state, target, spell_name)
# Cast the spell — PF1e (CRB, Magus Spell Combat): "any attack roll
# made as part of this spell also takes this penalty", so the -2 rides
# the spell's touch attack too.
self._cast_spell(
state, target, spell_name, attack_penalty=_SPELL_COMBAT_ATTACK_PENALTY
)
# Then make a full attack at -2 (Spell Combat penalty)
self._execute_attack(
state, target, "full_attack", attack_penalty=_SPELL_COMBAT_ATTACK_PENALTY
@@ -5038,6 +5044,7 @@ class CombatEngine:
center_pos: tuple[int, int] | None = None,
metamagic: tuple[str, ...] = (),
cast_defensively: bool = False,
attack_penalty: int = 0,
) -> ActionResult | None:
"""Cast ``spell_name``.
@@ -5050,8 +5057,11 @@ class CombatEngine:
THIS cast (only feats the caster knows apply, and the spell then
occupies — and must have — a slot of base level + adjustment).
``cast_defensively`` (B24) skips the casting AoO for a concentration
check. Returns an explicit rejection (``no_slot``) when the required
slot is unavailable; None means the cast proceeded through the gates.
check. ``attack_penalty`` folds into this cast's touch attack rolls
(PF1e CRB Magus Spell Combat: "any attack roll made as part of this
spell also takes this penalty"). Returns an explicit rejection
(``no_slot``) when the required slot is unavailable; None means the
cast proceeded through the gates.
"""
spell = self._spell_registry.get(spell_name)
if spell is None:
@@ -5093,7 +5103,9 @@ class CombatEngine:
return None
# PF1e (CRB): hostile touch delivery needs a melee touch attack (B14)
# and spell resistance can still turn the spell away.
if self._spell_delivery_blocked(caster, target, spell, has_area=has_area):
if self._spell_delivery_blocked(
caster, target, spell, has_area=has_area, attack_penalty=attack_penalty
):
return None
self._apply_and_log_cast(
caster, target, spell, spell_name, center_pos,
@@ -5134,16 +5146,20 @@ class CombatEngine:
spell: SpellSpec,
*,
has_area: bool,
attack_penalty: int = 0,
) -> bool:
"""Delivery gates: a hostile touch spell must land its melee touch
attack (B14) and a hostile ranged touch spell (ray) must land its
ranged touch attack, then spell resistance must be overcome. True =
no effect (the slot is already spent)."""
no effect (the slot is already spent). ``attack_penalty`` applies to
both touch rolls (Spell Combat)."""
if (
target is not None
and spell.range == "touch"
and target.side != caster.side
and not self._spell_touch_attack_hits(caster, target)
and not self._spell_touch_attack_hits(
caster, target, attack_penalty=attack_penalty
)
):
return True
if (
@@ -5151,7 +5167,9 @@ class CombatEngine:
and spell.requires_ranged_touch
and not has_area
and target.side != caster.side
and not self._spell_ranged_touch_attack_hits(caster, target)
and not self._spell_ranged_touch_attack_hits(
caster, target, attack_penalty=attack_penalty
)
):
return True
return (
@@ -5161,19 +5179,25 @@ class CombatEngine:
)
def _spell_touch_attack_hits(
self, caster: CombatantState, target: CombatantState
self,
caster: CombatantState,
target: CombatantState,
*,
attack_penalty: int = 0,
) -> bool:
"""Melee touch attack to deliver a touch-range spell (B14).
PF1e (CRB): d20 + caster's melee attack bonus vs the target's touch
AC. Engine simplification (documented): the bonus is BAB + Strength
AC. ``attack_penalty`` folds into the bonus (Spell Combat: "any
attack roll made as part of this spell also takes this penalty").
Engine simplification (documented): the bonus is BAB + Strength
modifier — Weapon Finesse and other situational touch bonuses are
not modeled; natural 20 hits and natural 1 misses per the engine's
attack-roll convention. The touch AC reuses the resolve_attack
denies-Dex path (flat-footed/running target, invisible attacker).
"""
roll = self._rng.d20()
bonus = caster.combatant.bab + caster.combatant.abilities.str_mod
bonus = caster.combatant.bab + caster.combatant.abilities.str_mod + attack_penalty
denies_dex = (
self.has_condition_flag(target, "denies_dex_to_ac")
or target.running
@@ -5192,13 +5216,19 @@ class CombatEngine:
return hit
def _spell_ranged_touch_attack_hits(
self, caster: CombatantState, target: CombatantState
self,
caster: CombatantState,
target: CombatantState,
*,
attack_penalty: int = 0,
) -> bool:
"""Ranged touch attack to deliver a ray spell.
PF1e (CRB, Magic — Ranged Touch Attacks): d20 + caster's ranged attack
bonus vs the target's touch AC; the spell's range is a single absolute
value so there is no range-increment penalty. Engine simplification
value so there is no range-increment penalty. ``attack_penalty`` folds
into the bonus (Spell Combat: "any attack roll made as part of this
spell also takes this penalty"). Engine simplification
(documented): the bonus is BAB + Dexterity modifier — size modifier,
Weapon Finesse and other situational bonuses are not modeled; natural
20 hits and natural 1 misses per the engine's attack-roll convention.
@@ -5206,7 +5236,7 @@ class CombatEngine:
running target, invisible attacker).
"""
roll = self._rng.d20()
bonus = caster.combatant.bab + caster.combatant.abilities.dex_mod
bonus = caster.combatant.bab + caster.combatant.abilities.dex_mod + attack_penalty
denies_dex = (
self.has_condition_flag(target, "denies_dex_to_ac")
or target.running