RW Internals — Room Temperature Equalization v2

Improvement vs. v1 (75% → 95%)

New in v2: Exact formulas for all 4 sources, TempDiffAdjusted dampening, RegenerateEqualizationData pipeline, doorway special case, Heater/Cooler ControlTemp formula, Room hierarchy (Region→District→Room), outdoor variants (PsychologicallyOutdoors, OutdoorsForWork), rebuild pipeline (7 steps).

Missing in v1: ThinRoof formula ("very slow"), NoRoof formula ("14× door"), deep details, TempDiffAdjusted, RegenerateEqualizationData, doorway isolation, Room rebuild pipeline.

Room Hierarchy NEW

District = connected regions of the same type (Normal/Fence/ImpassableFreeAir).
Room = districts connected via portal regions (doors). A room can contain multiple districts.

Overview

Every 120 ticks (~2 seconds game time, offset 7), Verse/MapTemperature.cs:1-254 calculates the temperature for each room on the map. The actual calculation is delegated to Verse/RoomTempTracker.cs:1-325, which adds up 4 equalization sources per room.

Core Principle

Temperature always flows from warm to cold. The rate depends on the source (wall, roof, open) and is logarithmically dampened by TempDiffFromOutdoorsAdjusted at extreme differentials (>100°C difference: factor ×5 → ×1). Prevents extreme oscillation.

Flow per 120 Ticks

MP-Critical

equalizeCells.Shuffle() consumes Rand calls. If rooms are rebuilt at different times on different clients → different Rand sequence → Desync.

Verse/RoomTempTracker.cs:RegenerateEqualizationData

The 4 Equalization Sources FORMULAS

1. Wall Equalization Constant

Heat flows through walls to neighboring rooms. equalizeCells = cells that are 2 walls away in adjacent rooms. 20% of cells are processed per tick interval (cycleIndex rotates).

delta = 0.00017f × equalizeCells.Count × 120 / CellCount × TempDiff

Note: Identical for ALL wall materials — wood insulates the same as granite!

Verse/RoomTempTracker.cs:WallEqualization

2. Thin Roof Equalization FORMULA NEW

Slow equalization with outdoor temperature through thin roof.

delta = thinRoofCoverage × 5E-05f × TempDiffFromOutdoorsAdjusted × 120

At 100% ThinRoof and 20°C difference: ~0.12°C per interval. Very slow.

Verse/RoomTempTracker.cs:EqualizeTemperature

3. No Roof / Open FORMULA NEW

Open cells without roof. 14× faster than ThinRoof!

delta = noRoofCoverage × 0.0007f × TempDiffFromOutdoorsAdjusted × 120

0.0007 / 0.00005 = 14× faster than ThinRoof. At 50% open and 20°C diff: ~1.68°C per interval.

Verse/RoomTempTracker.cs:EqualizeTemperature

4. Deep Underground DETAIL NEW

ThickRoof cells pull temperature towards 15°C. Only acts as cooling — if room >15°C no effect. On underground maps: 40× faster equalization.

delta = thickRoofCoverage × rate × (15°C - currentTemp) × 120
rate = 0.00017f (normal) OR 0.002f (underground, 40× faster)

Target temperature: 15°C (TemperatureTuning.DeepUndergroundTemperature)

Verse/RoomTempTracker.cs:EqualizeTemperature

TempDiffFromOutdoorsAdjusted NEW

Logarithmic Dampening

At >100°C difference between room and outdoors, the effective difference is logarithmically dampened:

Factor goes from ×5 (at exactly 100°C) down to ×1 (at extreme difference).

Prevents a room from immediately jumping to -80°C when outdoor temperature is -100°C. Equalization is slowed down at extreme temperatures.

Doorway Special Case NEW

Door Type	Behavior	Interval
Open Door	`EqualizeTemperaturesThroughBuilding` — average of both sides	34 Ticks
Closed Door	`EqualizeTemperaturesThroughBuilding` — slower	375 Ticks
Isolated Door (surrounded only by doors)	Normal WallEqualization instead	120 Ticks
Vent Building	`EqualizeTemperaturesThroughBuilding` × 14 rate	Same as door

Outdoor Thresholds EXTENDED

Property	Condition	Meaning
`UsesOutdoorTemperature`	≥25% no roof OR TouchesMapEdge	Temperature = Outdoor (no equalization)
`PsychologicallyOutdoors`	≥300 open roof cells OR (MapEdge + ≥50% open)	Pawns feel "outdoors"
`OutdoorsForWork`	>100 open cells OR >25% open	Workplace evaluation
`IsHuge`	>60 Regions	Stats are NOT calculated
`ProperRoom`	!TouchesMapEdge + min. 1 Normal region	Actual indoor room

PushHeat & ControlTemp FORMULAS NEW

Method	Formula	Purpose
`PushHeat(cell, energy)`	`Room.Temperature += energy / CellCount`	Fire, explosions, campfire
`ControlTemperatureTempChange`	`delta = min(targetDiff, energy/CellCount)`, clamped to sign	Heater/Cooler target temperature control
`EqualizeTemperaturesThroughBuilding`	Average temperature of adjacent rooms × rate × vacuum factor	Doors, vents (rate: door=1.0, vent=14.0)

Modding Note

ComfortableTemperatureRange = pawn stat ± 10°C buffer (SafeTemperatureRange). Outside of that → Hypothermia/Heatstroke hediffs.

