ExplosiveSprayPaint

A BepInEx/Harmony mod for Lethal Company that gives every spray paint shake a host-authoritative chance to rupture the can.

Default behavior:

5% chance for a normal rupture when shaking a spray paint can.
0.5% chance for a catastrophic rupture, rolled before the normal chance.
The ruptured can is deleted immediately.
The blast is small and non-instant-kill by default, but it can finish off already low-health players.
Nearby enemies and players take modest damage.
Paint splats are spawned around nearby floors and walls using the current spray can color when it can be resolved.
Visual particles, vanilla explosion effect/sound, optional camera shake, and a HUD tip are played client-side.
Only the host/server rolls the explosion chance and applies damage/despawn logic.

Build

Install BepInEx for Lethal Company, then set LETHAL_COMPANY_DIR to your game folder before building:

$env:LETHAL_COMPANY_DIR="C:\Program Files (x86)\Steam\steamapps\common\Lethal Company"
dotnet build -c Release

If you build from a Gale/r2modman/Thunderstore profile, point BEPINEX_PROFILE_DIR at that profile so the project uses its installed BepInEx pack:

$env:LETHAL_COMPANY_DIR="D:\SteamLibrary\steamapps\common\Lethal Company"
$env:BEPINEX_PROFILE_DIR="C:\Users\hunte\AppData\Roaming\com.kesomannen.gale\lethal-company\profiles\ExplosiveSpray"
dotnet build -c Release

If no local BepInEx core folder is found, the project falls back to NuGet compile references for BepInEx/Harmony.

The compiled mod DLL will be in:

bin\Release\ExplosiveSprayPaint.dll

Copy it into:

BepInEx\plugins\ExplosiveSprayPaint\

Config

The config file is generated at:

BepInEx\config\huntedbyacreature.explosivespraypaint.cfg

Important entries:

ExplosionChancePercent: default 5
CatastrophicExplosionChancePercent: default 0.5
EnableScreenShake: default true
EnableHudNotification: default true
GlowInTheDarkPaint: default true
EnableFunnyExplosionPhysics: default false
NormalPlayerDamage: default 20
CatastrophicPlayerDamage: default 45
NormalBlastRadius: default 4
CatastrophicBlastRadius: default 8
NormalPaintSplats: default 28
CatastrophicPaintSplats: default 90

Compatibility Notes

The shake detector patches SprayPaintItem.ItemInteractLeftRight(bool right) and treats right == false as the shake action, which matches current Lethal Company modding practice. If a future game update changes the control mapping, adjust the condition in src/Patches/SprayPaintItemPatches.cs.

Spray paint color and decal prefab fields are partially private and may differ between game builds or spray-paint overhaul mods. SprayPaintIntrospection probes common field names first and falls back to renderer color/generated decals when needed.

Thunderstore Package Layout

Recommended release package:

ExplosiveSprayPaint.zip
  manifest.json
  README.md
  CHANGELOG.md
  icon.png
  BepInEx/
    plugins/
      ExplosiveSprayPaint/
        ExplosiveSprayPaint.dll