Omniscye-8BitSound icon

8BitSound

Replaces all in-game audio with real-time 8-bit SNES-style DSP effects using a Harmony patch and a custom runtime bitcrusher.

Last updated 3 weeks ago
Total downloads 465
Total rating 2 
Categories Mods Audio Client-side
Dependency string Omniscye-8BitSound-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
Zehs-REPOLib-2.1.0 icon
Zehs-REPOLib

Library for adding content to R.E.P.O.

Preferred version: 2.1.0

README

8BitSound โ€“ Make Everything Sound Retro

8BitSound is a sound filter mod for R.E.P.O. that makes all in-game audio sound like it's coming from an SNES cartridge.

It dynamically adds a runtime DSP bitcrusher to every sound played in the game using a Harmony patch. No asset bundles, no Unity editor. Pure code.

๐ŸŽง What It Does

  • Simulates 8-bit / SNES / 16-bit console audio
  • Reduces sound fidelity via custom DSP:
    • Lower sample rate
    • Reduced bit depth
    • Replaces Unityโ€™s environmental audio effects

๐Ÿ” How It Works

  • Patches Sound.Play() using Harmony
  • Adds a BitcrusherFilter component to each new sound
  • This filter modifies the audio buffer in OnAudioFilterRead()
  • Customizable bitDepth and sampleRateReduction (hardcoded to SNES-like 4-bit @ 8kHz)

๐Ÿ–ฅ๏ธ How to Use

Just install it โ€“ it runs automatically on all sounds.

Note: The main menu button sounds are very quiet or muted as a side effect of how they are spatially set up. This is expected.

  • Level transitions etc have no sound - This mod applies inside of the level.

๐ŸŽฎ Compatibility

  • Works in singleplayer and multiplayer
  • Compatible with other mods unless they heavily override Sound.Play()

โš™๏ธ Technical

  • No Unity assets or mixer groups required
  • Written entirely in C# with BepInEx + Harmony
  • Fully runtime, attaches to existing AudioSource objects
  • Injects real-time DSP using OnAudioFilterRead

๐Ÿ› ๏ธ Credits

Created by OmniScye
SNES-fy your REPO runs. Chiptune chaos awaits.