Skip to content

Home

Jump to bottom
Kanisuko edited this page May 29, 2026 · 13 revisions

ScavLib — Scav Prototype Mod API Library

Current Version: 0.5.0

Authors: Kanisuko / QinShenYu

BepInEx GUID: com.kanisuko.scavlib

ScavLib is a foundational developer-focused API and utility library for Scav Prototype (a.k.a. Casualties Unknown). It provides safe, well-documented wrappers around the game's core systems so mod authors can focus on their features rather than boilerplate and null-checking.

Note for players: This is a dependency library. It adds no content on its own and is only needed if another mod requires it.

Requirements

  • BepInEx 5.x (64-bit recommended)
  • Scav Prototype (Steam)

Quick Navigation

Page Description
Getting Started Installation and your first mod
PlayerUtil Player vitals, state queries, drugs, last-stand, writes, and inventory
LimbUtil Per-limb health, bleeding, infection, and bone state
SkillUtil Skill levels, XP, global multiplier
ItemUtil World-space item scanning and manipulation
CustomItemRegistry Register custom ItemInfo definitions
EventBus Event-driven mod patterns + GetHandlerCount diagnostics
CommandRegistry Custom developer console commands + scavlib check
MenuWindow & MenuBuilder In-game IMGUI menus
ConfigManager BepInEx config wrappers
ModRegistry Mod metadata, ModSession, and VersionedDependency
Lifecycle System IModLifecycle, world events, and mod callbacks
Changelog Version history

What's New in 0.5.0

  • PlayerUtil split into partial-class files and completed to near-full Body coverage: drug components, Last Stand, sleep quality, appearance, extended state queries, and the full Set*Raw set.
  • ModSession + VersionedDependency — runtime sessions queryable via ModRegistry.GetSession(name), plus version-range dependency declarations.
  • EventBus.GetHandlerCount — query how many handlers a type has.
  • CommandRegistry query API — GetOwner / GetAllRegistered, powering the scavlib check diagnostic.
  • Per-patch failure isolation — each Harmony patch is applied individually; one failure no longer takes down the whole library.

See the Changelog for the full list.

Verifying Installation

After placing ScavLib.dll in BepInEx/plugins/ and launching the game, open the developer console and run:

scavlib status

You should see ScavLib's version, authors, and all registered mods. Mods registered with a lifecycle object are annotated with [F].

Clone this wiki locally