PersonalHelper

It knows everything.

A small atmospheric horror mod for Lethal Company. No new enemies, no new gear: only the feeling that something in the facility is aware of you.

Install

1. Install BepInEx 5 (Thunderstore: BepInEx-BepInExPack-5.4.2100).
2. Drop PersonalHelper.dll into BepInEx/plugins/PersonalHelper/.
3. Drop your own media into BepInEx/plugins/PersonalHelper/Assets/ (see below).
4. Launch once, then edit BepInEx/config/experimenter.personalhelper.cfg.

Every player in the lobby needs the mod installed. The host is authoritative: the host rolls the dice and broadcasts events, clients only play them.

Events

1. Distant Sound

85% chance, once per round. The first time anyone steps inside the facility, the host rolls and broadcasts. Each player hears the sound 22-40 m away from themselves, from a random direction, audible up to 90 m. Everyone hears it, nobody hears it from the same place.

2. Vigil

67% chance, rolled once per round. If it wins, then as soon as time spent inside the facility reaches 60 s, 2D music starts for everyone at once and rises for 90 seconds. At 1:30 a stinger plays, a full-screen image appears, the player dies, the music cuts.

3. Rare flashes

While you are inside, a 4%-per-minute roll replaces a single frame of your screen with something. Too fast to be sure you saw it.

4. The Stalker (new in 0.2.0)

Walk straight, without turning, for long enough and something spawns behind you. It does nothing. It waits. The moment you turn around and it enters your view, a full-screen image and a sound hit you, then fade out quietly. It despawns instantly. Non-lethal by default. Once per cooldown, capped per round.

5. Video (admin only)

The admin picks a player and a full screen video takes over their screen for 11 seconds, sound and all, then hard cuts back. The length is configurable per call from the panel. Nobody else sees it, and there is nothing they can press to make it stop.

6. Lockdown (admin only)

When every living player is inside the complex, the admin can seal the main entrance. Only the fire exits work. A full-screen image pulses (dim -> bright), global music plays and a synced countdown runs on everyone's HUD. When it hits zero, whoever is still inside is dealt with.

Admin panel

Authorization is by SteamID64, validated server-side. Put your IDs in the config:

[Admin]
SteamIDs = 76561199058784388
PanelKey = F6

A client can request anything it wants: the host checks the sender's SteamID against the list and silently drops the request if it does not match. Editing your own config does not make you an admin.

From the panel you can:

• fire any event at one player or at everyone
• trigger Distant Sound, Vigil, Jumpscare, Flash and Stalker on demand
• play a full screen video on one player's screen, with a custom length
• start / stop Lockdown with a custom duration
• see who is inside the facility right now

Custom sounds and images

Everything is loaded at runtime from BepInEx/plugins/PersonalHelper/Assets. Drop your own .ogg / .wav / .mp3 and .png files into the subfolders and restart the game. One file per folder is picked at random each time.

Assets/
  sounds/
    distant/     <- event 1, the far away sound
    music/       <- event 2 and lockdown, the global track
    stingers/    <- the scream on the killing image
    meme/        <- the stalker payoff sound
  images/
    jumpscare/   <- the image that kills you
    flash/       <- single-frame flashes
    meme/        <- the stalker payoff image
    lockdown/    <- the pulsing full-screen image
  videos/        <- .mp4 / .webm for the admin video event

No files in a folder = that part is silently skipped. Nothing crashes.

Debug hotkeys

Set Debug/HotkeysEnabled = false before you play seriously.

Music never loops: a clip plays once and stops, so make your track at least as long as Event2/BuildupSeconds.

Config

BepInEx/config/experimenter.personalhelper.cfg

Building from source

src/ is not needed in the release build.

cd src
build.bat

Requires the .NET SDK. Restores LethalCompany.GameLibs.Steam from NuGet, so no manual DLL copying from your game folder.

Changelog

0.3.1

• Replaced legacy UnityEngine.Input.GetKeyDown with Unity New Input System Keyboard.current.
• F6-F12 no longer throw Input System-only runtime exceptions.

Changelog

0.3.0

Added

• Video event. Admin only. Pick a player, a full screen video takes over their screen for 11 seconds (configurable per call), audio included, then it hard cuts back. Streamed from Assets/videos, so file size costs nothing until it plays. F12 plays one locally for testing.
• New asset folder videos/ for .mp4 / .webm / .m4v / .mov.
• New config section Video: Seconds, Volume, KillPlayer.

Changed

• Music no longer loops. Vigil and lockdown tracks play once and stop. Make your track at least as long as the buildup.

0.2.0

Renamed to PersonalHelper. The assembly, the namespace, the plugin folder and the config file all changed, so delete the old install before dropping this one in.

Added

• The Stalker. Walk forward long enough without turning and something spawns behind you. It never moves. The moment you turn around and it enters your view, a full screen image and a sound hit you, then fade out quietly. Cooldown and a per-round cap so it stays rare. Non-lethal by default.
• Lockdown. Admin triggered, only when every living player is inside. The main entrance stops working, fire exits stay open, a full screen image pulses dim to bright, global music plays and a countdown synced to the server clock runs on everyone's HUD. Whoever is still inside at zero gets the payoff.
• Admin panel (F6). Gated by SteamID64 and validated on the host, so editing your own config does nothing. Fire any event at one player or at the whole lobby, start and lift lockdowns, see who is inside.
• New asset folders: sounds/meme, images/meme, images/lockdown.
• New config sections: Stalker, Lockdown, Admin.

Changed

• Plugin GUID is now experimenter.personalhelper, config lives at BepInEx/config/experimenter.personalhelper.cfg.
• Plugin path is now BepInEx/plugins/PersonalHelper/PersonalHelper.dll.
• Event playback moved behind a single host-authoritative handler: the host rolls, clients only play.

0.1.0

Added

• Event 1 - Distant Sound. 85% chance, once per round, fires when the first player enters the facility. Per-player randomized direction and distance.
• Event 2 - Vigil. 67% chance per round, 60 s inside triggers a global 90 s buildup, then stinger + full screen image + death.
• Rare flashes. 4% per minute while inside, single frame, host broadcast.
• Runtime asset loading from Assets/ for .ogg / .wav / .mp3 / .png.
• Debug hotkeys F7-F11.
• Config at BepInEx/config/experimenter.personalhelper.cfg.