Sample outdoor weather from the climate preset so people can freeze and the clock can show it.

Protocol v8 adds tenths of a °C and precipitation to the clock frame; warmth drains from insulation versus place temperature. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-20 03:49:40 +03:00
parent d8f4958167
commit 8e7ab46e79
40 changed files with 1008 additions and 39 deletions
@@ -0,0 +1,26 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import { Precipitation } from '../net/protocol.ts';
+import { getLocale, setLocale } from '../i18n/locale.ts';
+import { formatTemperatureC, formatWeather } from './weather.ts';
+
+const initial = getLocale();
+
+afterEach(() => setLocale(initial));
+
+describe('formatWeather', () => {
+  it('draws tenths and snow from the frame, not from the month', () => {
+    setLocale('ru');
+    expect(formatTemperatureC(-50)).toBe('\u22125');
+    expect(formatWeather(-50, Precipitation.Snow)).toBe('\u22125 °C, снег');
+  });
+
+  it('omits precipitation when the street is dry', () => {
+    setLocale('ru');
+    expect(formatWeather(82, Precipitation.None)).toBe('8.2 °C');
+  });
+
+  it('uses English rain labels', () => {
+    setLocale('en');
+    expect(formatWeather(40, Precipitation.Rain)).toBe('4 °C, rain');
+  });
+});
@@ -0,0 +1,23 @@
+import { Precipitation } from '../net/protocol.ts';
+import { t } from '../i18n/strings.ts';
+
+/** Formats tenths of a °C as the clock shows them. Does not invent weather from the date. */
+export function formatTemperatureC(tenths: number): string {
+  const value = tenths / 10;
+  const abs = Math.abs(value);
+  const body = Number.isInteger(value) ? String(abs) : abs.toFixed(1);
+  return `${value < 0 ? '\u2212' : ''}${body}`;
+}
+
+export function formatWeather(tenths: number, precipitation: number): string {
+  const temp = formatTemperatureC(tenths);
+  if (precipitation === Precipitation.Snow) {
+    return t('weatherPrecip', { temp, precip: t('precipSnow') });
+  }
+
+  if (precipitation === Precipitation.Rain) {
+    return t('weatherPrecip', { temp, precip: t('precipRain') });
+  }
+
+  return t('weatherClear', { temp });
+}
@@ -28,6 +28,7 @@ describe('t', () => {
      .toBe('Начальные классы (1–4) — 3 short');
    expect(t('mapOccupancy', { name: 'Кабинет 204', activity: 'Математика · 5Б' }))
      .toBe('Кабинет 204 (Математика · 5Б)');
+    expect(t('weatherPrecip', { temp: '\u22125', precip: t('precipSnow') })).toBe('\u22125 °C, snow');
    expect(t('mapHeadcount', { name: 'Коридор', count: 12 })).toBe('Коридор (12)');
    expect(t('mapHeadcountActivity', { name: 'Класс 101', count: 18, activity: 'Математика · 5А' }))
      .toBe('Класс 101 (18 · Математика · 5А)');
@@ -191,6 +191,10 @@ const ru = {
  mapHeadcount: '{name} ({count})',
  mapHeadcountActivity: '{name} ({count} · {activity})',
  skipTo: 'Пропустить до {date}',
+  weatherClear: '{temp} °C',
+  weatherPrecip: '{temp} °C, {precip}',
+  precipRain: 'дождь',
+  precipSnow: 'снег',
  presenceAt: '{name}',
  presenceWalking: 'в пути ({name})',
  presenceAway: 'вне школы',
@@ -408,6 +412,10 @@ const en: Messages = {
  mapHeadcount: '{name} ({count})',
  mapHeadcountActivity: '{name} ({count} · {activity})',
  skipTo: 'Skip to {date}',
+  weatherClear: '{temp} °C',
+  weatherPrecip: '{temp} °C, {precip}',
+  precipRain: 'rain',
+  precipSnow: 'snow',
  presenceAt: '{name}',
  presenceWalking: 'walking ({name})',
  presenceAway: 'off campus',
@@ -98,7 +98,7 @@ describe('decodeServerMessage', () => {
    // 2012-04-03T06:00:00Z → skip to 2012-04-04T06:00:00Z
    const gameTimeMs = Date.UTC(2012, 3, 3, 6, 0, 0);
    const skipTargetMs = Date.UTC(2012, 3, 4, 6, 0, 0);
-    const buffer = new ArrayBuffer(24);
+    const buffer = new ArrayBuffer(27);
    const view = new DataView(buffer);
    view.setUint8(0, MessageType.ServerClock);
    view.setInt32(1, 7, true);
@@ -107,6 +107,8 @@ describe('decodeServerMessage', () => {
    view.setUint8(14, 2);
    view.setUint8(15, 1);
    view.setBigInt64(16, BigInt(skipTargetMs), true);
+    view.setInt16(24, -50, true);
+    view.setUint8(26, 2);

    expect(decodeServerMessage(buffer)).toEqual({
      type: 'clock',
@@ -116,6 +118,8 @@ describe('decodeServerMessage', () => {
      speedIndex: 2,
      skipAllowed: true,
      skipTarget: new Date(skipTargetMs),
+      temperatureTenths: -50,
+      precipitation: 2,
    });
  });

@@ -5,7 +5,7 @@
 * changed together and documented in `docs/protocol.md`. All numbers are little-endian.
 */

-export const PROTOCOL_VERSION = 7;
+export const PROTOCOL_VERSION = 8;

 export const MessageType = {
  ClientHello: 0x01,
@@ -50,6 +50,12 @@ export interface PongMessage {
  readonly serverTick: number;
 }

+export const Precipitation = {
+  None: 0,
+  Rain: 1,
+  Snow: 2,
+} as const;
+
 export interface ClockMessage {
  readonly type: 'clock';
  readonly schoolId: number;
@@ -61,6 +67,10 @@ export interface ClockMessage {
  readonly skipAllowed: boolean;
  /** UTC instant the skip would land on; null when skip is refused. */
  readonly skipTarget: Date | null;
+  /** Outdoor temperature in tenths of a °C. */
+  readonly temperatureTenths: number;
+  /** `Precipitation.None` / `Rain` / `Snow`. */
+  readonly precipitation: number;
 }

 export interface SchoolGoneMessage {
@@ -248,7 +258,7 @@ function decodePong(view: DataView): PongMessage {
 }

 function decodeClock(view: DataView): ClockMessage {
-  ensure(view, 24);
+  ensure(view, 27);
  const skipTargetMs = Number(view.getBigInt64(16, true));

  return {
@@ -259,6 +269,8 @@ function decodeClock(view: DataView): ClockMessage {
    speedIndex: view.getUint8(14),
    skipAllowed: view.getUint8(15) !== 0,
    skipTarget: skipTargetMs === 0 ? null : new Date(skipTargetMs),
+    temperatureTenths: view.getInt16(24, true),
+    precipitation: view.getUint8(26),
  };
 }

@@ -266,6 +266,12 @@ body {
  text-transform: capitalize;
 }

+.clock__weather {
+  margin: 0;
+  color: var(--text-muted);
+  font-size: 13px;
+}
+
 .clock__controls {
  display: flex;
  align-items: center;
@@ -8,6 +8,7 @@ import {
  type PresenceNode,
 } from '../net/protocol.ts';
 import { formatGameDate, formatGameDateTime, formatGameTimeOfDay, formatGameWeekday } from '../format/gameTime.ts';
+import { formatWeather } from '../format/weather.ts';
 import { getLocale } from '../i18n/locale.ts';
 import { t } from '../i18n/strings.ts';
 import { fetchDirectory, type School } from '../net/api.ts';
@@ -38,6 +39,7 @@ export class GameScreen {
  private readonly time = el('p', { class: 'clock__time', text: '--:--' });
  private readonly date = el('p', { class: 'clock__date' });
  private readonly weekday = el('p', { class: 'clock__weekday' });
+  private readonly weather = el('p', { class: 'clock__weather' });
  private readonly playPauseButton = el('button', { class: 'button button--icon', type: 'button', text: '▶' });
  private readonly skipButton = el('button', { class: 'button button--small', type: 'button' });
  private readonly speedButtons: HTMLButtonElement[];
@@ -86,6 +88,8 @@ export class GameScreen {
  private lastSpeedIndex = 0;
  private skipAllowed = false;
  private skipTarget: Date | null = null;
+  private lastTemperatureTenths: number | null = null;
+  private lastPrecipitation: number | null = null;
  private inspected: 'location' | 'person' = 'location';

  constructor(options: GameScreenOptions) {
@@ -112,7 +116,7 @@ export class GameScreen {
          'div',
          { class: 'clockbar__now' },
          this.time,
-          el('div', { class: 'clockbar__labels' }, this.date, this.weekday),
+          el('div', { class: 'clockbar__labels' }, this.date, this.weekday, this.weather),
        ),
        el('div', { class: 'clock__controls' }, this.playPauseButton, ...this.speedButtons, this.skipButton),
      ),
@@ -184,7 +188,15 @@ export class GameScreen {
    this.paintSelection();

    if (this.lastGameTime !== null) {
-      this.applyClock(this.lastGameTime, this.running, this.lastSpeedIndex, this.skipAllowed, this.skipTarget);
+      this.applyClock(
+        this.lastGameTime,
+        this.running,
+        this.lastSpeedIndex,
+        this.skipAllowed,
+        this.skipTarget,
+        this.lastTemperatureTenths,
+        this.lastPrecipitation,
+      );
    } else {
      this.playPauseButton.title = t('resume');
    }
@@ -208,7 +220,7 @@ export class GameScreen {
    this.skipAllowed = false;
    this.skipTarget = null;
    this.rebuildTree();
-    this.applyClock(new Date(school.gameTime), school.running, school.speedIndex, false, null);
+    this.applyClock(new Date(school.gameTime), school.running, school.speedIndex, false, null, null, null);
    this.people.show(school.id);
    this.people.setLocate((id) => this.placeOf(id));
    this.management.setLocate((id) => this.placeOf(id));
@@ -251,7 +263,15 @@ export class GameScreen {
  }

  update(clock: ClockMessage): void {
-    this.applyClock(clock.gameTime, clock.running, clock.speedIndex, clock.skipAllowed, clock.skipTarget);
+    this.applyClock(
+      clock.gameTime,
+      clock.running,
+      clock.speedIndex,
+      clock.skipAllowed,
+      clock.skipTarget,
+      clock.temperatureTenths,
+      clock.precipitation,
+    );
  }

  private rebuildTree(): void {
@@ -358,16 +378,24 @@ export class GameScreen {
    speedIndex: number,
    skipAllowed: boolean,
    skipTarget: Date | null,
+    temperatureTenths: number | null,
+    precipitation: number | null,
  ): void {
    this.running = running;
    this.lastGameTime = gameTime;
    this.lastSpeedIndex = speedIndex;
    this.skipAllowed = skipAllowed;
    this.skipTarget = skipTarget;
+    this.lastTemperatureTenths = temperatureTenths;
+    this.lastPrecipitation = precipitation;

    this.time.textContent = formatGameTimeOfDay(gameTime);
    this.date.textContent = formatGameDate(gameTime);
    this.weekday.textContent = formatGameWeekday(gameTime);
+    this.weather.textContent =
+      temperatureTenths === null || precipitation === null
+        ? ''
+        : formatWeather(temperatureTenths, precipitation);

    this.playPauseButton.textContent = running ? '⏸' : '▶';
    this.playPauseButton.title = running ? t('pause') : t('resume');
@@ -142,6 +142,12 @@ public sealed class RoomDef : Def

    /// <summary>Game minutes spent occupying this room when walking through it.</summary>
    public float TravelMinutes { get; init; }
+
+    /// <summary>
+    /// Outdoor like the yard: porch, crossing between buildings. Indoor rooms stay warmer than
+    /// the street by the climate preset's wall offset.
+    /// </summary>
+    public bool Outdoor { get; init; }
 }

 public sealed class BuildingDef : Def;
@@ -30,6 +30,11 @@ internal static class PeopleDefValidator
            ValidateCountry(country, catalog);
        }

+        foreach (var preset in catalog.ClimatePresets.Values)
+        {
+            ValidateClimatePreset(preset);
+        }
+
        foreach (var subject in catalog.Subjects.Values)
        {
            ValidateSubject(subject, catalog);
@@ -576,6 +581,40 @@ internal static class PeopleDefValidator
        ValidateNameSet(country.Names ?? new NameSetDef(), catalog, country.DefName);
    }

+    private static void ValidateClimatePreset(ClimatePresetDef preset)
+    {
+        if (preset.Abstract)
+        {
+            return;
+        }
+
+        if (preset.MonthlyNorms.Count != 12)
+        {
+            throw new ContentLoadException(
+                $"ClimatePresetDef '{preset.DefName}' monthlyNorms must list 12 months.");
+        }
+
+        if (preset.DaySpread < 0 || preset.HourSpread < 0)
+        {
+            throw new ContentLoadException($"ClimatePresetDef '{preset.DefName}' spreads cannot be negative.");
+        }
+
+        if (preset.PrecipitationChance < 0 || preset.PrecipitationChance > 1)
+        {
+            throw new ContentLoadException($"ClimatePresetDef '{preset.DefName}' precipitationChance must be 0–1.");
+        }
+
+        if (preset.ComfortHalfWidthC < 0)
+        {
+            throw new ContentLoadException($"ClimatePresetDef '{preset.DefName}' comfortHalfWidthC cannot be negative.");
+        }
+
+        if (preset.InsulationPerC < 0)
+        {
+            throw new ContentLoadException($"ClimatePresetDef '{preset.DefName}' insulationPerC cannot be negative.");
+        }
+    }
+
    private static void ValidateNameSet(NameSetDef names, DefCatalog catalog, string countryDefName)
    {
        if (!NameGrammar.IsKnownPatronymic(names.PatronymicRule))
@@ -184,6 +184,12 @@ public sealed class TraitDef : Def
    /// Extra minutes of commute slack. Positive arrives earlier; negative cuts it closer.
    /// </summary>
    public int CommuteMinutes { get; init; }
+
+    /// <summary>
+    /// Shifts the warmth comfort band, in °C. Heat-loving is positive (suffers cold earlier);
+    /// cold-loving is negative.
+    /// </summary>
+    public float ComfortTemperatureOffset { get; init; }
 }

 public sealed class StaffingDef : Def
@@ -309,6 +315,12 @@ public sealed class NeedDef : Def
    /// restores overnight; hunger does not keep falling at home.
    /// </summary>
    public bool RestoredOffCampus { get; init; }
+
+    /// <summary>
+    /// When true, campus drain is not <see cref="DecayPerHour"/> per hour. Warmth uses it as the
+    /// drop per °C of mismatch against the place temperature.
+    /// </summary>
+    public bool Environmental { get; init; }
 }

 public sealed class CaseTable
@@ -407,7 +419,7 @@ public sealed class NameSetDef

 /// <summary>
 /// What the player picks at create: nested names plus climate-preset ids. Weather numbers live
-/// on <see cref="ClimatePresetDef"/> and stay unused until phase 32.
+/// on <see cref="ClimatePresetDef"/>.
 /// </summary>
 public sealed class CountryDef : Def
 {
@@ -417,7 +429,32 @@ public sealed class CountryDef : Def
 }

 /// <summary>
-/// Outdoor climate a country may roll. Monthly temperatures land in phase 32; the id is enough
-/// to persist which preset a school was born with.
+/// Outdoor climate a country may roll. Monthly norms, day/hour spread and precipitation chance
+/// are the numbers the school uses to sample the street; indoor offset is walls without a technician.
 /// </summary>
-public sealed class ClimatePresetDef : Def;
+public sealed class ClimatePresetDef : Def
+{
+    /// <summary>Mean outdoor °C for months 1–12. Concrete presets must list all twelve.</summary>
+    public IReadOnlyList<float> MonthlyNorms { get; init; } = [];
+
+    /// <summary>How far a day's mean may wander from the monthly norm, °C.</summary>
+    public float DaySpread { get; init; }
+
+    /// <summary>How far the hour wanders from that day's mean, °C. Coldest around 03:00, warmest 15:00.</summary>
+    public float HourSpread { get; init; }
+
+    /// <summary>Chance of precipitation this hour, 0–1. Below 0 °C the same roll is snow.</summary>
+    public float PrecipitationChance { get; init; }
+
+    /// <summary>Added to indoor temperature vs the street. Walls hold heat; this is not comfort.</summary>
+    public float IndoorOffset { get; init; } = 8f;
+
+    /// <summary>Centre of the clothing comfort band, °C, before trait offsets.</summary>
+    public float ComfortC { get; init; } = 21f;
+
+    /// <summary>Half-width of the comfort band, °C. Inside it warmth barely drops.</summary>
+    public float ComfortHalfWidthC { get; init; } = 3f;
+
+    /// <summary>How many °C of protection one insulation point is worth.</summary>
+    public float InsulationPerC { get; init; } = 1f;
+}
@@ -33,6 +33,8 @@ public readonly record struct ServerPongMessage(long ClientTimeMs, uint ServerTi
 /// interpreted as UTC — the game calendar has no time zone.
 /// <paramref name="SkipAllowed"/> is the server's verdict; the client must not recompute it.
 /// <paramref name="SkipTargetUnixMs"/> is 0 when skip is refused.
+/// <paramref name="TemperatureTenths"/> is outdoor °C × 10. <paramref name="Precipitation"/> is
+/// <see cref="PrecipitationKind"/>.
 /// </summary>
 public readonly record struct ServerClockMessage(
    int SchoolId,
@@ -40,7 +42,17 @@ public readonly record struct ServerClockMessage(
    bool Running,
    byte SpeedIndex,
    bool SkipAllowed = false,
-    long SkipTargetUnixMs = 0);
+    long SkipTargetUnixMs = 0,
+    short TemperatureTenths = 0,
+    byte Precipitation = 0);
+
+/// <summary>Outdoor precipitation on the clock frame. Below 0 °C the same weather roll is snow.</summary>
+public static class PrecipitationKind
+{
+    public const byte None = 0;
+    public const byte Rain = 1;
+    public const byte Snow = 2;
+}

 /// <summary>The open school no longer exists (deleted from another tab); the client returns to the menu.</summary>
 public readonly record struct ServerSchoolGoneMessage(int SchoolId);
@@ -49,6 +49,14 @@ public ref struct PacketReader(ReadOnlySpan<byte> buffer)
        return value;
    }

+    public short ReadInt16()
+    {
+        EnsureAvailable(sizeof(short));
+        var value = BinaryPrimitives.ReadInt16LittleEndian(_buffer[_position..]);
+        _position += sizeof(short);
+        return value;
+    }
+
    public int ReadInt32()
    {
        EnsureAvailable(sizeof(int));
@@ -52,6 +52,13 @@ public ref struct PacketWriter(Span<byte> buffer)
        _position += byteCount;
    }

+    public void WriteInt16(short value)
+    {
+        EnsureRoom(sizeof(short));
+        BinaryPrimitives.WriteInt16LittleEndian(_buffer[_position..], value);
+        _position += sizeof(short);
+    }
+
    public void WriteInt32(int value)
    {
        EnsureRoom(sizeof(int));
@@ -13,7 +13,7 @@ public static class ProtocolCodec
    /// Largest <em>fixed-size</em> frame this codec produces. Variable map snapshots and
    /// presence frames use <see cref="ProtocolConstants.MaxMessageSize"/> instead.
    /// </summary>
-    public const int MaxFrameSize = 24;
+    public const int MaxFrameSize = 27;

    public static int WriteHello(Span<byte> destination, in ClientHelloMessage message)
    {
@@ -99,6 +99,8 @@ public static class ProtocolCodec
        writer.WriteByte(message.SpeedIndex);
        writer.WriteByte(message.SkipAllowed ? (byte)1 : (byte)0);
        writer.WriteInt64(message.SkipTargetUnixMs);
+        writer.WriteInt16(message.TemperatureTenths);
+        writer.WriteByte(message.Precipitation);
        return writer.Position;
    }

@@ -317,7 +319,17 @@ public static class ProtocolCodec
        var speedIndex = reader.ReadByte();
        var skipAllowed = reader.ReadByte() != 0;
        var skipTarget = reader.ReadInt64();
-        return new ServerClockMessage(schoolId, gameTime, running, speedIndex, skipAllowed, skipTarget);
+        var temperatureTenths = reader.ReadInt16();
+        var precipitation = reader.ReadByte();
+        return new ServerClockMessage(
+            schoolId,
+            gameTime,
+            running,
+            speedIndex,
+            skipAllowed,
+            skipTarget,
+            temperatureTenths,
+            precipitation);
    }

    public static ServerSchoolGoneMessage ReadSchoolGone(ReadOnlySpan<byte> source)
@@ -4,7 +4,7 @@ namespace HSchool.Protocol;
 public static class ProtocolConstants
 {
    /// <summary>Bumped on every breaking change to the binary layout.</summary>
-    public const byte Version = 7;
+    public const byte Version = 8;

    /// <summary>Upper bound for a single WebSocket frame accepted by the server.</summary>
    public const int MaxMessageSize = 8 * 1024;
@@ -1063,7 +1063,9 @@ internal sealed class SchoolWorker
            school.Clock.IsRunning,
            (byte)school.Clock.SpeedIndex,
            skip.Allowed,
-            skip.Time is { } target ? new DateTimeOffset(target).ToUnixTimeMilliseconds() : 0));
+            skip.Time is { } target ? new DateTimeOffset(target).ToUnixTimeMilliseconds() : 0,
+            school.Weather.Tenths,
+            (byte)school.Weather.Precipitation));

        client.TrySend(frame.AsMemory(0, length));
    }
@@ -1,3 +1,11 @@
 {
  "defName": "ContinentalCold",
+  "monthlyNorms": [-16.0, -14.0, -7.0, 2.0, 10.0, 16.0, 18.0, 15.0, 9.0, 1.0, -8.0, -14.0],
+  "daySpread": 6,
+  "hourSpread": 5,
+  "precipitationChance": 0.28,
+  "indoorOffset": 8,
+  "comfortC": 21,
+  "comfortHalfWidthC": 3,
+  "insulationPerC": 1,
 }
@@ -1,3 +1,12 @@
 {
  "defName": "TemperateContinental",
+  // Moscow-like monthly means. January mornings sit below zero so the clock can show snow.
+  "monthlyNorms": [-9.3, -8.0, -2.2, 6.7, 13.2, 17.0, 19.2, 17.0, 11.3, 5.3, -0.5, -6.2],
+  "daySpread": 5,
+  "hourSpread": 4,
+  "precipitationChance": 0.32,
+  "indoorOffset": 8,
+  "comfortC": 21,
+  "comfortHalfWidthC": 3,
+  "insulationPerC": 1,
 }
@@ -3,4 +3,13 @@
  { "defName": "Hunger", "initial": 1, "decayPerHour": 0.2, "min": 0, "max": 1, "restoredOffCampus": true },
  { "defName": "Toilet", "initial": 1, "decayPerHour": 0.15, "min": 0, "max": 1 },
  { "defName": "Social", "initial": 1, "decayPerHour": 0.08, "min": 0, "max": 1 },
+  {
+    "defName": "Warmth",
+    "initial": 1,
+    "decayPerHour": 0.04,
+    "min": 0,
+    "max": 1,
+    "restoredOffCampus": true,
+    "environmental": true,
+  },
 ]
@@ -1,5 +1,5 @@
 [
  // Walkable rooms that exist to connect the graph: lobby, stairs. Empty on purpose.
-  { "defName": "EntranceHall", "travelMinutes": 1 },
+  { "defName": "EntranceHall", "travelMinutes": 1, "outdoor": true },
  { "defName": "Stairwell", "travelMinutes": 1.5 },
 ]
@@ -80,4 +80,16 @@
      { "skill": "Chemistry", "offset": 4 },
    ],
  },
+  {
+    "defName": "HeatLoving",
+    "weight": 5,
+    "incompatible": ["ColdLoving"],
+    "comfortTemperatureOffset": 4,
+  },
+  {
+    "defName": "ColdLoving",
+    "weight": 5,
+    "incompatible": ["HeatLoving"],
+    "comfortTemperatureOffset": -4,
+  },
 ]
@@ -144,6 +144,9 @@
  "Hunger": "Hunger",
  "Toilet": "Toilet",
  "Social": "Social",
+  "Warmth": "Warmth",
+  "HeatLoving": "Heat-loving",
+  "ColdLoving": "Cold-loving",
  "Russia": "Russia",
  "TemperateContinental": "Temperate continental",
  "ContinentalCold": "Cold continental",
@@ -144,6 +144,9 @@
  "Hunger": "Голод",
  "Toilet": "Туалет",
  "Social": "Общение",
+  "Warmth": "Тепло",
+  "HeatLoving": "Теплолюбивый",
+  "ColdLoving": "Холодолюбивый",
  "Russia": "Россия",
  "TemperateContinental": "Умеренно-континентальный",
  "ContinentalCold": "Континентальный холодный",
@@ -46,7 +46,7 @@ public static class NeedDecay

            foreach (var def in catalog.Needs.Values)
            {
-                if (def.Abstract || !needs.Values.TryGetValue(def.DefName, out var current))
+                if (def.Abstract || def.Environmental || !needs.Values.TryGetValue(def.DefName, out var current))
                {
                    continue;
                }
@@ -0,0 +1,20 @@
+namespace HSchool.Simulation;
+
+/// <summary>Street precipitation. Below 0 °C the same roll is snow, above it is rain.</summary>
+public enum Precipitation : byte
+{
+    None = 0,
+    Rain = 1,
+    Snow = 2,
+}
+
+/// <summary>Cached outdoor state shown on the clock and used to drain warmth.</summary>
+public readonly record struct OutdoorWeather(float TemperatureC, Precipitation Precipitation)
+{
+    public static OutdoorWeather None { get; } = new(0f, Precipitation.None);
+
+    public short Tenths => (short)Math.Clamp(
+        Math.Round(TemperatureC * 10d, MidpointRounding.AwayFromZero),
+        short.MinValue,
+        short.MaxValue);
+}
@@ -0,0 +1,73 @@
+using HSchool.Content;
+using HSchool.People;
+
+namespace HSchool.Simulation;
+
+/// <summary>
+/// Worn insulation in °C-equivalent points, summed from apparel currently on the body.
+/// Tests that need a bare frost set <see cref="Naked"/> on the entity explicitly.
+/// </summary>
+public readonly record struct PersonInsulation(float Value)
+{
+    public static PersonInsulation Naked { get; } = new(0f);
+
+    public static PersonInsulation FromWorn(DefCatalog catalog, params string[] defNames)
+    {
+        ArgumentNullException.ThrowIfNull(catalog);
+        var sum = 0f;
+        foreach (var name in defNames)
+        {
+            if (catalog.Things.TryGetValue(name, out var thing) && thing.Layers.Count > 0)
+            {
+                sum += thing.Insulation;
+            }
+        }
+
+        return new PersonInsulation(sum);
+    }
+
+    public static PersonInsulation FromPerson(Person person, DefCatalog? catalog)
+    {
+        ArgumentNullException.ThrowIfNull(person);
+        if (catalog is null)
+        {
+            return Naked;
+        }
+
+        var worn = WornDefs(person);
+        return worn.Count == 0 ? Naked : FromWorn(catalog, [.. worn]);
+    }
+
+    private static List<string> WornDefs(Person person)
+    {
+        var worn = new List<string>();
+        if (person.GetType().GetProperty("Items")?.GetValue(person) is not System.Collections.IEnumerable items)
+        {
+            return worn;
+        }
+
+        foreach (var item in items)
+        {
+            if (item is null)
+            {
+                continue;
+            }
+
+            var type = item.GetType();
+            var def = type.GetProperty("Def")?.GetValue(item) as string;
+            var location = type.GetProperty("Location")?.GetValue(item) as string
+                ?? type.GetProperty("Place")?.GetValue(item) as string;
+            if (def is null || location is null)
+            {
+                continue;
+            }
+
+            if (location.Equals("worn", StringComparison.OrdinalIgnoreCase))
+            {
+                worn.Add(def);
+            }
+        }
+
+        return worn;
+    }
+}
@@ -0,0 +1,57 @@
+using HSchool.Content;
+
+namespace HSchool.Simulation;
+
+/// <summary>
+/// Street vs indoors. The yard is always outdoor; rooms opt in with <see cref="RoomDef.Outdoor"/>
+/// so the porch matches the street. Indoor temperature is the street plus the preset's wall offset
+/// — warmer, not yet comfortable (the technician is phase 33).
+/// </summary>
+public static class PlaceClimate
+{
+    public static bool IsOutdoor(DefCatalog catalog, MapLayout? map, string? nodeId)
+    {
+        if (nodeId is null || map is null)
+        {
+            return true;
+        }
+
+        if (map.Territory is { } territory && territory.Id.Equals(nodeId, StringComparison.Ordinal))
+        {
+            return true;
+        }
+
+        var defName = map.NodeDef(nodeId);
+        if (defName is null)
+        {
+            return true;
+        }
+
+        if (catalog.Territories.ContainsKey(defName))
+        {
+            return true;
+        }
+
+        return catalog.Rooms.TryGetValue(defName, out var room) && room.Outdoor;
+    }
+
+    public static float TemperatureC(School school, string? nodeId)
+    {
+        var outdoor = school.Weather.TemperatureC;
+        var catalog = school.Catalog;
+        if (catalog is null || IsOutdoor(catalog, school.Map, nodeId))
+        {
+            return outdoor;
+        }
+
+        var offset = 8f;
+        if (school.ClimatePresetId is { } presetId
+            && catalog.ClimatePresets.TryGetValue(presetId, out var preset)
+            && !preset.Abstract)
+        {
+            offset = preset.IndoorOffset;
+        }
+
+        return outdoor + offset;
+    }
+}
@@ -1,6 +1,7 @@
 using Arch.Core;
-using HSchool.People;
 using HSchool.Ai;
+using HSchool.Content;
+using HSchool.People;

 namespace HSchool.Simulation;

@@ -10,7 +11,7 @@ public static class RosterSpawner
    private static readonly QueryDescription People = new QueryDescription().WithAll<PersonIdentity>();
    private static readonly QueryDescription Classes = new QueryDescription().WithAll<ClassIdentity>();

-    public static void Spawn(World world, Roster roster)
+    public static void Spawn(World world, Roster roster, DefCatalog? catalog = null)
    {
        foreach (var schoolClass in roster.Classes)
        {
@@ -30,7 +31,8 @@ public static class RosterSpawner
                new PersonBody(person.Numbers, person.Choices),
                new PersonSkills(person.Skills.ToDictionary(pair => pair.Key, pair => (float)pair.Value, StringComparer.Ordinal)),
                new PersonTraits(person.Traits),
-                new PersonNeeds(new Dictionary<string, float>(person.Needs, StringComparer.Ordinal)),
+                new PersonNeeds(NeedsOf(person, catalog)),
+                PersonInsulation.FromPerson(person, catalog),
                new PersonRoles(
                    person.IsStudent,
                    person.IsStaff,
@@ -45,11 +47,30 @@ public static class RosterSpawner
    }

    /// <summary>Drops the previous composition and spawns <paramref name="roster"/>. Called on yearly intake.</summary>
-    public static void Replace(World world, Roster roster)
+    public static void Replace(World world, Roster roster, DefCatalog? catalog = null)
    {
        DestroyAll(world, People);
        DestroyAll(world, Classes);
-        Spawn(world, roster);
+        Spawn(world, roster, catalog);
+    }
+
+    private static Dictionary<string, float> NeedsOf(Person person, DefCatalog? catalog)
+    {
+        var values = new Dictionary<string, float>(person.Needs, StringComparer.Ordinal);
+        if (catalog is null)
+        {
+            return values;
+        }
+
+        foreach (var need in catalog.Needs.Values)
+        {
+            if (!need.Abstract && !values.ContainsKey(need.DefName))
+            {
+                values[need.DefName] = need.Initial;
+            }
+        }
+
+        return values;
    }

    private static void DestroyAll(World world, QueryDescription query)
@@ -78,9 +78,12 @@ public sealed class School : IDisposable
    /// <summary>Country used to generate this school's people. Needed again on 1 September.</summary>
    public string? CountryId { get; private set; }

-    /// <summary>Climate preset rolled at birth. Phase 32 reads it; it cannot change on a live school.</summary>
+    /// <summary>Climate preset rolled at birth. Weather reads it; it cannot change on a live school.</summary>
    public string? ClimatePresetId { get; private set; }

+    /// <summary>Street temperature and precipitation last committed for the clock and warmth.</summary>
+    public OutdoorWeather Weather { get; private set; } = OutdoorWeather.None;
+
    /// <summary>Skill everyone generated for this school speaks natively.</summary>
    public string? NativeLanguage { get; private set; }

@@ -132,11 +135,12 @@ public sealed class School : IDisposable
        ClimatePresetId = climatePresetId;
        NativeLanguage = nativeLanguage;
        Applicants = applicants;
-        RosterSpawner.Spawn(World, roster);
+        RosterSpawner.Spawn(World, roster, Catalog);
        PlanDay = null;
        LastDecisionSlot = null;
        Plans.Clear();
        DecisionQueue.Clear();
+        SyncWeather(force: true);
    }

    public bool TryStartAction(string personId, string actionId)
@@ -208,6 +212,7 @@ public sealed class School : IDisposable
        PlanDay = null;
        LastDecisionSlot = null;
        NeedDecay.Apply(World, Catalog, (next.Value - before).TotalMinutes);
+        SyncWeather(force: true);
        return new SkipEmptyResult(SkipEmptyError.None, next.Value, peopleChanged);
    }

@@ -224,7 +229,7 @@ public sealed class School : IDisposable
        Roster = roster;
        Applicants = applicants;
        var snapshot = PresenceSystem.Capture(this);
-        RosterSpawner.Replace(World, roster);
+        RosterSpawner.Replace(World, roster, Catalog);
        PresenceSystem.Restore(this, snapshot);
        TimetableDirty = true;
    }
@@ -274,16 +279,50 @@ public sealed class School : IDisposable
            if (Catalog is not null)
            {
                var below = PresenceSystem.BelowThreshold(this);
+                SyncWeather(force: false);
                NeedDecay.Apply(World, Catalog, gameMinutes);
+                WarmthDecay.Apply(this, gameMinutes);
                PresenceSystem.EnqueueNewlyUrgent(this, below);
                PresenceSystem.DrainDecisions(this);
                LessonLearningSystem.Apply(this, gameMinutes);
            }
        }
+        else
+        {
+            SyncWeather(force: false);
+        }

        return peopleChanged;
    }

+    /// <summary>
+    /// Recomputes the street from the preset, seed and current time. Commits when the clock
+    /// tenths or precipitation change, so warmth does not jitter every tick. A skip must force
+    /// the morning sample — yesterday's evening must not stick.
+    /// </summary>
+    public void SyncWeather(bool force)
+    {
+        ObjectDisposedException.ThrowIf(_disposed, this);
+        var next = EvaluateWeather();
+        if (force || next.Tenths != Weather.Tenths || next.Precipitation != Weather.Precipitation)
+        {
+            Weather = next;
+        }
+    }
+
+    private OutdoorWeather EvaluateWeather()
+    {
+        if (Catalog is null
+            || ClimatePresetId is null
+            || !Catalog.ClimatePresets.TryGetValue(ClimatePresetId, out var preset)
+            || preset.Abstract)
+        {
+            return OutdoorWeather.None;
+        }
+
+        return WeatherSampler.Sample(preset, PeopleSeed, Clock.Time);
+    }
+
    private bool TryYearlyIntake(DateTime before, DateTime after)
    {
        if (Roster is null || Catalog is null || CountryId is null)
@@ -301,7 +340,7 @@ public sealed class School : IDisposable
        if (changed)
        {
            var snapshot = PresenceSystem.Capture(this);
-            RosterSpawner.Replace(World, Roster);
+            RosterSpawner.Replace(World, Roster, Catalog);
            PresenceSystem.Restore(this, snapshot);
            TimetableDirty = true;
        }
@@ -0,0 +1,81 @@
+using Arch.Core;
+using HSchool.Ai;
+using HSchool.Content;
+
+namespace HSchool.Simulation;
+
+/// <summary>
+/// Drains <c>Warmth</c> from the gap between clothing insulation and the temperature of the
+/// place the person is in. Off campus the generic need restore already snaps it to max.
+/// </summary>
+public static class WarmthDecay
+{
+    private static readonly QueryDescription People =
+        new QueryDescription().WithAll<PersonNeeds, PersonTraits, PersonInsulation, Presence>();
+
+    public static void Apply(School school, double gameMinutes)
+    {
+        if (gameMinutes <= 0)
+        {
+            return;
+        }
+
+        var catalog = school.Catalog;
+        if (catalog is null || !catalog.Needs.TryGetValue("Warmth", out var warmth) || warmth.Abstract)
+        {
+            return;
+        }
+
+        var preset = Preset(school, catalog);
+        var hours = gameMinutes / 60d;
+        var world = school.World;
+        world.Query(
+            in People,
+            (ref PersonNeeds needs, ref PersonTraits traits, ref PersonInsulation insulation, ref Presence presence) =>
+            {
+                if (!presence.IsOnCampus || !needs.Values.ContainsKey(warmth.DefName))
+                {
+                    return;
+                }
+
+                var place = PlaceClimate.TemperatureC(school, presence.NodeId);
+                var felt = place + insulation.Value * (preset?.InsulationPerC ?? 1f);
+                var center = (preset?.ComfortC ?? 21f) + TraitOffset(catalog, traits);
+                var halfWidth = preset?.ComfortHalfWidthC ?? 3f;
+                var mismatch = Math.Abs(felt - center) - halfWidth;
+                if (mismatch <= 0)
+                {
+                    return;
+                }
+
+                var next = needs.Values[warmth.DefName] - (float)(mismatch * warmth.DecayPerHour * hours);
+                needs.Values[warmth.DefName] = Math.Clamp(next, warmth.Min, warmth.Max);
+            });
+    }
+
+    private static ClimatePresetDef? Preset(School school, DefCatalog catalog)
+    {
+        if (school.ClimatePresetId is { } id
+            && catalog.ClimatePresets.TryGetValue(id, out var preset)
+            && !preset.Abstract)
+        {
+            return preset;
+        }
+
+        return null;
+    }
+
+    private static float TraitOffset(DefCatalog catalog, PersonTraits traits)
+    {
+        var offset = 0f;
+        foreach (var id in traits.Ids)
+        {
+            if (catalog.Traits.TryGetValue(id, out var trait))
+            {
+                offset += trait.ComfortTemperatureOffset;
+            }
+        }
+
+        return offset;
+    }
+}
@@ -0,0 +1,53 @@
+using HSchool.Content;
+using HSchool.People;
+
+namespace HSchool.Simulation;
+
+/// <summary>
+/// Outdoor temperature and precipitation from a climate preset, the school seed, and the
+/// calendar. Same inputs always produce the same street. Not a tick accumulator — sample it
+/// when the clock label or warmth would move.
+/// </summary>
+public static class WeatherSampler
+{
+    private const int DaySalt = 0x57EA11;
+    private const int HourSalt = 0x57EA12;
+
+    public static OutdoorWeather Sample(ClimatePresetDef preset, int schoolSeed, DateTime time)
+    {
+        ArgumentNullException.ThrowIfNull(preset);
+
+        var utc = DateTime.SpecifyKind(time, DateTimeKind.Utc);
+        var month = utc.Month;
+        var norm = MonthNorm(preset, month);
+        var dayNumber = DateOnly.FromDateTime(utc).DayNumber;
+        var dayNoise = SignedUnit(Seed.Mix(schoolSeed, dayNumber, DaySalt)) * preset.DaySpread;
+        var hour = utc.Hour + utc.Minute / 60d + utc.Second / 3600d;
+        var diurnal = -Math.Cos((hour - 3d) / 24d * 2d * Math.PI) * preset.HourSpread;
+        var temperature = (float)(norm + dayNoise + diurnal);
+
+        var wet = Unit(Seed.Mix(schoolSeed, dayNumber * 24 + utc.Hour, HourSalt)) < preset.PrecipitationChance;
+        var precipitation = !wet
+            ? Precipitation.None
+            : temperature < 0f ? Precipitation.Snow : Precipitation.Rain;
+
+        return new OutdoorWeather(temperature, precipitation);
+    }
+
+    private static float MonthNorm(ClimatePresetDef preset, int month)
+    {
+        if (preset.MonthlyNorms.Count != 12)
+        {
+            return 0f;
+        }
+
+        return preset.MonthlyNorms[month - 1];
+    }
+
+    private static double Unit(int mixed)
+    {
+        return (uint)mixed / (double)uint.MaxValue;
+    }
+
+    private static double SignedUnit(int mixed) => Unit(mixed) * 2d - 1d;
+}