Files
ashlar/docs/DEVLOG.md
T
2026-11-13 16:09:31 -05:00

5.2 KiB

Ashlar devlog

Newest entries first. The ashlar-build scheduled task and interactive sessions both append here.

2026-11-13 (afternoon run)

  • Waited about 35 minutes for the project lock (held by vitals-build), then a few more for host memory to reach 4 GB before building.
  • #21 stamina-driven attacks, 28d5d076a0. With real time combat on, the attack's fatigue cost is paid in prepareHit, when the swing is released (melee, ranged and thrown), and applyFatigueLoss no longer charges on the hit. The base cost scales from half at no wind-up to full at full wind-up; the weapon part keeps the classic weight * strength * fWeaponFatigueMult. New [Game] attack fatigue threshold (0.1): no weapon attack starts below it or at zero fatigue. The player gets "You are too tired to attack." once per press, and combat AI doesn't wind up until fatigue recovers. New [Game] attack fatigue cap (0.5): below it, the strongest attack falls linearly to 0.25 strength at zero fatigue. The rules are in mwmechanics/stamina.cpp.
  • Decisions: spells and lockpicks are exempt, and god mode skips the rules. The message is hard-coded English, because no GMST fits; localize it with the Lua UI work. mAttackWindUp keeps the uncapped wind-up and only mAttackStrength is capped.
  • Tests: build OK, components-tests 1636 passed, openmw-tests 589 passed (11 new). The headless boot is clean. Not exercised end to end; the Game Template has no hostile melee actor (#24). Feel and the default values need Eric's playtest.
  • Next: #24 headless combat test content, which makes #19 to #22 checkable without a playtest, then #22 hit reactions.

2026-11-13

  • Waited about an hour for the project lock (held by vitals-build).
  • An interactive session on 11-12 had already added weapon parries and the raised-shield pose (78f1f9516d, #23 awaiting Eric's look).
  • #20 NPC and creature blocking, 4e152c7c4e. New [Game] ai active blocking setting, on by default, used with real time combat. NPCs and creatures use the player's stance and arc rules and get no roll. Combat AI raises the stance when an enemy in front of it winds up a melee attack within 1.5x reach. It rolls once per wind-up (10% to 90% by Block skill plus a fifth of agility, times fatigue), reacts in 0.6 to 0.15 s, holds 0.5 s after the wind-up, caps a block at 2 s with a 1 s retry pause, and doesn't attack while blocking. The logic is in mwmechanics/aiblock.cpp.
  • Decision: AI blocks use a separate, unsaved CreatureStats::mAiBlockHeld that Actors clears every frame before AI runs. A block then can't outlive the combat package, and Lua block requests aren't overwritten.
  • Tests: build OK, components-tests 1636 passed, openmw-tests 578 passed (12 new). The headless boot is clean. No NPC block happened in a run, because the Game Template has no shields or hostile melee actors. Opened #24 for CC0 headless combat test content.
  • Next: #21 stamina-driven attacks, or #24 first if it's quick. It would make #19 to #22 testable without a playtest.

2026-11-12 (afternoon run)

  • #19 player active blocking, 9be251af0a. With real time combat on, the player holds the new Block action (engine action 51, Lua input.ACTION.Block and self.controls.block; defaults are middle mouse and D-pad down) to raise a block stance. It needs a shield and a drawn weapon. In the stance, no attacks start, movement drops to [Game] block stance speed (0.5), and melee hits inside the block arc are always blocked. Fatigue cost falls with Block skill, to half at 100. Without the stance the player doesn't block. NPCs and creatures keep the roll until #20. The rules are in mwmechanics/activeblock.cpp.
  • Decision: the stance is stored as a transient CreatureStats::mBlockHeld (not saved), so #20 can set it for NPCs through the same Lua control. Lua doesn't suppress Use itself; the engine refuses to start attacks in the stance, so behavior with the setting off is unchanged.
  • Tests: build OK, components-tests 1636 passed, openmw-tests 564 passed (6 new). The headless boot is clean, and input_v3.xml gets the new defaults. A blocked hit wasn't exercised end to end, because the Game Template has no shield or hostile melee actor. That needs test content or Eric's playtest, as does feel.
  • Opened #23 for a visible raised-shield pose while in the stance.
  • If upstream adds an action 51, renumber A_Block when rebasing.
  • Next: #20 NPC and creature blocking. Consider writing small CC0 test content (a shield and a hostile melee NPC) so blocks can be verified headlessly.

2026-11-12

  • #3 performance baseline: added docker/ashlar-bench.sh and scripts/ashlar_bench_summary.py. The GPU run uses SDL's offscreen driver with NVIDIA EGL, so it is headless. Baseline on the RTX 5060 Ti at 1080p: about 624 mean FPS and 283 1% low over three 60-second runs, within 2%. The method and numbers are in docs/ashlar/BENCHMARK.md.
  • Build and both unit test suites pass (558 tests).
  • #4 CI is still blocked on the shared runner (DevOps/software-infrastructure#58).
  • Split #5 into #19 player active blocking, #20 NPC and creature blocking, #21 stamina-driven attacks and #22 hit reactions.
  • Next: #19.