Communities

R.E.P.O.Loading...Mimics1.1.3

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

2 weeks ago

Downloads

29K

Size

128KB

Dependency string

ToxesFoxes-Mimics-1.1.3

Download

Details Required (4)Versions

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:

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

Install r2modman from https://github.com/ebkr/r2modmanPlus/releases
Open r2modman and select R.E.P.O
Create or choose a profile
Search for Mimics by ToxesFoxes
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

Setting	Default	Acceptable Values	Description
`Volume`	`30`	`0-100`	Mimic playback volume in percent.
`Hear Yourself?`	`true`	`true` / `false`	If `false`, only other players hear mimic playback.
`Persist Audio Cache`	`false`	`true` / `false`	Enables saving received mimic clips to disk between sessions.
`Persist Max Files Per Player`	`100`	`1-5000`	Max saved recordings per player folder.
`Normalize Target`	`85`	`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.

Setting	Default	Acceptable Values	Description
`Playback Near Radius`	`15`	`5-100`	Preferred radius around players for selecting a mimic target enemy.
`MinDelay`	`10`	`1-300`	Minimum seconds between mimic playback cycles.
`MaxDelay`	`20`	`5-600`	Maximum seconds between mimic playback cycles.
`Playback Voice Filters Enabled`	`true`	`true` / `false`	If `true`, the host randomly applies 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

Menu Keybind (default: F8) — keybind to open the Mimics debug menu in-game.
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

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

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

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

Configure local paths in TFS_Mimics.local.props
Build:

dotnet build TFS_Mimics.csproj -c Release

Output DLL:

bin/Release/TFS_Mimics.dll

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

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
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.