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 sounds when health is 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)

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:

Create a zip file named AuthorName-YourModName-1.0.0.zip
Put your OuchPack folder inside a plugins folder at the root of the zip
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/
        plugins/
            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
Volume Multiplier: Adjust volume of all sounds
Enable Last Stand: Toggle last stand sounds
Last Stand Threshold: Health percentage that triggers last stand
Debug Messages: Enable detailed logging