H3MP Footsteps

Real-time footstep audio sync for H3VR multiplayer (H3MP). Your friends can finally hear you sneaking up on them, nya~

Features

Hear your own footsteps (works standalone without H3MP) and sync everyone else's over H3MP
Fully 3D-spatialized playback (positional, distance-attenuated)
Volume, pitch and cadence vary with movement speed; crouching (physically lowering your head) quiets steps
No footsteps when airborne
Full Kodeman PlayerFootsteps sound-pack compatibility - your existing packs (and bundled defaults) just work
Configurable: master volume, loudness, step cadence, hearing distance, reload the scene to reload the config

Requirements

Friends who also need to install this mod

Known Issues and Limitations

Vibecoding... There might be more bugs I havn't found
Footsteps can be heard through walls etc.
Sometimes you can hear footsteps from players in other maps (wtf?)
Didn't test if it conflicts with Kodeman's PlayerFootsteps, but it's recommended not using this mod when using that one
The config isn't synced over H3MP, so players can cheat to have greater hearing distance etc. (please don't do that to your friends, fair play)

Replacing sounds

Bundled with this mod: 18 default footstep wavs (FreeSound CC audio, see Attributions.txt).

To override with your own sounds, drop wav files named PlayerFootsteps_{Material}*.wav anywhere under BepInEx/plugins/ - exactly the same convention as Kodeman's PlayerFootsteps. Materials: Concrete, Generic, Grass, Gravel, MetalThick, MetalThin, Mud, Meat, SoftMaterial, Water, WoodHeavy, WoodLight, Sand, Brick, Rock, Ice, Glass, SnowNorthestDakota. Example: PlayerFootsteps_Grass_01.wav in any plugin folder replaces the bundled grass sound.

I Asked Myself These Questions

It's really useless and glitchy

Sorry, I'm not good at modding. If you have any suggestions, feel free tell me. (Discord: 妮可_Niko666, I'm in UTC+8 timezone so probably won't respond to messages in time)

I want more

I'll do my best.🫡

Credits

H3VRPluginTemplate
H3MP by TommySoucy
PlayerFootsteps by Kodeman
FreeSound artists
Everybody in H3VR community, especially those who helps me testing this mod

Generative AI Disclosure

This mod (including some parts of this readme) was created using various generative AI models because I'm a dumbass (also netcode is so hard)