Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
FalseFriend
Player mimics with grab-and-drag interaction, collision-aware movement, blocked-target recovery and buffered multiplayer motion. Automatic encounter levels; one active at a time. Development build; gameplay verification pending.
By Oatflakes
| Date uploaded | 2 weeks ago |
| Version | 0.2.0 |
| Download link | Oatflakes-FalseFriend-0.2.0.zip |
| Downloads | 1113 |
| Dependency string | Oatflakes-FalseFriend-0.2.0 |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2305README
False Friend — R.E.P.O. mimic
Experimental 0.2.0 development build. Full in-game verification is pending. All players must use this version.
False Friend is a custom impostor that copies a player, encourages a teammate to follow, and attacks after leading that teammate away from the group.
Implemented design
- Mimic encounter levels occur every two or three expedition levels, starting on level 2 or 3. On those levels natural spawning is always active with the mod: the first attempt starts as soon as the generated expedition is ready, with no probability roll or 38–65 second opening delay. Only one mimic is active at a time; a killed/removed mimic is replaced after three seconds. Shops, lobbies, tutorial and arena do not count. The floor schedule remains stable when the same save is reloaded.
- Placement prefers hidden, clear and reachable points roughly 9–18 metres from players. If those checks cannot find a point, automatic fallback searches walkable map positions and positions behind players. Fallback can relax visibility and the normal seven-metre separation while retaining navigation, body clearance and separation from players. Missing model/navigation readiness is retried every second rather than cancelling the encounter. No forced in-front spawn or testing toggle is required.
- Copies a living or dead player from the current lobby. Reuses actual player meshes, materials, rig and animation; checks cosmetics and colour changes every 0.5 seconds, including replacement avatars after respawn.
- Keeps the chosen player's identity until that player dies. After a live-to-dead transition it may choose a replacement only after two seconds in an empty, unseen room, with no living player nearby. Room overlap, current player rooms and line of sight are checked; unknown rooms prevent a change. A player already dead when chosen remains a valid locked disguise, and cosmetic refreshes never choose another identity.
- Targets living players other than the one it impersonates. This protection remains when the copied player is the last survivor of a multiplayer lobby. A genuinely one-person lobby permits targeting the copied player for solo testing.
- Drives walking and sprinting with the native player gait clips, with foot motion synchronized to distance travelled. Grab/bite poses are layered over the copied model.
- Uses swept capsule movement for walking and dragging, with sliding, small steps, floor handling and bounded pushes on light props. The navigation agent supplies steering rather than moving the body directly through objects.
- Players can use their normal Grab control to restrain, drag and lift the mimic, with a local tether and wheel push/pull. A host validates range, line of sight, identity and short grab leases. Grabbing interrupts its attack; release restores navigation after a brief recovery. This is controlled dragging, not a native thrown/ragdoll PhysGrabObject.
- While disguised, turn speed changes in short bursts, with occasional mouse-like flicks and held glances. It pauses more frequently: typically 0.4–1.6 seconds after 2–5 seconds of walking, with occasional two-second stops.
- Occasionally hops while walking, using native jump/fall/land poses and jump/landing sounds. A clear-overhead check avoids ceiling clipping. These are render-only hops; navigation and the collision body stay on the ground.
- Replays short voice clips belonging to the copied player. Lure and attack recordings share a shuffled rotation: every currently available clip gets a turn before repeating, with no immediate repeat across reshuffles when multiple clips exist. New recordings join the rotation. Missing clips remain silent.
- Uses native R.E.P.O. robotic speech for "Come this way", "Over here", "Follow me", "I found something" and "This way".
- Recordings, robotic lure lines and the reverberating attack voice use normal player proximity attenuation and occlusion. Distant players do not hear them.
- Tries to lead a target away, then gives a 1.1-second warning before chasing. At close reach it performs a 1.8-second grab-and-bite: reach for 0.5 seconds, hold briefly, bite once at 1.0 seconds for 40% of the victim's maximum health including upgrades, then release. Damage rounds up to a whole HP (100 maximum HP means 40 damage; 200 means 80), and is based on maximum HP rather than remaining HP. The attack cooldown is 2.4 seconds from the start. Walking into a player alone causes no damage.
- If the lure has not succeeded after 45 seconds from its first lure attempt on that target, it turns back and chases that player to attack. Waiting, walking back toward the target, temporary stuns, or a safe disguise change that leaves the same victim eligible do not restart the deadline. The target, deadline and committed pursuit are replicated for authority changes. This committed pursuit survives loss of sight and distance; it ends when the target dies or becomes ineligible.
- Sharp upper and lower teeth reveal as the bite attack begins, track the jaw as it opens/closes, and hide again at release or interruption.
- During the grip/bite, the attack voice plays a recording belonging to the player being impersonated, with strong 2.2-second reverb. Pitch and recorded words stay unchanged. It uses no generated scream or other player's recording; if that player's clip is unavailable, the effect stays silent. Speak a few phrases during the session to populate the matching recording pool.
- The brief grab actually locks the victim's position at contact before the bite, rather than only slowing them. It blocks movement and jumping during the 0.5–1.3 second grip phase while preserving looking and item use. Dodging the reach, blocking contact or stunning the mimic interrupts it. The local lock has a hard expiry and releases on death, displacement, obstruction or session changes; it does not teleport the victim into the monster.
- An unreachable victim is reconsidered after 2.5 seconds; a walk blocked without progress is reconsidered after three seconds. Failed targets receive a ten-second retry cooldown, allowing a reachable eligible player to be selected. Target death immediately clears the attack/grip. With no eligible reachable victim, it patrols instead of remaining in a stale attack/stun pose; the copied player's multiplayer immunity is preserved.
- Mimic-owned materials preserve player cosmetics without inheriting donor damage/death red overlays or collapsed death scales. Its health strip reflects its own health.
- Multiplayer movement uses a 120 ms snapshot buffer, position/yaw interpolation and tightly bounded packet-loss extrapolation. Host attack/grab checks use authoritative contact positions rather than delayed rendering. Entity incarnation IDs stop late grab requests affecting a later mimic.
- Host-controlled movement, attacks and synchronized appearance identity. Physical impacts and active native weapon hit volumes can damage or stun the mimic.
- Includes one-player support, including a local microphone fallback when the native voice stream is unavailable.
- A living mimic no longer disappears just because four minutes have elapsed. It remains until killed/removed or the level ends.
- Press F6 during a level to open the testing panel, with Spawn In Front and Auto Spawn controls. Auto Spawn is off by default and resets off when leaving the session.
These are implemented code paths, not a claim that all behavior has passed in-game testing. See VALIDATION.md in the accompanying source deliverable for tested scope and outstanding checks.
Installation
Install BepInExPack 5.4.2305 and REPOLib 4.2.0 in a separate R.E.P.O. profile. Put FalseFriend.dll inside BepInEx/plugins/FalseFriend/ in that profile. Launch the profile modded. Every player must install the same version and matching dependencies. Version 0.2.0 adds grab/state fields; update every lobby participant together and keep only one active FalseFriend DLL.
The first encounter level is expedition level 2 or 3. Simply launch the profile modded and enter an eligible level: automatic spawning begins as soon as the map/player are ready and keeps retrying if assets or navigation are still loading. On encounter levels the director replaces a removed mimic after three seconds, with no fixed encounter cap. There is no natural encounter on level 1 or other unscheduled levels.
Solo testing controls
Launch the updated profile using Start modded and enter an expedition. Press F6 to open False Friend — Testing.
- Spawn In Front places a mimic about 1.5 metres directly in front of your current view, including on level 1. It uses your own avatar for predictable solo testing and bypasses the normal encounter interval, room clearance, minimum distance, visibility and path checks. It does not require a larger room.
- Auto Spawn is an optional forced-placement testing mode for unscheduled levels. It keeps at most one mimic active, waits 15 seconds between successful test spawns, and retries failed placement after three seconds. On a scheduled mimic level the automatic natural director takes priority, regardless of this toggle. The toggle resets off when leaving the session.
- Close the panel with Close, F6 or Escape to resume normal input. The controls work in singleplayer or for the host of a private lobby.
Normal encounter levels follow the two-to-three-level schedule whether the testing toggle is on or off. A manual test mimic occupies the single active slot; after it is gone on a scheduled level, natural encounters resume following the three-second replacement delay. Manual test spawns never enable natural replacements on an unscheduled level.
Testing Auto Spawn uses the same direct placement. A forced test mimic stays visible and can play voice lines even where the game has no navigation surface; it retries nearby navigation attachment once a second. Normal movement resumes when attachment succeeds. Natural encounters use navigable placement and their own persistent fallback search.
Voice recording
Let everyone in the lobby know voice replay is enabled. Short samples of the player's normal game microphone stream are held in bounded memory, retained across levels in that run, and shared only with other players in that lobby. Samples are cleared when leaving the session or changing rooms/saves. No recorded voices are included in the download, saved to disk, uploaded to a speech service or used to train a model. The game microphone device, mute, push-to-talk and volume settings are respected.
Successive recordings become locally available immediately. Multiplayer uploads are queued with a limit of eight pending clips and paced every 12 seconds; if that queue fills, the oldest pending clip is replaced. This avoids discarding every recording spoken during a transport cooldown. Speak several phrases to give the mimic a variety of matching clips.
Compatibility and current limits
Developed against R.E.P.O. v0.4.4.3 (Steam build 23363152), Unity 2022.3.67f2, BepInEx 5.4.23.5 and REPOLib 4.2.0.
Cosmetics inside the normal player visual hierarchy are mirrored; effects that require another mod's custom scripts or external visual objects need individual compatibility tests. This is a custom NavMesh creature, so interactions with third-party enemy mods, doors, stairs, weapons, host migration and late joining require real sessions before public release.
Credits and source
Code and package artwork were created with AI assistance. A public Thunderstore release must use the AI Generated category, alongside suitable mod/monster/audio categories. Native game content remains owned by its respective rights holders. See LICENSE and THIRD_PARTY_NOTICES.md.
CHANGELOG
0.2.0 — development build
- Added normal Grab input, host-validated tether/drag/lift interaction and attack interruption.
- Replaced direct navigation movement with a collision-swept body motor, step/slide handling, floor recovery and bounded light-prop pushes.
- Added unreachable/stalled-target recovery, temporary failed-target exclusions and idle patrol when no valid victim remains.
- Clear bite/grip poses on target death and remove donor health/death red overlays from the copied appearance.
- Buffer multiplayer position/yaw snapshots and bound extrapolation; replicate health, stopped state and entity incarnation IDs.
- All lobby participants must update to 0.2.0. Runtime physics and host/client validation are still pending.
0.1.9 — unpublished development build
- Natural spawning is always enabled on scheduled mimic levels and starts immediately when the expedition is ready; testing controls are not required.
- Added persistent one-second readiness/placement retries, alternate eligible donors/anchors and automatic navigation-based fallback placement.
- Removed the four-minute lifetime cap; killed/removed mimics are replaced after three seconds, one at a time.
- Natural scheduling takes priority over forced testing Auto Spawn on eligible levels.
0.1.8 — unpublished development build
- Scheduled mimic levels can contain multiple encounters, with only one mimic active at a time.
- Added a random 45–75 second cooldown after each mimic's death/despawn; failed safe-placement attempts retry after eight seconds.
- Manual testing no longer consumes the encounter level. Unscheduled levels still do not receive natural replacements.
0.1.7 — unpublished development build
- Added donor immunity during targeting, biting and grabbing, with a true one-player lobby exception.
- Locked disguise identity until the copied player's death; replacement requires a stable empty, unseen room. Cosmetic updates preserve identity.
- Added a persistent 45-second failed-lure deadline, followed by return pursuit of the same target.
- Matched all mimic voice sources to native player proximity attenuation and occlusion, with distance silence for attack reverb too.
0.1.6 — unpublished development build
- Changed bite damage from a fixed 45 HP to 40% of the victim's current maximum HP, including upgrades, rounded up to whole HP.
- Lure and attack recordings share a randomized rotation that uses all available matching clips before repeating and avoids immediate repeats across reshuffles.
- Fixed the recording cooldown discarding successive clips, including in solo. Clips enter the local cache immediately; multiplayer uploads use a bounded, paced queue.
0.1.5 — unpublished development build
- Added sharp pointed upper/lower tooth rows, visible during the bite attack and attached to the copied jaws.
- Teeth refit when native cosmetic mesh dimensions change and hide at release/interruption.
- Added strong reverb to attack recordings from the player being impersonated; preserves original pitch and words.
- Relays the selected exact clip to peers and briefly waits for missing recordings; never substitutes another player's voice or a synthetic scream.
0.1.4 — unpublished development build
- Replaced constant smooth swivelling with variable-rate turn bursts, quick flicks and held glances.
- Added frequent brief stops while disguised and occasional native jump/fall/land poses.
- Replicated stops, hop progress and quick yaw changes across clients.
- Replaced the grab's movement slow with an actual owner-local position lock before biting.
- Added jump suppression, short freshness leases, hard expiry and interruption/session cleanup for the lock.
0.1.3 — unpublished development build
- Native player walking/sprint clips are driven by travelled distance for player-style leg movement.
- Added visible reach, grab, jaw opening, bite and release poses on the copied player model.
- Replaced contact damage with an interruptible timed bite: one 45-damage hit at the bite moment.
- Brief owner-side movement slow during the grab; no camera/item lock or teleport.
- Attack target and progress synchronize across clients; stale packets cannot sustain restraint.
0.1.2 — unpublished development build
- Testing controls place a mimic about 1.5 metres directly in front of the local player's view.
- Removed room-clearance, minimum-distance and path requirements from test placement.
- Forced test mimics persist and play speech while waiting for navigation attachment.
- Natural encounter placement and cadence retain their existing rules.
0.1.1 — unpublished development build
- Added F6 testing panel with Spawn Now and Auto Spawn buttons for solo players and hosts.
- Manual testing can spawn on level 1, using clear reachable ground nearby.
- Auto Spawn defaults off, keeps one mimic active and resets off when leaving the session.
- Normal two-to-three-level scheduling remains active when automatic testing is off.
0.1.0 — unpublished development build
- Initial player disguise, live cosmetic refresh, matched session voice replay and native robotic lure phrases.
- Host-controlled navigation, luring, isolation check, warning and attack behavior; physical/weapon damage bridge.
- Reproducible encounter intervals of two or three expedition levels.
- One-player capture support without a test menu or manual spawn option.
- Pending full gameplay, cosmetic, audio and multiplayer verification before public release.