Changelog

Changelog

---

0.3.0 — 2026-05-24

PlayerUtil — Full Body Coverage

PlayerUtil has been expanded to cover virtually every writable field on the player Body component, up from the ~15 methods in 0.2.3. The new additions are organized into named sections within the source file:

• Circulation / Blood — BloodViscosity BloodVesselSize FibrillationProgress HeartRatePressureOffset FibrillationForced HasPulmonaryEmbolism StrokeAmount
• Adrenaline — Adrenaline CurAdrenaline
• Infection / Toxicology / Sepsis — SepticShock SicknessAmount VenomTotal VenomCurrent
• Bleeding — InternalBleeding Hemothorax
• Neurology / Psychology — Shock PainShock TraumaAmount RadiationSickness HorrifiedLevel FocusedLevel BrainGrowSickness
• Happiness / Weight — HappinessBase WeightOffset
• External Conditions — Wetness Dirtyness SnowAmount HearingLoss
• Claws — ClawHealth ClawRegrowTime
• Immunity — Immunity AntibioticImmunityTime
• Stimulants — Caffeinated
• Appearance — Disfigured EyeGone BothEyesGone
• Sleep — Sleeping BadSleepAmount
• Read-only derived properties — AveragePain TotalBleedSpeed IsBreathing IsInWater HasScubaGear IsStanding IsCrouching IsOnHardStimulants UsedNeuralBooster

Each writable field provides both a Get read and a SetRaw direct-field write with Mathf.Clamp protection. The two-path convention (recommended writes vs. Raw writes) introduced in 0.2.0 is preserved throughout.

---

PlayerUtil.Thresholds — Expanded Constants

PlayerUtil.Thresholds has been expanded from ~50 to 60+ named constants, now covering every threshold used by the game's moodle system:

Category	Constants added
Blood pressure	CRITICAL_LOW LOW_1~3 HIGH_1~3 CRITICAL_HIGH
Bleeding speed	CRITICAL HEAVY MEDIUM
Internal bleeding	CRITICAL
Hemothorax	PRESENT HEAVY
Stroke	CRITICAL
Happiness	Full 8-tier scale (MISERABLE → HAPPY_4)
Weight offset	Full 8-tier scale (UNDERWEIGHT_4 → OVERWEIGHT_4)

All values were extracted directly from MoodleManager.AddAllMoodles() and match the thresholds used by the game's own UI.

---

LimbUtil — Aggregate Queries

LimbUtil gains several new aggregate query methods:

• HasBrokenBone() — true if any non-dismembered limb is broken
• HasDislocation() — true if any non-dismembered limb is dislocated
• HasInfection() — true if any non-dismembered limb has an active infection
• HasDismemberment() — true if any limb has been dismembered
• GetMaxInfection() — highest infection amount across all limbs (0 ~ 100)
• GetAveragePain() — mirrors Body.averagePain
• GetTotalBleedSpeed() — total bleed speed across all limbs

---

Bug Fixes

• PlayerUtil.HealAll() — Now also resets shock, adrenaline, curAdrenaline, painShock, traumaAmount, wetness, dirtyness, hearingLoss, hasPulmonaryEmbolism, venomCurrent, venomTotal, internalBleeding, hemothorax, and clawHealth — fields that were silently left dirty in 0.2.x.

---

Breaking Changes

None. All additions are purely additive. Existing 0.2.x mod code compiles against 0.3.0 without modification.

---

0.2.3

Bug Fixes

• ​PlayerUtil​ — Fixed wrong namespace (ScavLib_API.util → ScavLib.util) and wrong access modifier (internal class → public static class). The class was previously invisible to all external mods.
• ​ItemPickupPatch​ — Removed unused bool force parameter from the Postfix signature to eliminate unnecessary Harmony reflection binding.
• ​CommandRegistryPatch​ — Added [HarmonyPriority(Priority.High)] to guarantee commands are registered before WorldLoadedEvent fires.

Added

• ​PlayerUtil​ — 9 new methods:
  • GiveItem(string id) — Spawn item at player feet and auto-pickup
  • TakeItem(string id) — Drop first matching item from inventory
  • HasItem(string id) — Check surface inventory by ID
  • GetAllItems() — Get all slot inventory items
  • IsAlive() / IsConscious() / IsDying() — State queries
  • GetHunger() / GetThirst() — Vital reads

---

0.2.2

Bug Fixes

• ​MenuManager​ — Fixed menu windows not rendering. Migrated MenuManager from a standalone DontDestroyOnLoad GameObject to a MonoBehaviour renderer attached to PlayerCamera. Removed the now-unused MenuWindowStyle enum.

---

0.2.1

Bug Fixes

• ​PlayerUtil​ — Fixed Body.PickUpItem call signature: parameter type corrected from Item it to Item item.

---

0.2.0 — 2026-05-23

New Modules

• ​PlayerUtil​ — Vital sign reads, state queries, recommended writes, raw writes, inventory shortcuts, and PlayerUtil.Thresholds (~50 named constants from the game's moodle system).
• ​SkillUtil​ — Typed SkillType enum, level/XP reads, XP writes, raw level set, global XpMultiplier.
• ​ItemUtil​ — World-space item scanning, safe condition modification, favourite toggling, safe destruction, global registry queries.
• ​CustomItemRegistry​ — Register custom ItemInfo definitions into Item.GlobalItems with automatic injection timing.

Event System

• Added pre-defined game events: WorldLoadedEvent, ItemPickedUpEvent, ItemDroppedEvent — triggered automatically via Harmony, no manual patching required.
• EventBus.Post<T> now dispatches along the full inheritance chain.
• Exception isolation improved: handler errors now include event type context in the log message.

Improvements

• ​GameUtil​ — Added IsWorldLoaded, GetWorld(), SpawnItemAt(id, Transform), Notify().
• ​ModRegistry​ — Added TryFind(name, out ModInfo) and IsRegistered(name). Duplicate registration now logs a warning instead of silently succeeding.

Bug Fixes

• ​MenuWindow​ — Fixed auto-height: Height = 0 now uses true IMGUI content-adaptive sizing instead of a hardcoded 400px fallback.
• ​MenuManager​ — Removed erroneous using UnityEngine.Windows reference.
• ​CommandRegistry​ — Removed dead Init() body; method is now a documented extension point called explicitly from ScavLibPlugin.Awake().

Breaking Changes

• EventBus.Post<T> now dispatches to base-type subscribers. Only affects code subscribing to BusEvent directly, which was not meaningful in 0.1.0.
• MenuWindow with Height = 0 now resizes to content instead of 400px. Add public override float Height => 400f to restore the previous behavior.

---

0.1.0 — Initial Release

• MenuWindow / MenuBuilder — IMGUI menu framework.
• ConfigManager — BepInEx config wrapper.
• EventBus / [Subscribe] / BusEvent — Attribute-based event bus.
• CommandRegistry / BaseCommand — Console command registration.
• GameUtil — Basic player state and item spawning helpers.
• ModInfo / ModRegistry — Mod metadata registration.