Player Pain Sounds Plugin

A BepInEx plugin for H3VR that replaces the default player injury and death sounds with customizable sound packs.

There is also a last stand feature for playing a dramatic sound or music when at low health. By default this health percentage is 25%.

The game must boot up at least once with a detectable OuchPack for it to be selectable from the configuration file.

Hopefully I did not break anything by making this.

Features

• Replaces both player injury and death sounds with custom sound packs
• Support for multiple sound packs with in-game configuration menu
• Configurable volume control for all sound categories
• Runtime configuration via ConfigurationManager
• Sound selection based on damage amount:
  • Low damage (≤5% max health): pain_low sounds
  • Medium damage (5-20% max health): pain_default sounds
  • High damage (≥20% max health): pain_high sounds
• Last stand looping sound when health is below 25%
• Critical health alert sound when health dips below 25%

Sound Pack Structure

Required sound categories (minimum for pack to work):

• pain_default: General injury sounds
• death: Played when the player dies

Optional sound categories:

• pain_high: High damage sounds (played when damage is >= 20% of max health)
• pain_low: Low damage sounds (played when damage is <= 5% of max health)
• last_stand: Looping sound played when health is below 25% (like a heartbeat)
• (NEW)critical_health: Alert sound that plays once when you go below 25% health, like the HEV suit in Half Life.

If optional categories are missing, the plugin will fall back to using pain_default sounds.

The directory names (pain_default, death, etc.) must match exactly, but the sound files themselves can be named anything as long as they are WAV or OGG files.

Packaging for Thunderstore

When packaging your sound pack for Thunderstore:

1. Create a zip file named AuthorName-YourModName-1.0.0.zip
2. Put your OuchPack folder inside a plugins folder at the root of the zip
3. Include manifest.json, README.md, and icon.png at the root of the zip

Example of what your zip should contain:

AuthorName-YourModName-1.0.0.zip
├── plugins/
│   └── OuchPack/
│       └── YourSoundPack/
│           ├── pain_default/
│           │   ├── sound1.wav
│           │   └── sound2.ogg
│           └── death/
│               ├── sound1.wav
│               └── sound2.ogg
├── manifest.json
├── README.md
└── icon.png

When installed, it will be extracted to your plugins folder like this:

BepInEx/plugins/
    AuthorName-YourModName/
            OuchPack/
                YourSoundPack/
                    pain_default/
                        sound1.wav
                        sound2.ogg
                    death/
                        sound1.wav
                        sound2.ogg
        manifest.json
        README.md
        icon.png

Configuration

After installing a new sound pack, you must edit the configuration to enable it. By default, the plugin starts with no sound packs enabled. Open the configuration menu in-game to select your desired sound pack.

OGG and WAV files are supported. MP3 files are not supported.

Configuration Settings

Sound Pack: Select which sound pack to use for player injury and death sounds.
Volume Multiplier: Adjust the volume of all injury and death sounds (0.0 to 2.0).
(NEW) Play Pain With Death: If enabled, a pain sound plays immediately before the death sound.
Enable Last Stand: Enable looping sound when at low health.
Last Stand Threshold: Health percentage that triggers the last stand sound.
(NEW) Enable Critical Health Sound: Enable a one-time sound when health drops below the critical threshold.
(NEW) Critical Health Threshold: Health percentage that triggers the critical health sound.
Debug Messages: Enable detailed logging for troubleshooting.

Version 1.0.4

• More comprehensive workaround for Supply Raid bug implemented
• New Impact sound system which supports bullet/projectile impacts and generic player impacts
• Pain sound overlap enable/disable setting
• Pain sound enable/disable setting

Version 1.0.3

• More minor bug fixes, tweaks to make the audio more consistent.

Version 1.0.2

• Fixed extra plugins folder in the README when describing what your extracted folder structure should look like.

Version 1.0.1

• Rewritten from the ground up for scalability (hopefully I didn't break anything)
• Added critical health alert sound and threshold.
• Added the ability to play pain sound just before the death sound.
• (Hopefully) Fixed Supply Raid death bug caused by both mods reacting to death simultaneously.
• Injury sounds no longer play at the point of impact.
  • Point of impact sounds will be added later for non-vocal impact sounds.
• Non-harming hits to the player (e.g., flash grenades, zero-damage shockwaves) no longer trigger pain sounds.

Version 1.0.0

• Initial Release