Level99Mike-LethalZero icon

LethalZero

When the host dies, the whole crew returns to the moment the lever was pulled and replays the same day: same seed, same loot, same rng rolls. A Re:Zero parody. Every player needs the mod for it to work.

Last updated 27 minutes ago
Total downloads 0
Total rating 1 
Categories Mods Audio BepInEx Client-side Server-side Tweaks & Quality Of Life
Dependency string Level99Mike-LethalZero-0.2.1
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Lethal:Zero

Return by Death for Lethal Company. A Re:Zero parody.

When the host dies on a moon, the whole crew goes back to the moment the lever was pulled and replays the same day. Same seed, same map, same loot, same RNG rolls. If you do the same thing again, you get the same result.

Install

Use a mod manager. For a manual install, copy the DLL, the three sound files and witch_hand.zmesh into BepInEx/plugins/LethalZero/. Needs BepInEx 5.

Every player needs the mod. The host gets a warning if someone joins without it or on a different version. A player on a version that can't read the host's checkpoints still rewinds with everyone, but their ship isn't restored.

How it works

  • Pulling the lever saves a checkpoint: credits, quota, deadline, weather, everything on the ship, what each player is carrying and where they are standing.
  • Only the host's death starts a loop. The host sees their body for about 2 seconds, then the screen goes black for everyone.
  • Behind the black screen the ship goes back to orbit and the moon reloads with the same seed.
  • Everything is put back the way it was at the checkpoint. Dead players are revived, nobody keeps what they picked up, anything bought during the loop is refunded and no day passes.
  • You are back in the ship right before it lands.
  • The checkpoint only moves forward when a day ends normally with the host alive.

Restored on the ship: items (scrap value, battery, position, on/off state), inventories and the selected slot, furniture, suits, the Cruiser, terminal orders, ship lights, the radar target, teleporter cooldowns, the TV, a playing boombox, cabinet doors and TZP intoxication.

How the host died is written to the BepInEx log.

Balance

  • Loops are unlimited by default. Cap them with MaxLoopsPerDay. After the last loop the next death is final.
  • Only what you know carries over. Loot, credits, sales, purchases, stats and the deadline are all rolled back.
  • Dying doesn't reroll a bad day. It's the same seed and the same rolls.
  • Buying or selling and then dying doesn't work. Purchases are removed and refunded, sold scrap comes back and the quota rolls back.
  • Quitting mid-loop works like vanilla: you are back at the last autosave.
  • Loops are off on the challenge moon by default (LoopOnChallengeMoon).

The Witch's taboo

If the host tries to tell the crew about the loops in text chat or with the signal translator, the message never arrives and the Witch punishes them:

  • Time stops for the whole lobby for about 15 seconds.
  • The host takes TabooDamage (25 by default), doubled for every offence that day. From the third offence it kills. On a moon, that death starts another loop.
  • From the second offence there is a chance the nearest crewmate who could have read the message is hit instead. A crewmate's death is permanent.
  • The offence count carries across loops and resets on a new day.

Only the victim sees the Witch's hand. The host also sees it when it takes a crewmate.

The filter ignores case, accents, punctuation, leetspeak (r3wind) and spaced-out letters (t i m e loop). It also catches words in between (time is looping) and phrases split over several messages. Voice chat isn't checked, so that part is up to you.

Config

BepInEx/config/lethalzero.returnbydeath.cfg

