pf1e-simulator

Files

T

ctan 3cc0502228 feat(rules): add the surprise round

SRD Surprise: when some but not all combatants are aware of their
opponents, a surprise round precedes round 1. Aware combatants take a
single standard OR move action plus free actions (swift and full-round
are dropped, full_attack collapses to one standard attack, withdraw
survives as the Restricted Withdraw standard); unaware combatants skip
their turn. New Combatant.aware flag (default true, parsed at the JSON
boundary) keeps every existing encounter bit-identical, exposed in the
observation snapshot. Unaware combatants are not flagged flat-footed
(documented simplification).

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

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

2026-09-13 13:20:37 +02:00

__init__.py

chore: scaffold pf1e_simulator package (uv, ruff, basedpyright, pytest)

2026-08-17 22:49:50 +02:00

test_abilities.py

chore(lint): restore green gate

2026-09-04 23:02:20 +02:00

test_accuracy_rules.py

fix(rules): avoid the firing-into-melee penalty at 10 feet

2026-09-12 13:21:26 +02:00

test_action_feedback.py

fix(rules): correct P1 PF1e conformance bugs (area saves, concentration, prone, slots, helpless, nauseated)

2026-09-10 20:52:28 +02:00

test_aid_and_run.py

fix(rules): make the run reachability check avoid difficult terrain

2026-09-12 11:53:27 +02:00

test_aoo_budget.py

feat(observation): expose remaining attacks of opportunity

2026-09-10 14:08:25 +02:00

test_aoo_defense.py

fix(rules): treat a blinded attacker as facing total concealment

2026-09-12 13:26:52 +02:00

test_area_shapes.py

fix(rules): exclude the caster from a line spell's area

2026-09-13 11:30:30 +02:00

test_bleeding_confused.py

feat(conditions): add bleeding and confused rules

2026-09-10 18:15:35 +02:00

test_cackle.py

fix(rules): correct the cackle hex

2026-09-12 12:58:32 +02:00

test_charge_result.py

feat(combat): expose charge failure reasons via ChargeResult

2026-09-06 10:47:36 +02:00

test_class_abilities.py

fix(spells): set the correct area shapes

2026-09-13 11:01:07 +02:00

test_cli.py

feat(cli): render --transcript output as a table

2026-09-11 13:02:31 +02:00

test_combat.py

fix(rules): avoid the firing-into-melee penalty at 10 feet

2026-09-12 13:21:26 +02:00

test_combatant_loader.py

chore(lint): restore green gate

2026-09-04 23:02:20 +02:00

test_concentration.py

fix(rules): correct P1 PF1e conformance bugs (area saves, concentration, prone, slots, helpless, nauseated)

2026-09-10 20:52:28 +02:00

test_conditional_modifiers.py

fix(rules): correct P1 PF1e conformance bugs (area saves, concentration, prone, slots, helpless, nauseated)

2026-09-10 20:52:28 +02:00

test_conditions_blinded_invisible.py

fix(rules): treat a blinded attacker as facing total concealment

2026-09-12 13:26:52 +02:00

test_conditions_effects.py

fix(rules): allow a staggered creature to withdraw as a standard action

2026-09-12 14:21:04 +02:00

test_conditions.py

feat(combat): enforce behavioral condition flags

2026-09-04 23:02:16 +02:00

test_conformance_action_economy.py

fix(rules): allow a free weapon draw with a move at BAB +1

2026-09-12 14:35:42 +02:00

test_conformance_cast_time.py

feat(spells): honor spell cast time in the action budget

2026-09-11 14:09:58 +02:00

test_conformance_cover.py

fix(rules): use the attacker's best corner for cover bonus

2026-09-12 14:57:56 +02:00

test_conformance_energy.py

fix(rules): exclude weapon special ability dice from critical multiplication

2026-09-12 11:21:35 +02:00

test_conformance_p1.py

fix(rules): restrict nauseated creatures to a single move action

2026-09-12 09:44:53 +02:00

test_conformance_p2.py

fix(rules): apply the power attack penalty to melee touch attacks

2026-09-11 23:35:07 +02:00

test_conformance_pa.py

fix(rules): scale Power Attack for two-handed weapons and apply its CMB penalty

2026-09-11 00:19:06 +02:00

test_conformance_simple_monster_death.py

