Phase 12: Seasons + Weather (rolls, rain, storm, wet/cold)

48-day year (4 seasons × 12 days), daily weather rolls, rain visual,
storm flash, Wet/Cold statuses with mood thoughts.

Three-agent fan-out — Opus prepped contracts up front (event_bus
signals, Clock season constants, Weather autoload stub) so the three
slices could run fully parallel and integrate on first try.

Calendar (Agent A):
- Clock season API — SEASON_SPRING/SUMMER/AUTUMN/WINTER constants,
  current_season(), current_season_index(), day_of_season(),
  current_year(), DAYS_PER_SEASON=12, DAYS_PER_YEAR=48
- EventBus.season_changed emitted on transition (mirrors phase_changed)
- Top-bar SeasonLabel ('Spring 1/12') with localized season names via
  Strings.t() — season.spring/summer/autumn/winter + season.format
- Terrain TileMapLayer seasonal palette modulate
  (spring=warm-green, summer=neutral, autumn=warm-orange, winter=cool-blue)

Weather (Agent B):
- autoload/weather.gd — daily roll triggered by Clock day-index change
  Probability tables per season (placeholders, tune Phase 20):
    spring  60% clear / 35% rain /  5% storm
    summer  75% clear / 18% rain /  7% storm
    autumn  50% clear / 35% rain / 12% storm /  3% cold_snap
    winter  55% clear / 15% rain / 10% storm / 20% cold_snap
- EventBus.weather_changed signal
- scenes/world/rain_overlay.tscn — procedural _draw() diagonal raindrops
  on a CanvasLayer (chosen over CPUParticles2D for pixel-art exactness
  and to colocate storm-flash logic in one weather-aware script)
- Storm flash — Tween-driven ColorRect at random 4-8s intervals
- Save round-trip preserves _last_day_index to prevent double-rolling

Wet + Cold + Mood (Agent C):
- StatusCatalog.wet(severity 1-2) — Damp at 25, Soaked at 60 (of 100)
- StatusCatalog.cold(severity 1-3) — Mild at 25, Severe at 60, Extreme at 85
- ThoughtCatalog.damp(-3), soaked(-6), cold_thought(-4)
- Pawn._wet_accum / _cold_accum floats, ticked in _process_statuses:
  +0.02/tick rain (×2 storm), -0.05/tick decay when sheltered
  +0.015/tick cold winter-or-snap (×2 cold_snap)
- _sync_wet_status / _sync_cold_status — severity-flip detection with
  one Audit line per transition
- _is_sheltered() v1: World.floor_layer.get_cell_source_id != -1
  Phase 13 replaces with proper Room BFS
- _wet_accum / _cold_accum round-trip through Pawn.to_dict / from_dict
- Persistent thought sync in _process_thoughts after in_darkness

MCP runtime verified:
- Top-bar 'Spring 1/12' renders; green seasonal terrain tint visible
- Rain droplets render across screen; storm flash captured mid-animation
- Bram wet=26 (Damp) → wet=65 (Soaked) with mood thought (-6), mood=30
- Cora cold=30 cold_snap → Cold status sev=1 + Cold thought (-4), mood=32
- Daily weather rolls visible day 0-5 (rain → clear → rain → clear → rain)

Quick-edit fixup mid-flight: Variant inference errors on
'var old_sev := s.severity' (untyped Array loop var). Same trap as
the Phase 7 crop fix; pattern is now to always explicit-type ':='
when the rhs is non-typed-Array element access.

Delegation: 3× gdscript-refactor agents in parallel, 1× quick-edit
for the Variant-inference fix; integration + MCP verify on Opus.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
megaproxy 2026-05-11 16:39:34 +01:00
parent 1b6ad2bcc6
commit 92f4e5c945
19 changed files with 692 additions and 19 deletions

View file

@ -6,7 +6,7 @@ class_name StatusCatalog
## it to Pawn.add_status() — add_status() handles severity stack-merging.
##
## Phase 9 ships: bleeding(), downed().
## Phase 12 will add: wet(), cold().
## Phase 12 ships: wet(), cold().
## Phase 17 will add: sick(), infected().
##
## Usage pattern:
@ -14,6 +14,28 @@ class_name StatusCatalog
##
## docs/design.md "Health & status effects"; docs/design.md "Downed & death".
## ── Wet status constants (Phase 12) ─────────────────────────────────────────
## Severity labels: 1 = Damp, 2 = Soaked.
const WET_DAMP_LEVEL: int = 1
const WET_SOAKED_LEVEL: int = 2
## Per-tick accumulator rates for the 0100 Wet scale.
## Storm doubles WET_GAIN_PER_TICK.
const WET_GAIN_PER_TICK: float = 0.02
const WET_DECAY_PER_TICK: float = 0.05
## Accumulator thresholds that flip severity.
const WET_DAMP_THRESHOLD: float = 25.0 ## ≥ 25 → severity 1 (Damp)
const WET_SOAKED_THRESHOLD: float = 60.0 ## ≥ 60 → severity 2 (Soaked)
## ── Cold status constants (Phase 12) ────────────────────────────────────────
## Severity labels: 1 = Cold, 2 = Very Cold, 3 = Freezing.
## Cold activates in winter (Clock.SEASON_WINTER) or during a cold snap (any season).
## Cold snap doubles COLD_GAIN_PER_TICK.
const COLD_GAIN_PER_TICK: float = 0.015
const COLD_DECAY_PER_TICK: float = 0.04
const COLD_MILD_THRESHOLD: float = 25.0 ## ≥ 25 → severity 1
const COLD_SEVERE_THRESHOLD: float = 60.0 ## ≥ 60 → severity 2
const COLD_EXTREME_THRESHOLD: float = 85.0 ## ≥ 85 → severity 3
## Sim ticks before an untreated bleed-out causes death.
## design.md "Downed & death": 6 in-game hours.
## At 20 Hz × 60 s/min × 60 min/hr × 6 hr = 432 000 ticks at 1×.
@ -57,3 +79,33 @@ static func downed() -> Status:
s.max_severity = 1
s.lifetime = Status.Lifetime.PERSISTENT
return s
## Returns a Wet status at the given severity (1 = Damp, 2 = Soaked).
## Severity is clamped to [1, WET_SOAKED_LEVEL]. Lifetime is PERSISTENT —
## cleared (or severity-adjusted) by Pawn._sync_wet_status() based on accumulator.
## The accumulator thresholds WET_DAMP_THRESHOLD / WET_SOAKED_THRESHOLD drive
## which severity the pawn is in; this factory just stamps the initial value.
static func wet(severity: int = WET_DAMP_LEVEL) -> Status:
var s := Status.new()
s.id = &"wet"
s.kind = Status.Kind.WET
s.label = "Wet"
s.severity = clampi(severity, WET_DAMP_LEVEL, WET_SOAKED_LEVEL)
s.max_severity = WET_SOAKED_LEVEL
s.lifetime = Status.Lifetime.PERSISTENT
return s
## Returns a Cold status at the given severity (1 = Cold, 2 = Very Cold, 3 = Freezing).
## Severity is clamped to [1, 3]. Lifetime is PERSISTENT —
## cleared (or severity-adjusted) by Pawn._sync_cold_status() based on accumulator.
static func cold(severity: int = 1) -> Status:
var s := Status.new()
s.id = &"cold"
s.kind = Status.Kind.COLD
s.label = "Cold"
s.severity = clampi(severity, 1, 3)
s.max_severity = 3
s.lifetime = Status.Lifetime.PERSISTENT
return s