SNEAKY MASKS

Language / Язык: English · Русский

SNEAKY MASKS

Author: Solo00n

Comedy and Tragedy stop waiting to be used: the mask holds the button for you, and it only kills once it has climbed all the way onto your face.

WHAT IT DOES

• A mask in your hand arms itself after a hidden delay of 1 to 5 seconds. Nothing is drawn, nothing is played, nothing moves while that delay runs.
• When it expires the mask takes the use key and holds it down, exactly as if you had decided to raise the mask yourself. Your character lifts it, and the people around you can see that.
• A protection window of 2 seconds follows, during which the mask is not allowed to start climbing. Putting it away here is always safe.
• After that the base game takes over untouched: a 65% roll every 5 seconds, and on a hit the mask starts climbing.
• It can only kill you from your face. The mask latches on about half a second into the climb, and only then does the suffocation that kills start counting. A mask that never latched on cannot attack you at all, however long it was trying.
• Interrupting a climb before it latches — dropping the mask, or stowing it — cancels it outright, and nothing carries over to the next time. Once it has latched, it is too late; the item is already gone from your hand.
• Tragedy and Comedy attack at different speeds, so which one you picked up decides how long the suffocation lasts.
• Every pickup rolls a new delay, so a mask you have carried before tells you nothing about the next one.
• A mask in a pocket does not stay there. Every 20 to 90 seconds it pulls itself back into your hand, switching away whatever you were holding, and the whole sequence starts from the top. Carrying one becomes a game of noticing.
• A two-handed item is no protection. If the mask's moment comes while you are carrying one, the heavy thing is knocked to the floor first, and the mask takes the hand after.
• Half the time it arrives already climbing. A coin flip on every takeover decides whether you get the usual run-up — hidden delay, protection window, rolls — or nothing but the climb itself. Dropping or stowing it still cancels the climb either way.
• And it gets faster every time. Each takeover makes the next climb quicker than the last. Carry a mask long enough and the climb is over before you have registered that it started — which is the mask killing you outright, by having nothing left for you to react to.
• Stowing it does not calm it down. Only throwing the mask on the floor puts the escalation back to zero.

HOW IT WORKS

The base game already contains nearly all of this. HauntedMaskItem.Update rolls 65% every 5 seconds while a flag called maskOn is set, and on a hit calls BeginAttachment, which starts the climb. Vanilla only ever sets that flag from ItemActivate — the use key. This mod calls UseItemOnClient, the same entry point your own input uses, so the press is a real press with the animation and networking that come with it, not a flag flipped behind the game's back.

An attack has two parts, and it is worth being clear about which is which. MaskClampToHeadAnimationEvent fires about four tenths of a second in: that is the mask latching on — the head mask is spawned and the item in your hand is destroyed, so this is the moment past which throwing it away is no longer an option. What follows is the attachTimer countdown, five seconds of suffocation, and that is what actually kills you.

The one thing taken from vanilla is a condition. The base game runs that countdown and kills when it expires without ever checking whether the mask got onto your face, so a climb interrupted early still kills once the clock runs out. Here FinishAttaching is refused unless clampedToHead is set, which is what makes "if it is not on your face, it cannot attack you" true. The countdown itself is left as the timer.

Both halves scale together. The mask's speed figure, multiplied by how many times it has had to fetch itself out of your pocket, sets maskAnimator.speed for the latch and divides attachTimer for the suffocation. At 1x that is vanilla's roughly 0.4 s plus 5 s; at 8x it is 0.05 s plus 0.6 s, which is a death with nothing in it to watch.

The takeover uses the game's own slot switching. When a pocketed mask's timer runs out, the mod makes the same calls the utility-slot key makes — SwitchToItemSlot followed by SwitchToSlotServerRpc — so the switch is a real switch that other players see, and EquipItem fires exactly as if you had scrolled to the mask yourself. Before it does, the mod checks every condition the game checks before it lets you scroll: no menu open, no animation playing, not typing, not in the terminal. A two-handed item is handled the way the drop key would handle it, through DiscardHeldObject, and the switch follows once the game has confirmed the throw. Then a coin flip: on heads the mask is flagged to climb on arrival, and the climb is started on the next frame — the mask presses the use key and calls BeginAttachment itself, leaving it in exactly the state a successful vanilla roll leaves it in, only without the wait. The frame of delay is not cosmetic: starting a climb in the same frame the mask is equipped runs it on an animator that has not updated since the mask came out of the pocket, and the seat event can fire immediately.

