R.E.P.O. Mutators

Inject some chaos (and possibly despair) into your R.E.P.O. runs with Mutators! A random modifier will be chosen to alter your current level in some way. NOTE: Everyone needs this mod for it to work. FOR THE BEST EXPERIENCE IT IS RECOMMENDED THAT EVERYONE IS ON THE EXACT SAME VERSION OF THE MUTATORS MOD. Singleplayer currently experimental.

Current Mutators

• Apollo 11 – All players and items have zero gravity.
• Rusty Servos – Players can't jump but gain increased grab range.
• Ultra-Violence – Immediately activates the final extraction phase.
• Handle with Care – All valuables are worth double, but they break instantly.
• One Shot, One Kill – Any damage taken by a player is lethal.
• Duck This – Ducks aggro on sight instead of on interaction.
• Out With a Bang – Enemies explode upon death.
• Hunting Season – No valuables spawn; weapons spawn instead. Enemy respawn time is reduced to 10 seconds, and the orb drop cap is removed.
• Protect the President – A random player becomes the "President." If they die, everyone else self-destructs.
• There Can Only Be One - All enemy spawns are the same monster (e.g. all Robe.)
• Volatile Cargo - Valuables explode when destroyed, explosion size and damage scales with value.
• Sealed Away - Valuables have a chance to spawn weakened monsters when destroyed.

Configuration

• Mutators are selected via a weighted random system. The weight of each mutator can be adjusted in the config.
• Setting a mutator’s weight to 0 will prevent it from being selected.
• Mutators can be locked between certain levels.
• Some mutators have additional config options. These may be documented in the future. For now, check your config file.
• The host's config always takes precedence. If this does not appear to be the case, please submit a bug report.

Versioning

• The mod launches at version 0.0.1.
• While below version 1.0.0, breaking changes will occur on MINOR version bumps.
• After 1.0.0, breaking changes will be reserved for MAJOR version bumps.
• Changes to mutators will always occur on a MINOR version bump, unless they cannot cause desyncs—then they will happen on a PATCH.

Upcoming features

• More mutators
• Support for multiple mutators active at once (planned for version 2.0.0)
• General improvements to mutators and internal systems

Suggestions and issues

Suggestions can be made in the dedicated thread in the R.E.P.O. Modding Server on Discord or though Github issues. Any issues found may also be reported though these channels, although creating a Github issue is is preferred.

For developers

Interested in contributing? Check out the GitHub repository. Please make sure to follow the versioning guidelines outlined above.

Adding Mutators via Your Own Mod

You can register your own mutators without including them in this mod:

• Use the MutatorManager static singleton to register custom mutators.
• Mutators are currently NOT namespaced. However, this will likely change in the future.
• Use the .dll file included in the mod download for now. A NuGet package may be released later if there’s enough demand.
• See the GitHub repo for code examples and documentation.

v0.3.1

• Prevent mutator description popping up when other players use their map tool
• Make custom UI elements disappear while in the ESC menu

v0.3.0

• Improve codebase maturity
• Add mutator descriptions, including a bunch of related configuration
• Add "bad luck protection" on mutator selection logic
• Add singleplayer support (experimental)
• Force the game to be more lenient with maximum allowed of active monster orbs on the level while Hunting Season is active
• Add Sealed Away mutator
  • Breaking valuables has a configurable chance to spawn a monster
  • These are permanent additions to your level, they respawn just like normal monsters
  • Sealed monsters have had their powers siphoned
    • Sealed monsters do not have an orb drop limit
    • Sealed monsters have significantly reduced health and appear smaller than their normal counterparts

v0.2.3

• Fix ArgumentOutOfRangeException causing infinite loading screen while the There Can Only Be One mutator is active

v0.2.2

• Fix enemy blacklist for Ultra-Violence and Hunting Season being applied after enemies had already been chosen

v0.2.1

• Add the option to enable instant revive in truck or active extraction point for the One Shot, One Kill mutator. Disabled by default
• Disable healing friends during One Shot, One Kill. No more accidentally one shotting yourself
• Disable the spawning of monsters that do not drop an orb while the Hunting Season mutator is active
• Increase player grab range as if 3 levels higher while Rusty Servos is active
• Add configurable monster spawn blacklist to Ultra-Violence
• Prevent custom keybinds from triggering while having chat open

v0.2.0

• Fix issue where the Hunting Season mutator would spawn weapons which had already been used
• Add more bang to the Out with a Bang! mutator, explosion size and damage now scales with enemy difficulty tier
• New mutators: There Can Only Be One, Volatile Cargo
• There Can Only Be One: All enemy spawns are the same monster, e.g. all Robe
• Volatile Cargo: Valuables explode when destroyed, explosion size and damage scales with value

v0.1.4

• Fix issue that would cause items that spawn other items onDestroy to crash the Hunting Season Mutator setup

v0.1.3

• Fix issue that would cause client mutators to desync from the host's when returning to lobby after the arena

v0.1.2

• The Duck Mutator This now always attempts to spawn a duck
• Make current mutator and target (e.g. president) UI elements size configurable
• Add configurable keybind to hide current mutator UI, bound on H by default

v0.1.1

• Fix enemies getting affected by Apollo 11 Zero-Gravity
• Add configurable keybind for downwards momentum to Apollo 11
• Add configurable Y position for current Mutator overlay

v0.1.0

• Add the ability to lock mutators between configurable levels
• Add config option to prevent the surplus from being instantly destroyed and having its value multiplied by the Handle With Care Mutator

v0.0.1

• Initial pre-release