dayz-environment-hazards
Use when: sandstorm, sandstormFrequency, ScriptedSandstormController, shelter fade, ThermalBias, heat stroke, HeatStroke, IsInShadow, oil pit, OilPitArea, silicosis, irritated eyes, DEF_DUST_PARTICLE, AGT_AIRBOURNE_SOLID, Nasdara, Badlands, WashHead, solar exposure, environmental
Install
npx skills add https://github.com/willy92wins/DayZ-Modding-Knowledge-Pack/tree/main/skills/dayz-environment-hazards
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install willy92wins-dayz-modding-knowledge-pack@llmmart
git clone https://github.com/willy92wins/DayZ-Modding-Knowledge-Pack.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole willy92wins/dayz-modding-knowledge-pack collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
DayZ Environment Hazards (1.30)
DayZ 1.30 (written on Experimental build 1.30.164014, re-checked on stable 1.30.164200 and 1.30.164289) adds native environmental hazards: hybrid engine+script sandstorm (Weather.GetSandstorm(), exp\scripts\scripts\3_Game\Weather.c:210 and exp\scripts\scripts\3_Game\Sandstorm.c:6-135), exposure with shelter fade in ScriptedSandstormController, heatstroke via ThermalBiasHandler accumulator (high heat no longer kills from HeatComfortMdfr), eye irritation and silicosis via AGT_AIRBOURNE_SOLID, OilPitArea oil pits, dust via SurfaceInfo, and sunstroke with IsInShadow. The Nasdara world (DLC Badlands, appId = 3816030) brings sand weather and solar tables, but on 1.30.164014 data_nasdara.pbo was a 6-file stub (what 1.30.164200 installs: "Status in 1.30 stable", item 1).
All evidence is source_verified against extracted text. No behavior is declared runtime_verified.
Family selector
| Case | Skill / reference | Files |
|---|---|---|
| Activate or balance sandstorm in custom world | This skill | references/sandstorm-shelter.md |
| Heatstroke, shadow, WashHead, motorbike/boat in wind | This skill | references/thermal-heatstroke.md |
| Masks, glasses, silicosis, eye irritation | This skill + dayz-clothing for item |
references/ppe-agents.md |
Ceiling dust, kickup, wheel .ptc |
dayz-particles (VFX detail) + link here |
references/dust-oilpit-nasdara.md |
Oil pit / EffectArea 1.30 |
This skill | references/dust-oilpit-nasdara.md |
| Nasdara / Badlands / mouflon-dog-lizard | This skill (map stub) | references/dust-oilpit-nasdara.md |
PlayerBase + ThermalBiasHandler stream |
dayz-persistence |
ThermalBiasHandler.c:67-78 |
AIParams.sandstormToNoiseMultiplier |
dayz-ai-patterns |
exp\dz\DZ\data\aiconfigs\config.cpp:19-27 |
Recommendation: a new environmental hazard inherits the vanilla pattern (EffectArea + synced trigger, or Weather.GetSandstorm().Start in WorldData). Do not reuse direct damage from HeatComfortMdfr for extreme heat: that path no longer exists in 1.30.
Day-0 critical path for sandstorm + heat in a custom world
- [EXACT] Access to phenomenon: controller is not instantiated in script. On server:
GetGame().GetWeather().GetSandstorm().Start(duration, false)/.Stop(duration, false)(Sandstorm.c:12-27,Weather.c:210).// [EXACT] exp\scripts\scripts\3_Game\Weather.c:210 proto native Sandstorm GetSandstorm(); - [EXACT] World config:
class Sandstormblock with SoundSets andparticlePathincfgWorlds(exp\dz\DZ\data\config.cpp:968-972). - [EXACT] JSON frequency:
"SandstormData": { "sandstormFrequency": 1.0 }(CfgGameplayDataJson.c:440-458).0disables weather-triggered storms;2doubles probability on Nasdara (WorldData.c:427-442,Nasdara.c:563-575). - [DESIGN] WorldData: if you want automatic storms like Nasdara, copy the
CalculateWind+StartSandstormpattern (Nasdara.c:318-322, 561-575). ChernarusPlus does not start sandstorm in itsWeatherOnBeforeChange. - [EXACT] Shelter: intensity per player is
GetIntensity(head)attenuated over 1.5 s if underground, interior (roof andIsSoundInsideBuilding) orCar(ScriptedSandstormController.c:15, 142-178, 213-248, 250-282). Motorbike and boat do not count as shelter. - [EXACT] PPE: mask
DEF_DUST_PARTICLE_BREATHagainst silicosis; eyewear/mask/NVGDEF_DUST_PARTICLE_EYESagainst irritation (constants.c:545-550,PluginTransmissionAgents.c:414-437). - [EXACT] Heat:
HeatComfortMdfrfeedsThermalBiasHandler.Addabove comfort thresholds (HeatComfortMdfr.c:74-112). The 4 phases ofHeatStrokereadGetThermalBiasHandler().Get()(HeatStroke.c:4, 59-62). - [DESIGN] Shadow and sunstroke:
CheckShadowPresenceeveryENVIRO_TICK_SHADOW_RC_CHECK(30 s, not 5) (constants.c:760,Environment.c:406-415, 665-720). The +2/+6/+8 °C table is inNasdaraData.Init, not ChernarusPlus. - [DESIGN] Economy / CE: register
OilPitAreazones viacfgeffectarea.jsonlike anyEffectArea. Detail in references/dust-oilpit-nasdara.md.
The ten invariants that break an environmental hazard
1. Only Car (closed) cancels sandstorm; motorbike and boat do not
- Symptom: motorbike rider keeps squinting and accumulating silicosis inside storm.
- Cause:
ApplyVehicleModifierrequirestransport.IsAnyInherited({Car})(ScriptedSandstormController.c:265). - Remedy: do not assume generic vehicular shelter. For a custom closed vehicle, inherit from
Caror overrideGetIntensityForPlayer.
2. Interior = roof and building sound
- Symptom: being under an eave or a
CrashBasedoes not turn off the storm. - Cause:
isCurrentlyInside = (isUnderRoof && isInInterior)andEXCLUDED_SHELTER_TYPES = {CrashBase, Plant}(ScriptedSandstormController.c:20, 222-228). - Remedy: modded buildings must trigger
IsSoundInsideBuilding()and haveObjIntersectIFiregeometry forIsUnder.
3. Lethal heat no longer lives in HeatComfortMdfr
- Symptom: a 1.29 mod trimming heat damage in
HeatComfortMdfrstops doing anything (player still dies fromHeatStrokePhase4). - Cause: high heat tick calls
thermalBiasHandler.Add(...)(HeatComfortMdfr.c:74-112). Health damage is inHeatStrokePhase4Mdfr.OnTick(HeatStroke.c:314-316). - Remedy: balance
PlayerConstants.THERMAL_BIAS_*(PlayerConstants.c:203-210) orHeatStrokephases. Cold still subtracts health in same modifier (HeatComfortMdfr.c:62-71).
4. HeatStrokePhase1 breaks sickness badge (until 1.30.164200)
- Symptom [CHANGELOG / confirmed in script]: sickness icons do not reappear.
- Cause (1.30.164078 and 1.30.164200): empty
OnActivateandOnDeactivatecallsDecreaseDiseaseCount()(1.30.164200HeatStroke.c:68-75). The only increment is phase 2'sOnActivateand phase 2'sOnDeactivatedoes not decrement (1.30.164200HeatStroke.c:110-123), so the counter balances only when phase 2 activates once per phase 1 episode: phase 1 alone nets −1 and each further phase 2 activation nets +1.ImmuneSystemMdfronly refreshesNTF_SICKwhenHasDisease()changes (ImmuneSystem.c:44-55,PlayerBase.c:1119-1122). - Fixed in 1.30.164289: phase 1's
OnDeactivateis empty (HeatStroke.c:73-75) and phase 2's decrements (HeatStroke.c:124-130). On an older build, or if modding the phases, keep eachIncreaseDiseaseCountand itsDecreaseDiseaseCountin the same phase.
5. Respiratory PPE ≠ Eye PPE
- Symptom: eyewear prevents silicosis, or a mask without
DEF_DUST_PARTICLE_EYESdoes not prevent squinting. - Cause:
AGT_AIRBOURNE_SOLIDuses MASK forSILICOSISand EYEWEAR|MASK|NVG forEYES_IRRITATION(PluginTransmissionAgents.c:414-437). Squint checksDEF_DUST_PARTICLE_EYES(SquintState.c:25-39). - Remedy: declare both defenses in item config. Cache depth = 2 (
GetProtectionLevelCachedEquipmentPluginTransmissionAgents.c:577-582).
6. OnCEUpdate is no longer the EffectArea tick
- Symptom: custom area does not resize particles / does not iterate.
- Cause:
EffectAreaoverridesOnCEIterate(float currentTime, float elapsedTime)(EffectArea.c:191-195). Changelog:OnCEUpdateobsolete. - Remedy: override
OnCEIterate.SpawnParticlesanchors toSurfaceRoadY(EffectArea.c:414-417).
7. Surface.GetStepsParticleID / EffWheelSmoke.SetSurface are obsolete
- Cause:
Surface.c:64-73,WheelSmoke.c:32-35. The 1.30 pipeline passesSurfaceInfo(VehicleVFXComponent.c:177-186,VehicleDust.c:25-35). - Remedy:
SurfaceInfo.GetByName(...).GetStepParticleId()andSelectFromSurface. VFX detail indayz-particles.
8. Oil pit only deals damage in BURNING state
- Cause: random delay 3–10 s (
OilPitArea.c:10-11, 52-60).HeatDamage20.0 damage every 1 s (OilPitTrigger.c:7-8, 53-70). - Remedy: wait for
AddState(EOilPitState.BURNING)or trigger seems inert.
9. Shadow is not a raycast every 5 s
- Cause:
ENVIRO_TICK_SHADOW_RC_CHECK = 30(constants.c:760). Capsule 50 m × 0.05 m towards-GetSunOrMoonDirection()(Environment.c:679-719). Interior, roof orCarforce shadow true (:667-676). - Remedy: do not copy "5 seconds" from digests; measure with 30 s timer.
10. Weather.GetNoiseReductionByWeather() does not govern AI
- Causa: marcado
[Obsolete]; el nativo usaAIParamsincluyendosandstormToNoiseMultiplier = 10.0(Weather.c:407-467,aiconfigs\config.cpp:19-27). - Remedio: HUD/mods →
GetNoiseReductionByWeatherEx(object). Infectados → configAIParams. Skill hermana:dayz-ai-patterns.
How to verify
- Offline linter:
python <KNOWLEDGE_PACK>/tools/dayz-script-validator/scripts/script_validator.py <addon_root>. Gatelen(errors) == 0. - In-game ladder (DayZ-MCP or Diag
-filePatching):- Weather spawn: on server,
GetGame().GetWeather().GetSandstorm().Start(5, false). Client must receive PPEREQ_SANDSTORMEFFECT(ScriptedSandstormController.c:310-327). - Shelter: enter a building with
IsSoundInsideBuilding; intensity → 0 in 1.5 s. Mount a motorbike: intensity must NOT go to 0. Enter aCar: yes. - PPE: with dust mask, no cough or silicosis; with glasses, no squint.
- Heat: sustained high heatcomfort must raise
ThermalBiasand activateMDF_HEAT_STROKE1..4. - WashHead: reduces 10
EYES_IRRITATION(1.6 from bottle) and applies resistance for 30 s (ActionWashHeadWettingClothesBase.c:46-63,ActionWashHeadItemContinuous.c:41); since 1.30.164289 a wash while the resistance runs no longer lowers the bias or restarts the 30 s, but it still reduces the irritation and wets the clothes (ActionWashHeadWettingClothesBase.c:53-62). - Oil pit: wait 3–10 s; then 20 HeatDamage/s and
OIL_FIRE1/OIL_FIRE2particles.
- Weather spawn: on server,
- RPT [UNVERIFIED texts]: search for
ThermalBiasHandler,Sandstorm,Could not get players sandstorm data.
Status in 1.30 stable (re-checked on 1.30.164200)
Work-in-progress aspects first seen in the Experimental code (1.30.164014), re-checked on stable 1.30.164200 on 2026-10-28:
- Nasdara map files (changed on 1.30.164200): on 1.30.164014
data_nasdara.pbohad 6 files (work\pbo-listing-diff.txt:487) and there was no.wrpor navmesh for the map. 1.30.164200 installsnasdara\addons\with 24 PBOs andworlds_nasdara.ebo:worlds_nasdara_nav.pboholdsnavmesh.nm,worlds_nasdara_ce.pbothe CE files (34.xml, 4.json,areaflags.map), anddata_nasdara.pbohas 8 files (the same 6 plusmud_brick_impenetrable.bisurfand.rvmat). No PBO lists a.wrp; as with Sakhal (sakhal\Addons\worlds_sakhal.ebo), the world is presumably in the encrypted.ebo, which was not opened. The 1.30.164200 dedicated server ships the missionmpmissions\dayzOffline.nasdara. The map was not loaded in game. - Wash Head with frozen bottle (unchanged on 1.30.164200):
ActionWashHeadItemContinuousonly rejects gasoline (:32-38). Matches KNOWN ISSUES from changelog. - Sickness icons (changed on 1.30.164078, still wrong on 1.30.164200, fixed on 1.30.164289): bug in
HeatStrokePhase1+HasDisease(invariant 4). - ChernarusPlus (unchanged on 1.30.164200) does not populate
m_TemperatureUnderSunModifierinInit(ChernarusPlus.c:31-80); +2/+6/+8 solar table belongs toNasdaraData(Nasdara.c:67-73). Solar effect in Chernarus stays 0 if map lacks key [DESIGN: empty map lookup]. - Fire particles in OilPitTrigger.UpdateState (unchanged on 1.30.164200) are
PlayInWorldwithout headless guard on ignition branch (OilPitTrigger.c:105-116); stop does useIsHeadlessOrDedicatedServerinDeferredInit.
Cite-then-verify
Paths relative to E:\DayZ-Exp-Extract\1.30.164014\ (the exp\ prefix). Since 2026-11-09 the line numbers are those of stable 1.30.164289; the exp\ paths stay (_shared/dayz-conventions.md §Vanilla line numbers: which build). Open file at the line. Digests I/M shifted dozens of citations (e.g. "5 s" shadow, PluginTransmissionAgents.c:377, PlayerBase.c:941). NEVER copy an [EXACT] block from a digest: open it in exp\.
References index
- references/sandstorm-shelter.md: native API,
ScriptedSandstormController, cfgWorlds, JSON, NasdaraCalculateWind. - references/thermal-heatstroke.md:
ThermalBiasHandler,HeatComfortMdfr, 4 phases, WashHead, shadow, motorbike/boat. - references/ppe-agents.md: agents, modifiers, symptoms, PPE, cough.
- references/dust-oilpit-nasdara.md:
SurfaceInfo, roofs, oil pit, Nasdara stub, animals. - references/sources.md: inventory of reopened files and digest line errors.
WHAT THIS DRAFT COULD NOT VERIFY
SandstormControllerC++: progression, magnitude, andGetPointOnEdgelive in exe.- Nasdara terrain: no listed PBO of 1.30.164014 or 1.30.164200 has a
.wrp; on 1.30.164200 it is presumably inside the encryptedworlds_nasdara.ebo, which was not opened. .p3d/.ptc/.eddsbinaries: existence via listings; emitter curves [UNVERIFIED].PlayerBase.OnStoreSavecaller ofm_ThermalBiasHandler: handler writesm_TemporaryResistanceTime(ThermalBiasHandler.c:67-78) and is constructed inPlayerBase.c:426; digest citationPlayerBase.c:941-950is volcanicOnUpdateEffectAreaServer, not stream. Did not locate player'sOnStoreSavein open ranges.- Runtime: no tick was measured in-game.
FIN-SKILL-DRAFT
Files (dayz-modding-knowledge-pack)
-
references
-
dust-oilpit-nasdara.md 4.8 KB
Loading… -
ppe-agents.md 3.9 KB
Loading… -
sandstorm-shelter.md 4.6 KB
Loading… -
sources.md 5.4 KB
Loading… -
thermal-heatstroke.md 7.4 KB
Loading…
-
-
SKILL.md 14.3 KB
--- name: dayz-environment-hazards description: > Use when: sandstorm, sandstormFrequency, ScriptedSandstormController, shelter fade, ThermalBias, heat stroke, HeatStroke, IsInShadow, oil pit, OilPitArea, silicosis, irritated eyes, DEF_DUST_PARTICLE, AGT_AIRBOURNE_SOLID, Nasdara, Badlands, WashHead, solar exposure, environmental hazard. Not particle .ptc/.emat authoring: dayz-particles. Not worn-model clothing: dayz-clothing. Not character import: dayz-characters. Not player stream layout: dayz-persistence. Not AI noise multipliers: dayz-ai-patterns. Not vehicle VFX components: dayz-vehicles. --- # DayZ Environment Hazards (1.30) DayZ 1.30 (written on Experimental build 1.30.164014, re-checked on stable 1.30.164200 and 1.30.164289) adds native environmental hazards: hybrid engine+script sandstorm (`Weather.GetSandstorm()`, `exp\scripts\scripts\3_Game\Weather.c:210` and `exp\scripts\scripts\3_Game\Sandstorm.c:6-135`), exposure with shelter fade in `ScriptedSandstormController`, heatstroke via `ThermalBiasHandler` accumulator (high heat no longer kills from `HeatComfortMdfr`), eye irritation and silicosis via `AGT_AIRBOURNE_SOLID`, `OilPitArea` oil pits, dust via `SurfaceInfo`, and sunstroke with `IsInShadow`. The Nasdara world (DLC Badlands, `appId = 3816030`) brings sand weather and solar tables, but on 1.30.164014 `data_nasdara.pbo` was a 6-file stub (what 1.30.164200 installs: "Status in 1.30 stable", item 1). All evidence is `source_verified` against extracted text. No behavior is declared `runtime_verified`. ## Family selector | Case | Skill / reference | Files | |---|---|---| | Activate or balance sandstorm in custom world | **This skill** | [references/sandstorm-shelter.md](references/sandstorm-shelter.md) | | Heatstroke, shadow, WashHead, motorbike/boat in wind | **This skill** | [references/thermal-heatstroke.md](references/thermal-heatstroke.md) | | Masks, glasses, silicosis, eye irritation | **This skill** + `dayz-clothing` for item | [references/ppe-agents.md](references/ppe-agents.md) | | Ceiling dust, kickup, wheel `.ptc` | `dayz-particles` (VFX detail) + link here | [references/dust-oilpit-nasdara.md](references/dust-oilpit-nasdara.md) | | Oil pit / `EffectArea` 1.30 | **This skill** | [references/dust-oilpit-nasdara.md](references/dust-oilpit-nasdara.md) | | Nasdara / Badlands / mouflon-dog-lizard | **This skill** (map stub) | [references/dust-oilpit-nasdara.md](references/dust-oilpit-nasdara.md) | | `PlayerBase` + `ThermalBiasHandler` stream | `dayz-persistence` | `ThermalBiasHandler.c:67-78` | | `AIParams.sandstormToNoiseMultiplier` | `dayz-ai-patterns` | `exp\dz\DZ\data\aiconfigs\config.cpp:19-27` | Recommendation: a new environmental hazard inherits the vanilla pattern (`EffectArea` + synced trigger, or `Weather.GetSandstorm().Start` in `WorldData`). Do not reuse direct damage from `HeatComfortMdfr` for extreme heat: that path no longer exists in 1.30. ## Day-0 critical path for sandstorm + heat in a custom world 1. [EXACT] **Access to phenomenon**: controller is not instantiated in script. On server: `GetGame().GetWeather().GetSandstorm().Start(duration, false)` / `.Stop(duration, false)` (`Sandstorm.c:12-27`, `Weather.c:210`). ```c // [EXACT] exp\scripts\scripts\3_Game\Weather.c:210 proto native Sandstorm GetSandstorm(); ``` 2. [EXACT] **World config**: `class Sandstorm` block with SoundSets and `particlePath` in `cfgWorlds` (`exp\dz\DZ\data\config.cpp:968-972`). 3. [EXACT] **JSON frequency**: `"SandstormData": { "sandstormFrequency": 1.0 }` (`CfgGameplayDataJson.c:440-458`). `0` disables weather-triggered storms; `2` doubles probability on Nasdara (`WorldData.c:427-442`, `Nasdara.c:563-575`). 4. [DESIGN] **WorldData**: if you want automatic storms like Nasdara, copy the `CalculateWind` + `StartSandstorm` pattern (`Nasdara.c:318-322, 561-575`). ChernarusPlus does not start sandstorm in its `WeatherOnBeforeChange`. 5. [EXACT] **Shelter**: intensity per player is `GetIntensity(head)` attenuated over 1.5 s if underground, interior (roof **and** `IsSoundInsideBuilding`) or `Car` (`ScriptedSandstormController.c:15, 142-178, 213-248, 250-282`). Motorbike and boat do **not** count as shelter. 6. [EXACT] **PPE**: mask `DEF_DUST_PARTICLE_BREATH` against silicosis; eyewear/mask/NVG `DEF_DUST_PARTICLE_EYES` against irritation (`constants.c:545-550`, `PluginTransmissionAgents.c:414-437`). 7. [EXACT] **Heat**: `HeatComfortMdfr` feeds `ThermalBiasHandler.Add` above comfort thresholds (`HeatComfortMdfr.c:74-112`). The 4 phases of `HeatStroke` read `GetThermalBiasHandler().Get()` (`HeatStroke.c:4, 59-62`). 8. [DESIGN] **Shadow and sunstroke**: `CheckShadowPresence` every `ENVIRO_TICK_SHADOW_RC_CHECK` (30 s, not 5) (`constants.c:760`, `Environment.c:406-415, 665-720`). The +2/+6/+8 °C table is in `NasdaraData.Init`, not ChernarusPlus. 9. [DESIGN] **Economy / CE**: register `OilPitArea` zones via `cfgeffectarea.json` like any `EffectArea`. Detail in [references/dust-oilpit-nasdara.md](references/dust-oilpit-nasdara.md). ## The ten invariants that break an environmental hazard ### 1. Only `Car` (closed) cancels sandstorm; motorbike and boat do not - **Symptom**: motorbike rider keeps squinting and accumulating silicosis inside storm. - **Cause**: `ApplyVehicleModifier` requires `transport.IsAnyInherited({Car})` (`ScriptedSandstormController.c:265`). - **Remedy**: do not assume generic vehicular shelter. For a custom closed vehicle, inherit from `Car` or override `GetIntensityForPlayer`. ### 2. Interior = roof **and** building sound - **Symptom**: being under an eave or a `CrashBase` does not turn off the storm. - **Cause**: `isCurrentlyInside = (isUnderRoof && isInInterior)` and `EXCLUDED_SHELTER_TYPES = {CrashBase, Plant}` (`ScriptedSandstormController.c:20, 222-228`). - **Remedy**: modded buildings must trigger `IsSoundInsideBuilding()` and have `ObjIntersectIFire` geometry for `IsUnder`. ### 3. Lethal heat no longer lives in `HeatComfortMdfr` - **Symptom**: a 1.29 mod trimming heat damage in `HeatComfortMdfr` stops doing anything (player still dies from `HeatStrokePhase4`). - **Cause**: high heat tick calls `thermalBiasHandler.Add(...)` (`HeatComfortMdfr.c:74-112`). Health damage is in `HeatStrokePhase4Mdfr.OnTick` (`HeatStroke.c:314-316`). - **Remedy**: balance `PlayerConstants.THERMAL_BIAS_*` (`PlayerConstants.c:203-210`) or `HeatStroke` phases. Cold still subtracts health in same modifier (`HeatComfortMdfr.c:62-71`). ### 4. `HeatStrokePhase1` breaks sickness badge (until 1.30.164200) - **Symptom** [CHANGELOG / confirmed in script]: sickness icons do not reappear. - **Cause** (1.30.164078 and 1.30.164200): empty `OnActivate` and `OnDeactivate` calls `DecreaseDiseaseCount()` (1.30.164200 `HeatStroke.c:68-75`). The only increment is phase 2's `OnActivate` and phase 2's `OnDeactivate` does not decrement (1.30.164200 `HeatStroke.c:110-123`), so the counter balances only when phase 2 activates once per phase 1 episode: phase 1 alone nets −1 and each further phase 2 activation nets +1. `ImmuneSystemMdfr` only refreshes `NTF_SICK` when `HasDisease()` changes (`ImmuneSystem.c:44-55`, `PlayerBase.c:1119-1122`). - **Fixed in 1.30.164289**: phase 1's `OnDeactivate` is empty (`HeatStroke.c:73-75`) and phase 2's decrements (`HeatStroke.c:124-130`). On an older build, or if modding the phases, keep each `IncreaseDiseaseCount` and its `DecreaseDiseaseCount` in the same phase. ### 5. Respiratory PPE ≠ Eye PPE - **Symptom**: eyewear prevents silicosis, or a mask without `DEF_DUST_PARTICLE_EYES` does not prevent squinting. - **Cause**: `AGT_AIRBOURNE_SOLID` uses MASK for `SILICOSIS` and EYEWEAR|MASK|NVG for `EYES_IRRITATION` (`PluginTransmissionAgents.c:414-437`). Squint checks `DEF_DUST_PARTICLE_EYES` (`SquintState.c:25-39`). - **Remedy**: declare both defenses in item config. Cache depth = 2 (`GetProtectionLevelCachedEquipment` `PluginTransmissionAgents.c:577-582`). ### 6. `OnCEUpdate` is no longer the `EffectArea` tick - **Symptom**: custom area does not resize particles / does not iterate. - **Cause**: `EffectArea` overrides `OnCEIterate(float currentTime, float elapsedTime)` (`EffectArea.c:191-195`). Changelog: `OnCEUpdate` obsolete. - **Remedy**: override `OnCEIterate`. `SpawnParticles` anchors to `SurfaceRoadY` (`EffectArea.c:414-417`). ### 7. `Surface.GetStepsParticleID` / `EffWheelSmoke.SetSurface` are obsolete - **Cause**: `Surface.c:64-73`, `WheelSmoke.c:32-35`. The 1.30 pipeline passes `SurfaceInfo` (`VehicleVFXComponent.c:177-186`, `VehicleDust.c:25-35`). - **Remedy**: `SurfaceInfo.GetByName(...).GetStepParticleId()` and `SelectFromSurface`. VFX detail in `dayz-particles`. ### 8. Oil pit only deals damage in `BURNING` state - **Cause**: random delay 3–10 s (`OilPitArea.c:10-11, 52-60`). `HeatDamage` 20.0 damage every 1 s (`OilPitTrigger.c:7-8, 53-70`). - **Remedy**: wait for `AddState(EOilPitState.BURNING)` or trigger seems inert. ### 9. Shadow is not a raycast every 5 s - **Cause**: `ENVIRO_TICK_SHADOW_RC_CHECK = 30` (`constants.c:760`). Capsule 50 m × 0.05 m towards `-GetSunOrMoonDirection()` (`Environment.c:679-719`). Interior, roof or `Car` force shadow true (`:667-676`). - **Remedy**: do not copy "5 seconds" from digests; measure with 30 s timer. ### 10. `Weather.GetNoiseReductionByWeather()` does not govern AI - **Causa**: marcado `[Obsolete]`; el nativo usa `AIParams` incluyendo `sandstormToNoiseMultiplier = 10.0` (`Weather.c:407-467`, `aiconfigs\config.cpp:19-27`). - **Remedio**: HUD/mods → `GetNoiseReductionByWeatherEx(object)`. Infectados → config `AIParams`. Skill hermana: `dayz-ai-patterns`. ## How to verify 1. **Offline linter**: `python <KNOWLEDGE_PACK>/tools/dayz-script-validator/scripts/script_validator.py <addon_root>`. Gate `len(errors) == 0`. 2. **In-game ladder** (DayZ-MCP or Diag `-filePatching`): - **Weather spawn**: on server, `GetGame().GetWeather().GetSandstorm().Start(5, false)`. Client must receive PPE `REQ_SANDSTORMEFFECT` (`ScriptedSandstormController.c:310-327`). - **Shelter**: enter a building with `IsSoundInsideBuilding`; intensity → 0 in 1.5 s. Mount a motorbike: intensity must NOT go to 0. Enter a `Car`: yes. - **PPE**: with dust mask, no cough or silicosis; with glasses, no squint. - **Heat**: sustained high heatcomfort must raise `ThermalBias` and activate `MDF_HEAT_STROKE1..4`. - **WashHead**: reduces 10 `EYES_IRRITATION` (1.6 from bottle) and applies resistance for 30 s (`ActionWashHeadWettingClothesBase.c:46-63`, `ActionWashHeadItemContinuous.c:41`); since 1.30.164289 a wash while the resistance runs no longer lowers the bias or restarts the 30 s, but it still reduces the irritation and wets the clothes (`ActionWashHeadWettingClothesBase.c:53-62`). - **Oil pit**: wait 3–10 s; then 20 HeatDamage/s and `OIL_FIRE1`/`OIL_FIRE2` particles. 3. **RPT** [UNVERIFIED texts]: search for `ThermalBiasHandler`, `Sandstorm`, `Could not get players sandstorm data`. ## Status in 1.30 stable (re-checked on 1.30.164200) Work-in-progress aspects first seen in the Experimental code (1.30.164014), re-checked on stable 1.30.164200 on 2026-10-28: 1. **Nasdara map files** (changed on 1.30.164200): on 1.30.164014 `data_nasdara.pbo` had 6 files (`work\pbo-listing-diff.txt:487`) and there was no `.wrp` or navmesh for the map. 1.30.164200 installs `nasdara\addons\` with 24 PBOs and `worlds_nasdara.ebo`: `worlds_nasdara_nav.pbo` holds `navmesh.nm`, `worlds_nasdara_ce.pbo` the CE files (34 `.xml`, 4 `.json`, `areaflags.map`), and `data_nasdara.pbo` has 8 files (the same 6 plus `mud_brick_impenetrable.bisurf` and `.rvmat`). No PBO lists a `.wrp`; as with Sakhal (`sakhal\Addons\worlds_sakhal.ebo`), the world is presumably in the encrypted `.ebo`, which was not opened. The 1.30.164200 dedicated server ships the mission `mpmissions\dayzOffline.nasdara`. The map was not loaded in game. 2. **Wash Head with frozen bottle** (unchanged on 1.30.164200): `ActionWashHeadItemContinuous` only rejects gasoline (`:32-38`). Matches KNOWN ISSUES from changelog. 3. **Sickness icons** (changed on 1.30.164078, still wrong on 1.30.164200, fixed on 1.30.164289): bug in `HeatStrokePhase1` + `HasDisease` (invariant 4). 4. **ChernarusPlus** (unchanged on 1.30.164200) does not populate `m_TemperatureUnderSunModifier` in `Init` (`ChernarusPlus.c:31-80`); +2/+6/+8 solar table belongs to `NasdaraData` (`Nasdara.c:67-73`). Solar effect in Chernarus stays 0 if map lacks key [DESIGN: empty map lookup]. 5. **Fire particles in OilPitTrigger.UpdateState** (unchanged on 1.30.164200) are `PlayInWorld` without headless guard on ignition branch (`OilPitTrigger.c:105-116`); stop does use `IsHeadlessOrDedicatedServer` in `DeferredInit`. ## Cite-then-verify Paths relative to `E:\DayZ-Exp-Extract\1.30.164014\` (the `exp\` prefix). Since 2026-11-09 the line numbers are those of stable 1.30.164289; the `exp\` paths stay (`_shared/dayz-conventions.md` §Vanilla line numbers: which build). Open file at the line. Digests I/M shifted dozens of citations (e.g. "5 s" shadow, `PluginTransmissionAgents.c:377`, `PlayerBase.c:941`). NEVER copy an `[EXACT]` block from a digest: open it in `exp\`. ## References index - [references/sandstorm-shelter.md](references/sandstorm-shelter.md): native API, `ScriptedSandstormController`, cfgWorlds, JSON, Nasdara `CalculateWind`. - [references/thermal-heatstroke.md](references/thermal-heatstroke.md): `ThermalBiasHandler`, `HeatComfortMdfr`, 4 phases, WashHead, shadow, motorbike/boat. - [references/ppe-agents.md](references/ppe-agents.md): agents, modifiers, symptoms, PPE, cough. - [references/dust-oilpit-nasdara.md](references/dust-oilpit-nasdara.md): `SurfaceInfo`, roofs, oil pit, Nasdara stub, animals. - [references/sources.md](references/sources.md): inventory of reopened files and digest line errors. ## WHAT THIS DRAFT COULD NOT VERIFY 1. **`SandstormController` C++**: progression, magnitude, and `GetPointOnEdge` live in exe. 2. **Nasdara terrain**: no listed PBO of 1.30.164014 or 1.30.164200 has a `.wrp`; on 1.30.164200 it is presumably inside the encrypted `worlds_nasdara.ebo`, which was not opened. 3. **`.p3d` / `.ptc` / `.edds` binaries**: existence via listings; emitter curves [UNVERIFIED]. 4. **`PlayerBase.OnStoreSave` caller of `m_ThermalBiasHandler`**: handler writes `m_TemporaryResistanceTime` (`ThermalBiasHandler.c:67-78`) and is constructed in `PlayerBase.c:426`; digest citation `PlayerBase.c:941-950` is volcanic `OnUpdateEffectAreaServer`, not stream. Did not locate player's `OnStoreSave` in open ranges. 5. **Runtime**: no tick was measured in-game. FIN-SKILL-DRAFT
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.