Section Key Default What it does
Loop Enabled true Turns the mod on or off (host).
Loop MaxLoopsPerDay 0 Loops allowed per day, 0 = unlimited (0-100).
Loop LoopAtCompany true Loop on deaths at the Company.
Loop LoopOnChallengeMoon false Loop on the weekly challenge moon.
Loop FastRewind true Skip the ship's take-off during a rewind (host). Off = the ship takes off normally behind the black screen, which is slower.
Determinism DeterministicRng true Make all random rolls repeat each loop (needs a restart).
Determinism IncludeModdedAssemblies true Do the same for other mods (needs a restart).
Determinism RngTrace false Log a report after each loop showing what played out differently.
Presentation DeathPauseSeconds 0.5 Extra time the host watches their death, on top of 1.5 s (0-5). Makes the restart that much longer.
Presentation SfxVolume 0.8 Volume of the mod's sounds (0-1).
Taboo WitchTaboo true Turns the taboo on or off.
Taboo TabooWords see config Comma-separated phrases. A phrase has to start at the beginning of a word but can end mid-word.
Taboo TabooPatterns see config Semicolon-separated regular expressions, for things like "loop 4".
Taboo TabooDamage 25 Damage on the first offence (0-100).
Taboo TabooEscalation true Double the damage for every offence that day.
Taboo TabooLethalStrike 3 The offence that kills outright. 0 = never (0-10).
Taboo TabooListenerChance 0.25 Chance that the nearest crewmate is hit instead, from the 2nd offence (0-1).
Taboo TabooCanKill true Off = the taboo stops at 1 HP.
Taboo TimeStop true Stop time for the lobby during the taboo.
Taboo TimeStopSeconds 2 How long time stops if the witch_hand sound file is missing (0.25-10).
Taboo TimeStopSilence true Mute all game sound, voice chat included, while time is stopped.

The host's taboo settings apply to everyone. Values outside the ranges are clamped.

Custom sounds and model

The mod plays three files that sit next to the DLL: rbd_bell, rbd_wail and witch_hand (.ogg, .wav or .mp3). Replace a file to change the sound, or delete it to mute it.

If you replace witch_hand, keep the same timing or the heartbeat effects won't line up: first beat at 9.4 s, last beat at 14.9 s, 15.25 s total.

witch_hand.zmesh is the hand model and its animation. Without it the taboo plays with no visible hand.

How the RNG is kept the same

The seed alone isn't enough, because the game uses several kinds of randomness:

Source Problem What the mod does
System.Random seeded from the map seed (dungeon, scrap, spawns, weather, turrets) None, as long as it is created fresh each round Nothing.
System.Random fields that live across days (ship items, terminal, sound manager) Their state depends on every earlier day Reseeded each round from the round seed, the field and the object.
UnityEngine.Random (about 420 call sites: enemy AI, item effects, player effects) One global stream, so one extra footstep sound shifts every roll after it Every call is rewritten at startup. Each line of code on each object gets its own stream.
NetworkObjectId used as a seed (Doublewing, Flower Snake, radar booster names) IDs keep counting up between loops Replaced with a per-round number.
new System.Random() (seeded from the clock) Different every run Replaced with a stream.

Because every object has its own streams, changes stay local. If you kill the Bracken early, the Thumper's rolls don't change. Only the things that reacted to you play out differently.

Objects are identified by where they are (checkpoint slot, player slot, scene ID, or prefab plus spawn order), not by who rolled first, so two identical enemies that spawn in the same frame can't swap rolls.

Other mods' randomness is handled the same way unless you turn off IncludeModdedAssemblies.

RngTrace

Set RngTrace = true to compare each loop with the one before it. The report goes to the log and to BepInEx/LethalZero/traces/*.tsv:

Seed 37994791: loop 2 vs loop 1, compared up to 181.4s after landing.
Gameplay: 41 streams identical, 3 differ. First at 43.82s: GrabbableObject::Update()#0 rolled only in this loop.
Cosmetic: 160 identical, 12 differ (sound/visual only; cannot affect gameplay rolls). First at 1.62s: ...
Identity: no swaps (every object kept its key).
  • Cosmetic streams (sounds, animation events, lights) differ easily and can't affect gameplay.
  • An identity swap means an object got a different key in each loop. That's a bug in the mod, please report it.

Known issues

  • Loops aren't frame-perfect. The rolls are identical, but movement, physics and AI run on frame time, so small timing differences can change when an enemy makes a decision, and things can drift from there.
  • Enemies that hear voice chat react to how loud you are.
  • Crewmates aren't scripted. If they do something different, the loop plays out differently.
  • Opening the pause menu during a rewind hides the black screen, so you can see the ship being reset.
  • A record player that was on starts its song from the beginning.
  • If the host's death leaves no body, the camera stays where they died.
  • Cruiser: one bought during the loop is removed, and a lost one is replaced with a new one.
  • After a game update, a feature that no longer works turns itself off and is named in the BepInEx log at startup. The rest keeps working.

Contact

  • Level99Mike on Discord, Steam