Monitor Takeover changelog

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.