Vanilla locks you out of dropping an item while the use key is held. That is fair when it is your finger on the button — a mask never lets go, so the lock is lifted by default. Set PreventDropping to true if you want a mask in the hand to be close to a death sentence.

MULTIPLAYER

This mod is client-side, not host-authoritative. It is safe to run in a lobby where only some players have it.

Everything runs on the client that owns the mask, which is the only client the game runs this logic on in the first place. Nothing extra crosses the network: the press goes out through the game's own ActivateItemRpc, and the attachment through its own AttachServerRpc and AttachClientRpc, so other players see the climb whether or not they have the mod. A player without it simply has vanilla masks, and no state can disagree between machines.

REQUIREMENTS

• Lethal Company V81
• BepInEx 5.4.21 or newer

INSTALLATION

Through a mod manager (recommended): install from Thunderstore with r2modman or the Thunderstore app, and the dependency is handled for you.

Manually: install BepInEx, then drop SneakyMasks.dll into

Lethal Company/BepInEx/plugins/

Launch the game once to generate BepInEx/config/Timofey.SneakyMasks.cfg.

CONFIGURATION

Section [General]:

Section [Climb Speed], a multiplier on the whole attack: it speeds up the latch animation and divides the suffocation countdown by the same figure. At 1 that is vanilla's roughly 0.4 s to latch on and 5 s to die. Entries are written for every haunted mask the game knows about, so masks added by other mods appear here too.

The base game runs both masks at the same speed. The split is this mod's doing — set both to 1 to put it back the way the game has it.

Section [Takeover], for masks left in a pocket:

Section [Escalation], for how a mask wears you down over a long carry:

The escalation is counted per mask and survives being pocketed. Only throwing the mask on the floor resets it, so a mask you keep shuffling between slots keeps getting angrier.

COMPATIBILITY

• Works on every moon, vanilla and modded alike.
• Modded masks are supported as long as they use the game's own HauntedMaskItem. Each one is given its own climb speed entry, defaulting to vanilla speed.
• The 65% chance, the 5-second interval, the attach animation itself and the checks that keep masks inert in orbit are all left alone, so mods that touch those keep working.

BUILD

Requires the .NET SDK. Game assemblies come from LethalCompany.GameLibs.Steam, so no local game install is needed to compile.

dotnet build SneakyMasks.csproj -c Release

build-package.ps1 builds Release and assembles the Thunderstore zip into dist/. Set the LC_PLUGINS environment variable to have the built DLL copied straight into your plugins folder.

CREDITS

• Author: Solo00n
• Built on BepInEx and HarmonyX, both MIT licensed.
• Released under the MIT License.

SNEAKY MASKS

Автор: Solo00n

Комедия и Трагедия больше не ждут, пока их применят: маска сама зажимает кнопку, и убивает только тогда, когда доползла до вашего лица полностью.

ЧТО ДЕЛАЕТ МОД

