Better Low Health Warning

A lightweight BepInEx mod for SULFUR that adds a stronger and more visible low-health warning.

When your health gets low, this mod displays a soft red vignette around the screen.
The effect becomes stronger as your health gets lower.

What This Mod Does

This mod adds a configurable visual warning when the player is at low health.

Default behavior:

Health above 35%        -> no extra warning
Health at 35% or below  -> soft red vignette warning
Health at 15% or below  -> stronger critical warning

The warning fades in and out smoothly.

Pulse animation is enabled by default.

Why

SULFUR already has a low-health HUD indicator, but it can be easy to miss during combat.

This mod makes low health easier to notice without changing game balance.

What This Mod Does NOT Do

This mod does not change:

Player health
Max health
Enemy damage
Healing amount
Food effects
Medicine effects
Difficulty
Enemy behavior
Original HUD logic

It does not automatically heal the player.

It does not make the player invincible.

It only adds a stronger visual warning.

Configuration

After launching the game once with the mod installed, a config file will be generated at:

BepInEx/config/kumo.sulfur.better_low_health_warning.cfg

Default config:

[General]

EnableMod = true
HideWhenHudHidden = true

[Visual]

WarningHealthPercent = 0.35
CriticalHealthPercent = 0.15
BorderThickness = 160
MinOpacity = 0.08
MaxOpacity = 0.42
EnablePulse = true
PulseSpeed = 2.2
FadeSpeed = 10
FullscreenTintOpacity = 0.035

[Debug]

LogErrors = false

EnableMod

EnableMod = true

Set this to false to disable the mod without uninstalling it.

HideWhenHudHidden

HideWhenHudHidden = true

When enabled, the warning is hidden when the game HUD is hidden.

WarningHealthPercent

WarningHealthPercent = 0.35

The health percentage where the warning starts.

Examples:

0.50 = 50%
0.35 = 35%
0.25 = 25%

CriticalHealthPercent

CriticalHealthPercent = 0.15

The health percentage where the warning reaches its stronger critical state.

Examples:

0.20 = 20%
0.15 = 15%
0.10 = 10%

BorderThickness

BorderThickness = 160

Controls the thickness of the soft red vignette in pixels.

Higher values make the warning reach further inward from the screen edges.

MinOpacity

MinOpacity = 0.08

The opacity of the warning when health first drops below the warning threshold.

MaxOpacity

MaxOpacity = 0.42

The opacity of the warning at or below the critical threshold.

Lower this value if the effect feels too strong.

EnablePulse

EnablePulse = true

Enables or disables the pulsing warning effect.

PulseSpeed

PulseSpeed = 2.2

Controls how fast the warning pulses.

Higher values pulse faster.

FadeSpeed

FadeSpeed = 10

Controls how quickly the warning fades in and out.

FullscreenTintOpacity

FullscreenTintOpacity = 0.035

Adds a very subtle full-screen red tint.

Set this to 0 if you only want the edge vignette.

LogErrors

LogErrors = false

Set this to true only for debugging.

For normal gameplay, keep this set to false.

Installation

Thunderstore / r2modman

Install the mod through Thunderstore Mod Manager or r2modman.

Make sure the required BepInExPack dependency is installed.

Manual Installation

1. Install BepInExPack for SULFUR.
2. Start the game once so BepInEx creates its folders.
3. Place BetterLowHealthWarning.dll into:

BepInEx/plugins/

1. Start the game.

Compatibility

This mod should be compatible with most mods.

It does not edit original game files.

It does not modify health values, damage values, healing values, items, enemies, weapons, or loot.

If another mod replaces or heavily modifies the player HUD, this mod may need an update.

Uninstallation

Remove:

BepInEx/plugins/BetterLowHealthWarning.dll

Optionally remove:

BepInEx/config/kumo.sulfur.better_low_health_warning.cfg

Changelog

1.1.0

• Replaced hard red border with a softer red vignette.
• Added smooth fade in/out.
• Added subtle full-screen tint option.
• Adjusted default visual settings for a cleaner look.

1.0.0

• Initial release.
• Added configurable low-health red border warning.
• Added critical-health stronger warning state.
• Added optional pulse effect.
• Added configurable thresholds, opacity, and border thickness.