Suppression

A bullet suppression effect for BONELAB. When enemy bullets fly close to your head or body, the screen edges darken, the image blurs and gains contrast, sounds get muffled and your ears ring for a moment, so heavy fire actually feels dangerous.

Your own shots never trigger it - only bullets fired by NPCs and other guns.

Features

• Close-pass detection - the mod checks how close each bullet's line of fire comes to your head and chest, and whether something blocks it on the way. Far-away bullets do nothing.
• Screen - the screen edges darken and the vignette slides toward the side the bullets came from. The whole picture gets a little darker.
• Blur and contrast - blur, extra contrast, slight desaturation and a bit of chromatic aberration (optional lens distortion), using the game's own post-processing.
• Sound - everything gets muffled for a moment, with a short ear ringing. Optional bullet whiz sounds and an optional heartbeat.
• Dynamic - the closer the bullet, the stronger the effect. Several bullets in a short time stack up and last longer, but the effect is capped and always fades smoothly. A rare close shot is barely noticeable, heavy fire is intense.
• You always keep full control of movement and weapons. There is no camera shake.

Requirements

• BONELAB (PC)
• MelonLoader
• BoneLib (installed automatically by mod managers)

Tested with BONELAB 1.744.58126 (Steam), MelonLoader 0.7.3 and BoneLib 3.2.2. Multiplayer has not been tested.

Installation

• Mod manager (Thunderstore Mod Manager, r2modman, Gale): just install the mod.
• Manually: put Suppression.dll into the Mods folder of your BONELAB install.

Settings

Open BoneMenu -> Suppression. Everything is saved automatically.

• Main page: Enabled, Intensity, Effect distance (how close a bullet must pass), Visual fade time, Debug log.
• Screen edges: Vignette, Darken, Side vignette (direction), Overlay size.
• Blur and contrast: Post effects on/off, Blur, Contrast, Desaturation, Chromatic aberration, Lens distortion.
• Audio: Muffle strength, Muffle time, Muffle min Hz, Ear ringing volume and time, Heartbeat volume, Bullet whiz sounds (off by default), Whiz volume and distance.

Notes

• Everything is local to your game.
• If the screen darkens but there is no blur or contrast, check MelonLoader\Latest.log for lines starting with [Suppression].
• If the effect is too strong or too weak, change Intensity or Effect distance.

Credits

Made by kamonkus. Built on top of BoneLib.