Monitor Takeover

I am Y4NGZ, an up and coming rapper out of NYC/Detroit. All of my mods are inspired by the music I write. If you are interested in knowing more about me, check out my SoundCloud: https://soundcloud.com/y4ngz

Generative AI usage

The entire code base of this mod was created with generative AI. Assets are free, licensed, paid for, or generated with AI tools. If you do not wish to play with AI-generated content, do not install this mod.

What Monitor Takeover does

Monitor Takeover adds a quota progression to Lethal Company. After each fulfilled quota the ship monitors play a takeover broadcast with that quota's dialogue, then list the quota's rewards. Rewards can unlock contracts, ship upgrades, constellations, moons, suits and store items, or grant credits, ship fuel and Y4NGZ Upgrades tokens. Progression and rewards run on the host and persist with the save. Out of the box no rewards are set, and every quota shows the default Y4NGZ takeover.

Requirements

Your mod manager installs these automatically:

• BepInExPack
• DawnLib
• Y4NGZCore

The Takeover

When the ship reaches orbit after a fulfilled quota, the lights dim, the HUD hides, and every ship monitor switches to the takeover feed for a configurable number of seconds. The feed shows that quota's typed dialogue over the built-in Y4NGZ video, or over media you supply.

Media

Drop a PNG, JPG, or MP4 into BepInEx/config/Y4NGZCompany/MonitorTakeovers and name it in a quota's section, or paste a full YouTube link instead. One file or link can cover every quota, or a pool of files and links can be spread across the monitors so each screen plays something different. Every player needs an identical copy of a local file; a player without one sees the built-in video. YouTube links download in the background on each player's machine, so the first takeover after adding one may still show the built-in video. After that, the download is cached.

For audio you can keep the built-in mix (Charlie Brown mumbles and a siren at the start), let the video's own audio play, or supply your own sound files or a soundtrack link. When the takeover ends, the large ship monitors list everything that quota unlocked and granted.

Configuration

The configuration file is BepInEx/config/com.y4ngz.company.monitortakeover.cfg. Quotas 1 through 9 each have their own Quota N section with that quota's dialogue, media, audio and rewards.

Compatibility

Independent installation: Monitor Takeover needs only Y4NGZCore and the libraries listed under Requirements. The other Y4NGZ packages are optional companions - install any combination and each one lights up its extra behavior.

The required Core package is Y4NGZ313-Y4NGZCore-1.0.10 or newer.

GitHub

Source code: https://github.com/y4ngz313/MonitorTakeover

Bugs

Report bugs at https://github.com/y4ngz313/MonitorTakeover/issues.

Monitor Takeover changelog

1.1.0 - Unreleased

