Mirage

Mirage is a mod that gives any enemy the ability to mimic a player's voice (fully synced to all players).
This mod is required by the host and on all clients. Clients that do not have the mod will run into desynchronization issues.

Features

• Mimic the voice of a player for any enemy (such as bracken, dress girl, modded enemies, etc)
  • Use the same player's voice every time it attempts to mimic their voice
  • Voice is synced to all players, where everyone hears the same voice
  • Only masked enemies mimic voices by default, other enemies can be enabled via config
• Spawn a masked enemy on player death (like a player turning into a zombie)
  • Chance to spawn on death can be configured
  • Set this to 0 to disable the feature
  • Can be configured to only spawn if the dying player is alone
• Masked enemies use the mimicking player's suit
• Remove the mask off of masked enemy
• Remove the arms out animation off of masked enemy
• Remove the post-round credits penalty (configurable)
• Configuration is synced to all players (only the host's config is used)

Discord

If you have questions, and/or want to stay up-to-date with the mod:

1. Join the lethal company modding discord.
2. Go to the mirage release thread and ask your question!
3. Optional: If you'd like to see a sneakpeek on what's potentially coming in v2.0.0, click here.

Why do players who disconnect no longer get their voice mimicked?

Voices of each player are stored on the respective player's individual storage. Since the player is no longer connected, their client cannot send audio clips to other clients.

I have a suggestion for the mod, and/or have found a bug

Whether you have a suggestion or have a bug to report, please submit it as an issue here.

Frequently asked questions

Do I need Skinwalkers for this mod to work?

No, Mirage is a standalone mod. Installing both Mirage and Skinwalkers will result in some voice clips to be unsynced.

Can I use MaskedEnemyOverhaul with this mod?

MaskedEnemyOverhaul will cause the masked enemy's suit and mimicking voice to not match.
Use MaskedEnemyOverhaulFork instead, with the Dont Touch MaskedPlayerEnemy.mimickingPlayer configuration set to true.

Do I need DissonanceLagFix installed?

No. Mirage now applies the lag fix patch as of v1.0.16.

Does this mod support cosmetics?

Yes, any mod that applies to masked enemies should be compatible with Mirage.
If the cosmetic mod you use does not support masked enemies, you will need to request the mod author to support it.

Does this mod use voice recognition and/or AI?

Not currently, but it is currently a work in progress and will eventually come in v2.0.0.

Can I hear my own voice from voice mimics?

By default, yes. You can configure to not be able to hear them while alive, and resume being able to hear them while spectating.

Recommended mods

• StarlancerAIFix - Fixes a vanilla error referencing EnableEnemyMesh.
• LCMaskedFix - Fixes vanilla issues with masked enemies.
• FixRPCLag - Another lag fix mod that you should have.
• EnemyFix - Failsafe for when mod conflicts occur, enemies will still gracefully despawn.
• GeneralImprovements - Quality of life, as well as the option to disable player name tags (to make it harder to spot masked enemies).
• LethalQuantities - Spawn control. Use this to modify the masked enemy's spawn rate.

Can I reupload the mod to Thunderstore?

No, reuploading the mod to Thunderstore is not permitted. If you are creating a modpack, please use the official mod.
If you're making small changes for your friends, you will need to share the compiled .dll directly with them, and then import it locally.

Acknowledgements

• RugbugRedfern - Mirage is heavily inspired by Skinwalkers. Thank you for creating one of the best mods in the game!
• Evaisa - For creating the amazing UnityNetcodePatcher, which this mod uses during its build process.
• Owen3H - For their synced configuration implementation, as well as bringing up issues with the approach taken from the modding wiki.
• MartinEvans - Author of dissonance, for helping me out with voice activity related issues.

Changelog

To stay up to date with the latest changes, click here to view the changelog.

Changelog

1.1.1

• Add configuration option ImitateMode to change how a recording is picked.
  • Set this to Random to keep the current behaviour (recordings are picked completely random).
  • Set this to NoRepeat to avoid repeating the same recording (this can still happen when not many recordings exist). Here is how it works:
    • A pool of recordings is filled.
    • A recording is randomly picked, and then removed from the pool.
    • When pool becomes empty, it becomes filled again.
• SpawnOnPlayerDeath no longer spawns an enemy if the player is not on a navmesh.
  • Previously, this was band-aid fixed by preventing a spawn if the player died by gravity.
  • CauseOfDeath: Gravity no longer prevents the masked enemy from spawning, meaning ladders can spawn them properly now.
  • Note: Many areas throughout the map such as standing on top of a railing is detected as a missing navmesh. Such areas will prevent SpawnOnPlayerDeath from spawning a masked enemy.

1.1.0

• Rewrote the config syncing logic. Thanks to Owen3H (author of CSync) for their config syncing implementation.
• DeleteRecordingsPerRound has been slightly reworked.
  • Setting this to true is unchanged (recordings get deleted after the lever is pulled, per round).
  • Setting this to false now only deletes when closing the game.
  • Default value is now set to false.
• MuteLocalPlayerVoice is now set to true as the default.
• EnablePenalty is now set to true as the default.
  • To clarify, setting this to true is the vanilla behaviour.
  • This will likely be removed in a future update, as it's a relic of the past back when Mirage had different goals.

1.0.16

• Fixed a bug that caused the ship teleporter to not work if SpawnOnPlayerDeath spawned a masked enemy
• DissonanceLagFix is no longer needed when using Mirage
• Modify configuration descriptions to hopefully be easier to understand
• Modify configuration default values

1.0.15

• Fixed a mod conflict issue that caused enemies to not despawn properly
• SpawnOnPlayerDeath no longer spawns an enemy when CauseOfDeath = Gravity (this means dying to fall damage, and I believe dying to the ladder as well)
  • This was originally done by jarylc, but I tried alternatives to avoid having the mechanic completely ignore dying to gravity
  • This is probably the best band-aid fix for now for avoiding log spam when a masked enemy spawns inside a pit

Huge thanks to TheDebbyCase for their immense effort on bug-testing and figuring out a way to reproduce errors that others have been experiencing. Thanks to dinogolfer from TMLC for figuring out why non-masked enemies weren't despawning as well, which helped me understand why this mod conflict was even happening.

1.0.14

• Fixed a bug where some enemies types didn't mimic voices
• Add configuration option to always mute the mimicking voice of a local player
  • Set AlwaysMuteLocalPlayer to true to never hear your voice at all (even while dead)
  • This ignores the MuteLocalPlayerVoice value if enabled
  • This value is not synced to all clients, as it's an optional feature for those who don't want to hear their own voice

1.0.13

• AdvancedCompany cosmetics now properly apply on hosts (previously only applied on non-hosts)
• Fixed a bug that caused MuteLocalPlayerVoice to get ignored

1.0.12

• Mimicked voices should now sound a lot more like an actual player's voice (changed audio filters)
• SpawnOnPlayerDeath no longer spams an error if a player falls into the void
• Masked enemies no longer mimic voices if it was spawned after a player falls into the void

1.0.11

• Hotfix: Revert the crossed-out change from v1.0.10, which caused non-host players to not hear any voices

1.0.10

• Fixed dress girl issues
  • Mimicking voice is now muted while the dress girl is invisible
  • In singleplayer, dress girl will always mimic the local player's voice
  • In multiplayer, dress girl will always mimic the non-local player's voice
• Bees no longer mimic voices when EnableModdedEnemies is enabled.
• Add configuration option to mimic voices for locust swarms
• Fixed navmesh error spam when an enemy tries to calculate its path
• Recordings deletion can now be ignored (not synced to all players)

1.0.9

• Ship camera now spectates the correct masked enemy
• Recording deletion can now be configured in two ways:
  • DeleteRecordingsPerRound = true to delete recordings per-round
  • DeleteRecordingsPerRound = false to delete recordings per-game
• Recordings now automatically delete upon closing the game

1.0.8

• Fixed a bug where voice filters weren't being applied, causing mimicked voices to behave unpredictably
• Fixed a bug where SpawnOnPlayerDeath could spawn two masked enemies in certain scenarios

1.0.7

• Hotfix: If the local player's mimicking voice is muted, it now becomes unmuted when the player is dead

1.0.6

Thanks to jarylc for the initial fixes for masked enemy spawns.

• Rewrite masked enemy spawn and mimicking logic
  • This is less invasive now and should conflict with other mods less often
  • Fixed a bug where naturally spawned masked enemies weren't synced properly
• Fixed a bug where players not haunted by the ghost girl could hear the mimicking voice.
• Add configuration option to only spawn player on death, when the dying player is alone
• Add configuration option to mute the mimicking voice when mimicking the local player
• Add configuration option to adjust voice mimicking delay for non-masked enemies
• Add configuration option to mimic voices on modded enemies

1.0.5

• Use audio filters to sound more like vanilla voices
• Mimicked voices on the outside can no longer be heard from inside the facility (and vice-versa)
• Masked enemies no longer mimic voices while hiding on the ship

1.0.4

• Support voice mimicking on all vanilla enemies.
• Add configuration option for mask texture and arms-out animation (for masked enemies).
• Dead enemies no longer mimic voices.

1.0.3

• Support voice activity.

1.0.2

• Bundled all dependencies I control into a single core lib (users now pull less packages).

1.0.1

• Spawn on player death is now configurable.
• Naturally spawned masked enemies now mimic a player at random.
• Dependencies are now separated into its own packages.

1.0.0

• Initial release.