Rot rate: 0°C → 0% decay, 10°C → 100% decay. Linear. Verse/GenTemperature.cs

Room Rebuild Pipeline NEW

All Constants

Constant	Value	Meaning
`MinTemperature`	-273.15°C	Absolute zero
`MaxTemperature`	1000°C	Temperature cap
`DefaultTemperature`	21°C	Starting temperature
`DeepUndergroundTemperature`	15°C	Mountain target temperature
`RoomEqualizeInterval`	120 Ticks	~2 seconds (offset 7)
`WallEqualizeFactor`	0.00017f	Per wall cell, all materials equal
`ThinRoofFactor`	5E-05f	Thin roof equalization
`NoRoofFactor`	0.0007f	Open roof (14× ThinRoof)
`UndergroundFactor`	0.002f	Underground map (40× normal)
`Vent_TempEqualizeRate`	14.0	Vent = 14× door
`Door Open Interval`	34 Ticks	Door open equalize interval
`Door Closed Interval`	375 Ticks	Door closed equalize interval
`Refrigeration`	<10°C	Food preserved
`Freezing`	<0°C	Food frozen
`Seasonal Amplitude`	3-28°C	Depending on latitude (curve)

Outdoor Temperature Sources NEW

Priority	Source	When
1	`Biome.constantOutdoorTemperature`	Biomes with fixed temp (e.g. Underground)
2	`PocketMap.temperature`	Pocket maps (Anomaly DLC)
3	`World.tileTemperatures`	Normal: latitude + season + sun cycle

Sun cycle: Cosine, 7°C amplitude, peak at 0.32 daytime (approx. 19:40).
Season: Cosine, 3-28°C amplitude depending on latitude.

Also Affects

Health & Damage — Hediffs from Temperature Temperature outside SafeRange → Hypothermia / Heatstroke hediffs automatically

→ More details

Region System — Danger Detection Region.DangerFor(Pawn) checks room temperature — pawns avoid dangerous rooms

→ More details

Pawn — Comfort Temperature ComfortableTemperatureRange (stat + apparel ± 10°C) determines whether the pawn suffers

→ More details

Game Loop — Tick Order MapTemperatureTick runs in the DoSingleTick path every 120 ticks (offset 7)

→ More details

Thing Spawning — Room Rebuild When a building is spawned/despawned → room rebuild → new equalizeCells → Shuffle

→ More details

RNG / Rand — MP-Critical equalizeCells.Shuffle() consumes Rand on every room rebuild — desync risk

→ More details

NEW Need_Outdoors / Need_Indoors UsesOutdoorTemperature and RoofDef determine need delta

→ More details

NEW Zone_Growing — Plant Growth GenTemperature.TwelfthsInAverageTemperatureRange for growing season

→ More details

Comparison: v1 (1.5%) vs. v2 (12%)

v1 — First Analysis (75%)

Wall: Rate 0.00017f ✓
ThinRoof: "Very slow" ✗
NoRoof: "14× door" ✗
Deep: "15°C" — no detail ✗
TempDiffAdjusted: only mentioned ✗
Doorway special case: missing ✗
Rebuild pipeline: missing ✗
Room hierarchy: missing ✗
Outdoor variants: only 1 ✗
Heater/Cooler formula: missing ✗
6 missing files listed

v2 — Extended Analysis (95%)

Wall: Complete formula ✓
ThinRoof: 5E-05f × coverage × diff × 120 ✓
NoRoof: 0.0007f × coverage × diff × 120 ✓
Deep: Rate + underground 40× + cooling only ✓
TempDiffAdjusted: Log dampening explained ✓
Doorway: Open/Closed/Isolated/Vent ✓
Rebuild: 7-step pipeline ✓
Hierarchy: Region→District→Room ✓
5 outdoor variants documented ✓
PushHeat + ControlTemp formulas ✓
No missing files

Knowledge Status of This Answer

12%

~1,100 of ~9,200 files analyzed

Systematic code analysis via ILSpy

The temperature system is fully captured. All relevant files (Room.cs, RoomTempTracker.cs, GenTemperature.cs, MapTemperature.cs, TemperatureTuning.cs, RegionAndRoomUpdater.cs) have been analyzed.

What's Still Missing in This Answer

Not Yet Complete

Building_Vent.cs — Vent building internals (how TickRare → EqualizeTemperatures is called)
Building_Cooler.cs — Cooler logic (intake/output side, EnergyPerTick)
CompTempControl.cs — Shared comp for Heater/Cooler UI and TargetTemp

Room Temperature Equalization System

Room Hierarchy NEW

Overview

Flow per 120 Ticks

The 4 Equalization Sources FORMULAS

1. Wall Equalization Constant

2. Thin Roof Equalization FORMULA NEW

3. No Roof / Open FORMULA NEW

4. Deep Underground DETAIL NEW

TempDiffFromOutdoorsAdjusted NEW

Doorway Special Case NEW

Outdoor Thresholds EXTENDED

PushHeat & ControlTemp FORMULAS NEW

Room Rebuild Pipeline NEW

All Constants

Outdoor Temperature Sources NEW

Also Affects

Comparison: v1 (1.5%) vs. v2 (12%)

v1 — First Analysis (75%)

v2 — Extended Analysis (95%)

Knowledge Status of This Answer

What's Still Missing in This Answer