• Updated the package icon with monochrome CCTV monitor artwork (#1407).
• Quota-announcement cameras use Core's shared UI profile with unchanged rendering settings; requires Core 1.0.10 (#1219).
• Fixed custom audio loading and retries; start delay is now at least 2 seconds (#861).
• Fixed silent video soundtracks; failed Replace tracks restore voices and background audio (#715).
• Audio files are rechecked each takeover, with clear rejection warnings (#861).

1.0.1 - 2026-09-06

Added

• Each quota can now lock moons (#862). UnlockMoons in every Quota N section takes comma-separated moon names as the terminal shows them (Titan, Artifice; the 8- style prefix is optional). Until that quota is reached the vanilla terminal answers a route to that moon with a locked message naming the quota, the host refuses the route change from any client or mod, and the Y4NGZ custom terminal leaves the moon out of the list. The rewards screen lists a newly opened moon as MOON. Moons not named anywhere are untouched. Players on an older build are still refused by the host; they just do not see the message.

• The Thunderstore package is now Y4NGZ313-MonitorTakeover with the display name Monitor Takeover, and the readme was rewritten to the shared Y4NGZ layout. The assembly, plugin GUID, config file and MonitorTakeovers folder are unchanged; only the package name, icon and BepInEx display name differ. Install it in place of the Y4NGZMonitorTakeover candidate.

• Quota takeovers can show a different video on each ship monitor. Two new keys in Media: MediaPerMonitor - a semicolon-separated list of filenames from BepInEx/config/Y4NGZCompany/MonitorTakeovers and/or full YouTube links, semicolons because a link may contain a comma; blank by default, and a non-empty list is what turns the feature on - and MaxVideosAtOnce (1-6, default 3), which caps how many videos decode at once and is what protects performance. With the list blank the takeover is unchanged: one video on every screen, exactly as before. The host picks one random layout per takeover and every player derives the same one from it, so the same monitor shows the same slot for everyone, with and without GeneralImprovements Better Monitors. The bottom-left map screen always stays on the main video. A player missing a pool file, or one whose YouTube link has not finished caching, drops that entry with a single log line and shows the rest - the layout still matches, the content on that one screen does not. A video that never decodes falls back to mirroring the main one rather than opening a second decoder. A player on an older build sees the ordinary single-video takeover: the plan rides an additive named message, so the protocol revision stays 1. The GeneralImprovements wall needs Y4NGZCore 1.0.6 or newer for per-screen video; on an older Core it shows the main video everywhere with one warning line.

• Quota takeovers can play a soundtrack of your own, from a local MP3/WAV/OGG in BepInEx/config/Y4NGZCompany/MonitorTakeovers or from a full YouTube link. Three new keys in Audio: SoundtrackMode (Off by default, Replace or Mix), Soundtrack, and SoundtrackVolume (0-1, default 0.8, independent of VoiceVolume). Replace silences the power-down whine, the alarm, the drone bed and the mumble voices for the whole takeover; Mix layers the track over them. With SoundtrackMode = Off - the default - the takeover audio is unchanged. A soundtrack mutes the configured video's own track even when PlayVideoSound is on, and setting the soundtrack to the same YouTube link as the media reuses that one video's audio instead of downloading or decoding it twice. Files sync by the host's filename plus SHA-256 exactly like AlarmFile; links are cached per player. Any failure - a missing file, a hash mismatch, a link that is not cached yet, or a playback error - falls back to the built-in audio with a single log line. A peer on an older build hears the built-in audio: the plan rides an additive named message rather than changing the takeover payload, so the protocol revision stays 1.

Changed

• The media and audio settings have names that say what they do (#861). Mumble Volume and MumbleAudioFiles are now VoiceVolume and VoiceFiles (the mumbled voice lines under the dialogue), AlarmAudioFile is AlarmFile (the siren at the start), SoundtrackSource is Soundtrack, DefaultMediaFile is MediaForAllQuotas, each quota's MediaFile is Media, LoopMedia is LoopVideo, EnableMediaAudio is PlayVideoSound (and its description now says it plays your video's sound on top of the built-in audio, not instead of it), UseMediaLengthAsDuration is HoldForWholeVideo, and MaxConcurrentMediaPlayers is MaxVideosAtOnce. The per-monitor on/off switch is gone: PerMonitorMediaPool is now MediaPerMonitor, and filling it in is what turns per-monitor media on. Every description was rewritten to say what the setting layers over or replaces. An existing config migrates once on startup with every customized value carried to its new name; a config that had a pool listed but the old switch off keeps one shared video and gets one log line saying so. The previous file is kept beside it as .pre-schema-v2-<timestamp>.bak.
• The config file reads as plainly named sections instead of the numbered leftovers from the pre-split shared file: General, Media, Audio, Presentation, Rewards Ceremony, Quota 1 through Quota 9, and Diagnostics. No setting was added, removed, or renamed - only the sections moved. An existing config is migrated once on startup with every customized value carried across, the old numbered sections removed, and the previous file kept beside it as com.y4ngz.company.monitortakeover.cfg.pre-schema-v1-<timestamp>.bak; the second and third startups leave the file byte-for-byte unchanged.

Removed

• The Mask Man takeover is gone (#860). It was a fixed one-shot that replaced quota three's broadcast the first time a save reached it, so on a fresh save quota three never showed the configured takeover. Quota three now plays the ordinary configurable takeover like every other quota. The Mask Man Tail Buffer setting is removed from Presentation and dropped during config migration; the Y4NGZ_MaskManFired flag in existing saves is ignored.
• The unfinished quota ending is gone: the ending sequence, its forced-route lock and its 73 - Monitor Takeover - Ending config section no longer exist. It was already unreachable because the moon it needed was de-shipped, so nothing changes on a normal install. Quota takeovers are unaffected. An old config file that still carries [Ending] (or [73 - Monitor Takeover - Ending]) keys still imports cleanly; those keys are ignored.

1.0.0 - 2026-08-31

Initial standalone release.

Fixed

• The takeover video actually plays instead of falling back to static.
• Takeover mumbles and Mask Man audio are audible again, and the final broadcast and Mask Man congratulations show video instead of a black screen.
• The takeover starts on time instead of stalling for several seconds before the dialogue.
• Quota reward announcements cover all three large lower monitors with GeneralImprovements Better Monitors.
• Monitors show animated static instead of an empty black wall if the takeover video cannot start.