Mimics Mod for R.E.P.O

Mimics adds a voice-mimic mechanic to monsters in R.E.P.O. They can replay random phrases recorded during gameplay, making it harder to trust what you hear.

📖 Description

Think that was your teammate calling for help? Think again. Mimics brings a Skinwalker-style mechanic into R.E.P.O by allowing monsters to mimic player voices using random recorded phrases.

🎯 Who Needs This Mod

Both Host and Clients need to install this mod to work.

🧩 Compatibility

This mod is incompatible with mods:

1. Disable Noise Reduction by SVRZ, as it relies on the game's built-in noise reduction to capture audio and send chunks to other players correctly.

✨ Features

• Monsters mimic player voices recorded during the current session
• In multiplayer, all players hear the same mimic clip on the same enemy at the same time
• Voice can be played back with a random pitch or alien filter — the host decides which, so all players hear the same effect
• Custom audio support — drop your own .mp3, .wav, or .ogg files into the custom-audio folder to add more sounds to the mimic pool
• Mod authors can register custom clips at runtime via the public MimicsAPI

📦 Installation via r2modman

1. Install r2modman from https://github.com/ebkr/r2modmanPlus/releases
2. Open r2modman and select R.E.P.O
3. Create or choose a profile
4. Search for Mimics by ToxesFoxes
5. Install the mod

Dependencies are pulled automatically:

• BepInEx-BepInExPack-5.4.2305
• nickklmao-REPOConfig-1.2.6
• nickklmao-MenuLib-2.5.2
• Rune580-REPO_SteamNetworking_Lib-0.1.2

⚙️ Mod Settings

Settings are stored in the BepInEx config file:

<REPO_PROFILE>/BepInEx/config/TFS_Mimics.cfg

General

• Volume (default: 30, range: 0-100) — mimic playback volume in percent.
• Hear Yourself? (default: true) — if false, only other players hear mimic playback.
• Persist Audio Cache (default: false) — enables saving received mimic clips to disk between sessions.
• Persist Max Files Per Player (default: 100, range: 1-5000) — max saved recordings per player folder.
• Normalize Target (default: 85, range: 0-100) — peak normalization target for voice and custom audio (0 = off, 100 = 0 dBFS).

Host Only

These settings only take effect on the player who is host. Clients can leave them at defaults.

• Playback Near Radius (default: 15, range: 5-100) — preferred radius around players for selecting a mimic target enemy.
• MinDelay (default: 10, range: 5-300) — minimum seconds between mimic playback cycles.
• MaxDelay (default: 20, range: 10-600) — maximum seconds between mimic playback cycles.
• Playback Voice Filters Enabled (default: true) — if true, the host randomly applies a pitch or alien voice filter to playback. All players hear the same effect.

Filter

• Filter Enabled? (default: false) — enables per-enemy mimic filter.

Experimental

• Sampling Rate (default: 48000, range: 16000-48000) — microphone and processing sample rate.

Debug

• Verbose Logging (default: false) — enables detailed debug logs.

📁 Custom Audio

Drop your own sound files here to add them to the mimic pool:

<REPO_PROFILE>/BepInEx/plugins/ToxesFoxes-Mimics/custom-audio/

Supported formats: .mp3, .wav, .ogg.

If persistence is enabled, recorded clips are saved here:

<REPO_PROFILE>/BepInEx/plugins/ToxesFoxes-Mimics/audio-cache/
    players.json
    <player_id>/audio_<player_id>_<guid>.bin

🧭 Roadmap

Planned: context-aware audio playback linked to gameplay events, for example:

• Enemy sees player
• Enemy hits player
• Player death / damage
• Item destroyed

Goal: make mimic behavior feel more believable and tied to events, instead of only random timing.

📝 Requirements

• R.E.P.O (Steam)
• BepInEx pack for R.E.P.O
• Rune580-REPO_SteamNetworking_Lib
• Windows OS

⚠️ Disclaimer

• This mod is not affiliated with or endorsed by the developers of R.E.P.O
• Use at your own risk
• Always back up your saves before using any mods

📞 Support

• 🐛 Report Issues
• 📧 Contact: [email protected]

🔧 Manual Installation

1. Install BepInEx for R.E.P.O
2. Download the latest release from:
   • Thunderstore: https://thunderstore.io/c/repo/p/ToxesFoxes/Mimics/
   • GitHub: https://github.com/ToxesFoxes/Repo-Mimics/releases
3. Copy TFS_Mimics.dll into your plugins folder:

<REPO_PROFILE>/BepInEx/plugins/ToxesFoxes-Mimics/TFS_Mimics.dll

1. Launch the game

🔍 Differences From Original Mimic

This mod is a full rework focused on compatibility with newer R.E.P.O versions and long-term stability.

• Reworked enemy discovery for newer game versions instead of relying on a fixed scene path.
• New audio transmission pipeline with per-transmission tracking and improved chunk handling.
• Backward-compatible network receive path for older packet format support.
• Improved recording flow with pre-speech capture and smarter silence handling.
• Persistent audio cache with per-player storage and players index.
• Safer runtime behavior with additional validation, stale transmission cleanup, and better diagnostics.
• Expanded configuration options for playback radius, persistence, filters, and debug logging.
• Host-authority sound sync — greedy set-cover algorithm selects the minimum number of enemies needed to cover all nearby players. Host decides the voice filter mode (none / pitch down ×0.5 / pitch up ×1.2 / alien) and broadcasts a SyncPlayCommandPacket so every client plays the exact same clip with the exact same effect simultaneously.
• Custom audio folder — add your own .mp3, .wav, or .ogg files without writing any code; mod authors can also register clips at runtime via MimicsAPI.

🛠️ Build from Source

1. Configure local paths in TFS_Mimics.local.props
2. Build:

dotnet build TFS_Mimics.csproj -c Release

1. Output DLL:

bin/Release/TFS_Mimics.dll

For one-command build and deploy, see README.build.md.

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

🙏 Credits

• Harmony - Harmony Patching Library
• BepInEx - BepInEx Mod Loader
• r2modman - r2modmanPlus Mod Manager
• Thunderstore - Thunderstore Mod Hosting
• Mimic - Original mod for R.E.P.O v0.3.0 and lower by eth9n
• R.E.P.O - Game by semiwork
• ToxesFoxes - Mod development
• Contributors - See GitHub contributors page for details

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤖 AI Content Disclaimer

This project used AI-assisted tooling during development for debugging, bug fixing, and technical iteration support.

• AI assistance was used as a development aid, not as an autonomous publisher.
• Final implementation decisions, integration, and testing were performed manually by the author.
• This notice is provided for transparency regarding the development workflow.