• Маска в руке взводится после скрытой задержки от 1 до 5 секунд. Пока идёт задержка, не появляется ничего: ни индикатора, ни звука, ни движения.
• Когда задержка истекает, маска забирает кнопку использования и держит её — ровно так, как если бы вы сами решили поднести маску к лицу. Персонаж поднимает её, и это видят окружающие.
• Дальше идёт защитное окно в 2 секунды, в течение которого маске запрещено начинать натягиваться. Убрать её здесь безопасно всегда.
• После этого работает нетронутая ванильная логика: проверка 65% каждые 5 секунд, и при успехе маска начинает натягиваться.
• Убить она может только с вашего лица. Маска цепляется примерно через полсекунды после начала подъёма, и только тогда начинается удушение, которое и убивает. Маска, которая не зацепилась, атаковать не может вообще, сколько бы ни тянулась.
• Прерванный подъём до момента зацепления — выбросить маску или убрать в слот — отменяется полностью, и ничего не переносится на следующий раз. После зацепления поздно: предмет уже исчез из рук.
• Трагедия и Комедия атакуют с разной скоростью, поэтому то, какая маска попалась, решает, сколько длится удушение.
• Каждое взятие в руку заново разыгрывает задержку, так что прошлый опыт с маской ничего не говорит о следующей.
• Маска в кармане там не остаётся. Раз в 20–90 секунд она сама вытаскивает себя в руку, убирая то, что вы держали, и вся последовательность начинается сначала. Носить её с собой — игра на внимательность.
• Двуручный предмет не защита. Если момент маски настал, пока вы его несёте, тяжёлая вещь сначала выбивается на пол, а потом маска занимает руку.
• В половине случаев она приходит уже натягиваясь. При каждом захвате бросается монетка: либо вы получаете обычный разбег — скрытую задержку, защитное окно, броски, — либо ничего, кроме самого подъёма. Выбросить или убрать маску по-прежнему отменяет подъём в обоих случаях.
• И с каждым разом она быстрее. Каждый захват делает следующее натягивание быстрее предыдущего. Проносите маску достаточно долго — и подъём закончится раньше, чем вы поймёте, что он начался: это и есть мгновенное убийство, просто реагировать уже не на что.
• Убирание в карман её не успокаивает. Обнуляет нарастание только выброс маски на землю.

КАК ЭТО РАБОТАЕТ

Почти всё это уже есть в самой игре. HauntedMaskItem.Update проверяет 65% каждые 5 секунд, пока выставлен флаг maskOn, и при успехе вызывает BeginAttachment, который запускает натягивание. Ваниль выставляет этот флаг единственным способом — из ItemActivate, то есть с зажатой кнопки. Мод вызывает UseItemOnClient, ту же точку входа, что и ваш собственный ввод, поэтому нажатие настоящее, со всей анимацией и сетевой синхронизацией, а не подменённый втихую флаг.

Атака состоит из двух частей, и стоит различать их. MaskClampToHeadAnimationEvent срабатывает примерно через четыре десятых секунды после начала: это момент зацепления — создаётся головная маска, а предмет в руке уничтожается, и с этой секунды выбросить его уже нельзя. Дальше идёт отсчёт attachTimer, пять секунд удушения, и убивает именно он.

Единственное, что отобрано у ванили, — это условие. Игра ведёт отсчёт и убивает по его истечении, вообще не проверяя, попала ли маска на лицо: прерванный подъём всё равно убьёт, когда часы дотикают. Здесь FinishAttaching отклоняется, пока не выставлен clampedToHead, — это и делает правдой «не на лице — не атакует». Сам отсчёт остаётся таймером.

Обе половины масштабируются вместе. Показатель скорости маски, помноженный на число раз, когда ей пришлось доставать себя из вашего кармана, задаёт maskAnimator.speed для зацепления и делит attachTimer для удушения. На 1x это ванильные ~0.4 с плюс 5 с; на 8x — 0.05 с плюс 0.6 с, то есть смерть, в которой уже не на что смотреть.

Захват использует штатное переключение слотов. Когда у маски в кармане истекает таймер, мод делает те же вызовы, что и клавиша utility-слота, — SwitchToItemSlot, а затем SwitchToSlotServerRpc, — поэтому переключение настоящее, его видят другие игроки, а EquipItem срабатывает ровно так, как если бы вы сами прокрутили до маски. Перед этим мод проверяет всё, что проверяет игра, прежде чем разрешить прокрутку: не открыто меню, не идёт анимация, вы не печатаете, не сидите в терминале. Двуручный предмет обрабатывается так же, как это сделала бы клавиша сброса, — через DiscardHeldObject, — а переключение следует после того, как игра подтвердит бросок. Затем монетка: при орле маска помечается на подъём по прибытии, а сам подъём запускается следующим кадром — маска зажимает кнопку использования и вызывает BeginAttachment, оставаясь ровно в том состоянии, в котором её оставляет успешный ванильный бросок, только без ожидания. Кадр отсрочки здесь не косметика: запуск подъёма в том же кадре, в котором маска экипирована, работает по аниматору, не обновлявшемуся с момента выхода из кармана, и событие посадки может сработать мгновенно.