feat(cli): add --simple-monster-death option to kill monsters at hp <= 0

2026-09-11 12:48:43 +02:00

test_conformance_spellflow.py

feat(rules): support multi-projectile spells

2026-09-13 12:05:56 +02:00

test_conformance_transcript_table.py

feat(cli): render --transcript output as a table

2026-09-11 13:02:31 +02:00

test_cover_levels.py

feat(combat): support partial and improved cover levels

2026-09-10 11:32:08 +02:00

test_creature_sizes.py

fix(rules): scale the bull rush push distance with the margin

2026-09-12 09:27:03 +02:00

test_damage_scaling.py

feat(rules): scale spell damage with caster level

2026-09-13 10:48:09 +02:00

test_defensive_actions.py

feat(combat): add total defense and fighting defensively

2026-09-10 12:52:47 +02:00

test_delay_action.py

fix(rules): stop delay from double-processing the turn start

2026-09-11 21:15:14 +02:00

test_determinism.py

fix(combat): channel energy targets living vs undead

2026-09-05 00:16:17 +02:00

test_dice.py

feat(combat): expose weapon reference in observation snapshot

2026-09-06 13:46:12 +02:00

test_direction.py

fix(rules): correct P2/P3 PF1e conformance bugs (flanking, touch, blinded, disabled, death, maneuvers, DR, sneak)

2026-09-10 21:45:50 +02:00

test_dirty_trick.py

fix(rules): scale dirty trick duration and drop nauseated

2026-09-12 11:34:20 +02:00

test_dying_and_crits.py

fix(rules): stabilize a dying creature when healed

2026-09-12 10:35:44 +02:00

test_effects.py

feat(effects): add effect system with PF1e bonus stacking rules

2026-08-17 22:49:50 +02:00

test_elevation.py

feat(grid): apply elevation to movement cost and high ground

2026-09-05 16:18:56 +02:00

test_engine_fixes.py

feat(combat): add activate_power_attack action and consume Up Close and Deadly deed

2026-09-06 18:37:58 +02:00

test_exposed_squares.py

fix(rules): distinguish natural reach from reach weapons

2026-09-11 22:06:46 +02:00

test_feats.py

feat(data): wire all 55 PC feats

2026-09-04 23:02:25 +02:00

test_fly_speed.py

feat(combat): use fly speed for movement

2026-09-10 17:46:57 +02:00

test_foundry_extraction.py

feat(loaders): extend Foundry loader with feat/spell extraction

2026-08-17 22:49:50 +02:00

test_foundry_loader.py

test(foundry): point golden tests at renamed sheet files

2026-08-17 22:49:50 +02:00

test_grid.py

feat(runner): Monte Carlo runner, closed-form metrics and balance CLI

2026-08-17 22:49:50 +02:00

test_hex_aoe_dr.py

feat(rules): scale spell damage with caster level

2026-09-13 10:48:09 +02:00

test_immediate_actions.py

fix(rules): block immediate actions while flat-footed

2026-09-12 14:08:44 +02:00

test_initiative_observation.py

feat(observation): expose initiative order and totals

2026-09-10 12:04:10 +02:00

test_lich.py

fix(data): lich fear aura, paralyzing touch, slot keys

2026-09-04 23:02:26 +02:00

test_llm_engine_capabilities.py

test(llm): demonstrate unblocked engine capabilities via observation-only policy

2026-09-10 15:56:21 +02:00

test_los.py

feat(combat): grant soft cover (+4 AC) to ranged attacks through creatures

2026-08-17 22:49:50 +02:00

test_maneuvers.py

fix(rules): require adjacency or pull the target when grappling

2026-09-12 14:45:55 +02:00

test_map.py

feat(grid): apply elevation to movement cost and high ground

2026-09-05 16:18:56 +02:00

test_models.py

feat(models): combatant schema, Foundry sheet loader, monster JSON schema

2026-08-17 22:49:50 +02:00

test_monster_loader.py

fix(rules): distinguish natural reach from reach weapons

2026-09-11 22:06:46 +02:00

test_move_destination.py

fix(rules): stop auto-directed movement cutting corners

2026-09-12 10:48:12 +02:00

test_multi_natural_weapons.py

feat(combat): resolve all natural melee weapons in full_attack

2026-09-06 10:22:58 +02:00

test_multi_projectile.py

feat(rules): support multi-projectile spells

2026-09-13 12:05:56 +02:00

test_observation_enriched.py

fix(rules): distinguish natural reach from reach weapons

2026-09-11 22:06:46 +02:00

test_observation.py

feat(combat): add serializable Observation snapshot and LLMPolicy adapter

2026-09-06 11:07:30 +02:00

test_pair_cover.py

fix(rules): distinguish natural reach from reach weapons

2026-09-11 22:06:46 +02:00

test_pair_failure_reasons.py

feat(observation): expose attack failure reasons

2026-09-10 13:57:34 +02:00

test_pc_combat_golden.py

feat(rules): support multi-projectile spells

2026-09-13 12:05:56 +02:00

test_point_targeting.py

fix(rules): correct P1 PF1e conformance bugs (area saves, concentration, prone, slots, helpless, nauseated)

2026-09-10 20:52:28 +02:00

test_power_attack.py

chore(lint): restore green gate

2026-09-04 23:02:20 +02:00

test_prone_actions.py

fix(rules): correct P2/P3 PF1e conformance bugs (flanking, touch, blinded, disabled, death, maneuvers, DR, sneak)

2026-09-10 21:45:50 +02:00

test_ranged_threat.py

fix(rules): correct P2/P3 PF1e conformance bugs (flanking, touch, blinded, disabled, death, maneuvers, DR, sneak)

2026-09-10 21:45:50 +02:00

test_reach.py

fix(rules): distinguish natural reach from reach weapons

2026-09-11 22:06:46 +02:00

test_ready_action.py

fix(rules): expire a readied action at the combatant's next turn

2026-09-12 13:59:11 +02:00

test_recurring_damage.py

feat(rules): add ongoing spell damage

2026-09-13 12:25:38 +02:00

test_repair_weapon.py

fix(rules): correct P2/P3 PF1e conformance bugs (flanking, touch, blinded, disabled, death, maneuvers, DR, sneak)

2026-09-10 21:45:50 +02:00

test_retrieve_weapon.py

fix(rules): allow a free weapon draw with a move at BAB +1

2026-09-12 14:35:42 +02:00

test_rng.py

feat(dice): seeded RNG protocol and dice notation parser

2026-08-17 22:49:50 +02:00

test_runner_spells.py

data(spells): add batch 3 of PC spell list (32 spells)

2026-09-10 19:43:07 +02:00

test_runner.py

feat(runner): Monte Carlo runner, closed-form metrics and balance CLI

2026-08-17 22:49:50 +02:00

test_saves.py

feat(combat): add saving throws (fort/ref/will, natural 1/20, effect modifiers)

2026-08-17 22:49:50 +02:00

test_size_is_baked_in.py

test(rules): lock in that size is baked into attack/AC values

2026-09-10 17:25:05 +02:00

test_smoke.py

chore: scaffold pf1e_simulator package (uv, ruff, basedpyright, pytest)

2026-08-17 22:49:50 +02:00

test_spell_area_snapshot.py

feat(observation): expose spell cast time in the snapshot

2026-09-11 14:13:13 +02:00

test_spell_registry_batch1.py

fix(spells): make the bleed spell bleed

2026-09-12 12:46:53 +02:00

test_spell_registry_batch2.py

data(spells): add batch 3 of PC spell list (32 spells)

2026-09-10 19:43:07 +02:00

test_spell_registry_batch3.py

data(spells): add batch 3 of PC spell list (32 spells)

2026-09-10 19:43:07 +02:00

test_spell_resistance.py

feat(spells): allow spells to ignore spell resistance

2026-09-13 12:44:35 +02:00

test_spells.py

fix(spells): apply a shaken effect when a fear save succeeds

2026-09-13 12:32:45 +02:00

test_summoning.py

fix(combat): summon spawns only on passable cells

2026-09-04 23:02:27 +02:00

test_surprise_round.py

feat(rules): add the surprise round

2026-09-13 13:20:37 +02:00

test_touch_ac.py

fix(combat): resolve touch attacks against touch AC and firearms

2026-09-05 11:28:46 +02:00

test_weapon_selection.py

feat(combat): allow selecting the attacking weapon

2026-09-10 13:36:27 +02:00