Ваниль запрещает выбрасывать предмет, пока зажата кнопка использования. Это честно, когда кнопку держит игрок, — маска не отпустит никогда, поэтому запрет по умолчанию снимается. Поставьте PreventDropping в true, если хотите, чтобы маска в руке была почти приговором.

МУЛЬТИПЛЕЕР

Мод клиентский, не host-authoritative. Его безопасно запускать в лобби, где он установлен не у всех.

Вся логика выполняется на клиенте, владеющем маской, — том самом единственном клиенте, на котором эту логику выполняет и сама игра. Ничего дополнительного по сети не передаётся: нажатие уходит через штатный ActivateItemRpc, а натягивание — через штатные AttachServerRpc и AttachClientRpc, поэтому другие игроки видят процесс независимо от того, стоит ли у них мод. У игрока без мода маски просто ванильные, и рассинхрона состояний между машинами возникнуть не может.

ТРЕБОВАНИЯ

• Lethal Company V81
• BepInEx 5.4.21 или новее

УСТАНОВКА

Через менеджер модов (рекомендуется): установите с Thunderstore через r2modman или приложение Thunderstore — зависимости подтянутся сами.

Вручную: установите BepInEx, затем положите SneakyMasks.dll в

Lethal Company/BepInEx/plugins/

Запустите игру один раз, чтобы создался файл BepInEx/config/Timofey.SneakyMasks.cfg.

НАСТРОЙКА

Секция [General]:

Секция [Climb Speed] — множитель для всей атаки целиком: ускоряет анимацию зацепления и на ту же величину делит отсчёт удушения. При 1 это ванильные ~0.4 с до зацепления и 5 с до смерти. Записи создаются для всех masked-масок, которые знает игра, поэтому маски из других модов тоже появятся здесь.

В самой игре обе маски идут с одинаковой скоростью. Разделение — инициатива этого мода: поставьте обеим 1, чтобы вернуть как в оригинале.

Секция [Takeover] — для масок, оставленных в кармане:

Секция [Escalation] — как маска изматывает вас за долгую переноску:

Нарастание считается для каждой маски отдельно и переживает убирание в карман. Сбрасывает его только выброс маски на землю — так что маска, которую вы просто перекладываете между слотами, продолжает злиться.

СОВМЕСТИМОСТЬ

• Работает на всех лунах, ванильных и модовых.
• Маски из других модов поддерживаются, если используют штатный HauntedMaskItem. Каждая получает собственную запись скорости со значением ванильной скорости по умолчанию.
• Шанс 65%, интервал 5 секунд, сама анимация натягивания и проверки, удерживающие маски неактивными на орбите, не тронуты, поэтому моды, работающие с ними, продолжают работать.

СБОРКА

Нужен .NET SDK. Сборки игры берутся из LethalCompany.GameLibs.Steam, поэтому установленная игра для компиляции не требуется.

dotnet build SneakyMasks.csproj -c Release

build-package.ps1 собирает Release и упаковывает архив для Thunderstore в dist/. Переменная окружения LC_PLUGINS заставит копировать собранный DLL сразу в папку плагинов.

БЛАГОДАРНОСТИ

• Автор: Solo00n
• Построен на BepInEx и HarmonyX, оба под лицензией MIT.
• Распространяется под лицензией MIT.

Changelog

1.6.0

• Fixed: masks killed almost the instant they started attaching. The kill had been moved onto MaskClampToHeadAnimationEvent on the understanding that it marked the end of the climb. It does not — vanilla raises it about 0.4 s in, and all it means is that the mask has latched onto the face and the item in hand is gone. The five seconds of suffocation that actually kill you are the attachTimer countdown that follows. Treating the latch as the kill cut the whole attack to a fraction of a second, which is also why the escalation was impossible to see.
• The kill is back on attachTimer, where vanilla has it. The one thing still taken from vanilla is the condition: FinishAttaching is refused unless the mask actually latched on, so a climb that was interrupted cannot kill when the clock runs out.
• Climb speed and escalation now scale both halves — the latch animation through maskAnimator.speed, and the suffocation by dividing attachTimer. At 1x that is vanilla's 0.4 s + 5 s; at the 8x ceiling it is 0.05 s + 0.6 s.
• DebugMode reports the suffocation time before and after scaling, and how long the latch took.

1.5.0

• Fixed: a takeover that drew the climb-on-arrival flip could kill instantly, with no climb animation at all. The climb was being started in the same frame the mask was equipped out of the pocket, on an animator that had not updated since, and the seat event could fire at once. The climb is now started on the following frame, once the mask has settled in the hand.
• Masks get faster the longer you keep them. Every time a mask has had to pull itself out of your pocket, the next climb plays quicker than the last. Carry one long enough and the climb is over before you have seen it start — the kill is still at the top of the climb, there is simply nothing left to react to.
• Escalation is counted per mask and survives being pocketed. Only throwing the mask on the floor puts it back to zero, so shuffling one between slots does not calm it down.
• New [Escalation] section: Enabled, SpeedPerTakeover (default 0.5), MaxSpeed (default 8).
• DebugMode now reports the escalation step alongside each climb's speed and duration.

1.4.0

• A two-handed item no longer keeps a pocketed mask down. When the mask's moment comes, the heavy item is dropped first — through DiscardHeldObject, the same call the drop key ends in — and the mask takes the hand once the game has confirmed the throw.
• Half of all takeovers arrive already climbing. A coin flip (ClimbAtOnceChance, default 50) decides whether a mask that came out on its own gets the usual run-up or presses the key and calls BeginAttachment the moment it lands in the hand. The climb can still be cancelled the usual way; only the run-up is skipped.

1.3.0

• A mask in a pocket does not stay there. Every 20 to 90 seconds (rolled fresh each time it is pocketed) it switches your held item to itself, through the game's own SwitchToItemSlot and SwitchToSlotServerRpc, so the switch is a real one that other players see. From there it is a mask in the hand, hidden delay and all. Carrying one becomes a game of noticing.
• It cannot come out while you hold a two-handed item. That moment is lost and a new wait is rolled, rather than deferred — so putting the heavy thing down is never the cue.
• It also will not come out anywhere the game would not let you scroll: a menu open, an animation playing, typing, the terminal, the slot-switch cooldown. Nor in orbit; the timer holds and runs its full length after landing.
• New [Takeover] section: Enabled, MinDelay, MaxDelay.

1.2.0

• Tragedy and Comedy no longer climb at the same speed. Since the kill happens at the top of the climb, the animation's speed is the whole of the reaction window, so that is what the new [Climb Speed] section sets. Tragedy defaults to 1.6x and Comedy to 0.7x; the base game runs both at 1x, and setting both back to 1 restores that.
• The section is keyed by mask name and written in full on first launch, so masks added by other mods get their own entry without this mod needing to know about them.
• DebugMode now prints how long each climb actually took, in seconds, which is the practical way to tune the speeds.

1.1.0

• The mask now holds the use key for you rather than setting the game's flag behind its back. It goes through UseItemOnClient, the same call your own mouse makes, so the hold animation and the networking that come with a real press happen too — your character visibly raises the mask, and the people around you can see it.
• The kill is now the animation's to decide. Vanilla kills on a five-second stopwatch started when the mask begins climbing, regardless of where the mask actually got to. That stopwatch is now refused, and the kill happens on the animation event raised when the mask seats itself. A mask that has not climbed all the way onto your face cannot attack you, and nothing else can kill through it.
• New PreventDropping option. Vanilla locks you out of dropping and slot switching while the use key is held; the mod lifts that lock by default so putting the mask away stays possible. Set it to true to keep the lock and make a mask in the hand close to a death sentence.

1.0.0

First release.

• Haunted masks lift themselves to the face on their own, after a hidden delay of 1-5 seconds in the hand. Nothing is shown or heard while that delay runs.
• A protection window of 2 seconds once the mask reaches the face, during which the game's roll to take the player cannot happen at all.
• Putting the mask away at any point resets it; the next time it comes out, a new delay is rolled.
• Configurable delay range, protection window, and a switch to turn the whole thing off.