stm-NeedStamina icon

NeedStamina

Cruiser jump practice: saved positions

By stm
Last updated an hour ago
Total downloads 3
Total rating 1 
Categories Mods Tools AI Generated
Dependency string stm-NeedStamina-1.0.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

NeedStamina

Мод для тренировки круизер-джампов в Lethal Company: позиции круизера, телепорт, повторы прыжков, запись GIF и многое другое. Установка: через r2modman или Thunderstore Mod Manager, нужен только BepInExPack.

  • Сохранение / загрузка позиции Cruiser: у хоста и у клиентов.
  • Телепорт работает, даже если за рулём или внутри сидит другой игрок.
  • Магнит включается и выключается у любого игрока на расстоянии.
  • Меню можно двигать мышью за шапку (верхняя полоса); место запоминается. Сброс: settings, menu, reset.

Меню (клавиша P)

  • positions: вкладки all / favorites / луны. Во вкладке all сверху избранные, потом позиции по лунам, внизу позиции без луны. В каждой строке есть кнопка клавиши: клик, потом нажать клавишу (Esc отмена, Backspace очистить).
  • binds: все клавиши в одном месте: клавиши мода и клавиша каждой позиции.
  • settings: бэкап, звук, счётчик попыток, HUD круизера, линия траектории.

Клавиши (меняются в меню, раздел binds)

Действие Клавиша по умолчанию
Открыть меню P
Сохранить новую позицию [
Загрузить последнюю позицию (если круизер прикреплён к магниту: магнит выключается, телепорт, магнит включается обратно; если не прикреплён: сразу телепорт и включение магнита, если он выключен; включение управляется настройкой «magnet on load last») R
Магнит вкл/выкл \
Телепорт игрока (прицел) ]
Добавить удачную попытку =
Добавить проваленную попытку -
Смотреть последний прыжок (во время повтора останавливает) I

Клавиши не срабатывают, пока открыт чат, терминал или меню игры.

Обмен позициями

Кнопка share в строке позиции открывает меню:

  • copy code: код NSC1:... копируется в буфер обмена, друг вставляет его кнопкой import.
  • send in game: список игроков лобби, у которых стоит мод. Выбираете игрока, позиция уходит ему. Сообщение идёт через хост, поэтому мод должен стоять у хоста.

Получатель видит надпись на экране и вкладку received в разделе positions (в ней число новых запросов):

  • сверху запросы: accept принимает, decline отклоняет;
  • ниже принятые позиции (они хранятся в файле NeedStaminaCruiser.received.txt). ПКМ по позиции: add to all positions переносит её в общий список, дальше она обычная (ТП, клавиша, избранное, счётчик), или remove.

Передаются название, координаты, поворот и луна. Клавиша, счётчик и избранное не передаются. Код проверяется контрольной суммой и ограничением координат.

Второе окно

Второе окно для необязательных и фановых функций. Отдельной кнопки нет: оно показывается всегда вместе с главным меню. Оно того же размера и стиля, что главное меню, двигается за шапку, место запоминается отдельно. Закрыли главное меню (P), исчезло и второе; открыли главное, второе вернулось. При первом открытии окна встают рядом: второе слева, главное справа. Вернуть так: settings, menu, reset.

  • на схеме схематично показаны корабль (прямоугольник) и выходы: главный вход (квадрат) и пожарные выходы (пустой квадрат). Они запоминаются, когда корабль сел на луну, поэтому карту любой посещённой луны можно смотреть из другого места; набор пожарных выходов обновляется при каждой посадке (файл NeedStaminaCruiser.landmarks.txt);
  • колесо мыши над картой приближает и отдаляет (к точке под курсором), приближенную карту двигают левой кнопкой мыши. Самое дальнее отдаление равно исходному размеру карты, отдельной кнопки сброса нет. Слева есть легенда и текущий зум;
  • fail: прыжок, во время которого круизер при включённом бессмертии (indestructible) должен был взорваться. Мод считает хп сам: урон блокируется, но каждый удар вычитается из виртуальных хп, и когда они дошли бы до нуля, под часами игры появляется уведомление CRUISER WOULD HAVE EXPLODED, а записываемый в этот момент прыжок помечается как fail. После этого счёт начинается заново. На карте fail рисуются красным, счётчик fails стоит рядом с total jumps. Последний прыжок рисуется золотым, а если он fail, ярко-красным;
  • кнопка с названием луны открывает список лун, выбираете луну и видите её карту; при посадке на новую луну открывается её карта;
  • линии записываются на той луне, на которой вы находитесь, независимо от того, чью карту смотрите;
  • линии свои у каждого игрока: пишутся только прыжки, которые вы сами запросили (клавиша, кнопка TP, load last), телепорты других игроков не пишутся;
  • total jumps и total fails: сумма прыжков и фейлов выбранной луны по всем сессиям, без лимита; под ними счёт выбранной сессии (session N / N fails);
  • save session: текущая сессия уходит в архив (нужно нажать дважды), линии сжимаются до опорных точек, начинается новая пустая сессия. Пустую сессию сохранить нельзя;
  • delete last line: удалить последнюю линию выбранной луны в текущей сессии (счёт уменьшается на один прыжок);
  • clear map: очистить карту выбранной луны в текущей сессии и обнулить её счёт для этой луны (нужно нажать дважды). Total других сессий не меняется.

Сессии. Прыжки пишутся в текущую сессию, у неё свой счёт по лунам. Лимит 300 линий на луну действует только на то, что нарисовано на карте текущей сессии: старые линии стираются, а счёт остаётся.

archive (вторая вкладка): общие total по всем лунам и список сессий (дата, прыжки, фейлы, главные луны). view открывает архивную сессию на карте (back to current возвращает), delete удаляет архивную сессию вместе со счётом (нужно нажать дважды).

Линия записывается после телепорта столько секунд, сколько задано в settings (длительность линии траектории). Если машина почти не двигалась, линия не сохраняется. Сессии и линии лежат в NeedStaminaCruiser.jumps.txt. Старый файл без сессий читается: все его линии станут текущей сессией.

Карта на экране

Кнопка pin to screen в подвале вкладки map закрепляет карту на экране. Когда меню закрыто, карта остаётся на экране в уменьшенном виде (60% от окна, чуть прозрачная). Пока меню открыто, карту можно двигать мышью (рамка подсвечивается, внизу подпись drag to move), положение запоминается. Повторное нажатие (unpin from screen) убирает её.

  • Показывается карта луны, на которой вы сейчас, и линии текущей сессии (не зависит от того, что открыто в окне карты, зум и архив на неё не влияют). Новые прыжки появляются сразу.
  • Размер и прозрачность: конфиг, раздел Map pin (Scale, Opacity). Вернуть на место по умолчанию (справа): settings, menu, reset.

Камера повтора (окно watch cruiser)

Третье окно watch cruiser (того же стиля, но меньше, двигается за шапку, по умолчанию встаёт под вторым; сброс положения: settings, menu, reset). Слева список разделов (пока один, watch cruiser), сюда будут добавляться новые функции повторов. В разделе watch cruiser: последние прыжки этой игры, сохранённые повторы (имя, share, импорт кода) и присланные друзьями. Кнопка play проигрывает прыжок заново. Клавиша I (меняется в binds) сразу запускает последний записанный прыжок, повторное нажатие останавливает повтор.

Повтор проигрывается так: По записанному пути летит копия круизера (его меши и материалы, без физики и сети), настоящая машина на время повтора прячется только у вас; на земле рисуется линия пути (пройденная часть яркая, остальная бледная), а игровая камера следует за машиной. Если копию построить не удалось, рисуется проволочная коробка по размерам машины. Игрок на время повтора стоит на месте.

Клавиши: Space пауза, ← → перемотка на секунду, ↑ ↓ скорость (0,1x до 2x), C или клик по списку камер слева: камера (chase, orbit, side, top, roof: вид с крыши, free: свободная камера, где W A S D летишь туда, куда смотришь, Q E вниз и вверх, Shift быстрее, колесо меняет скорость, а смотреть мышью надо с зажатой правой кнопкой), R сначала, G записать повтор в GIF, H спрятать панель и интерфейс игры (при возврате игра проигрывает эффект включения HUD, надпись SYSTEMS ONLINE мод прячет), Esc или I выход. Если картинка камеры не меняется, нажмите V: это запасной способ подмены камеры.

Кадры (положение и поворот около 15 раз в секунду) пишутся для последних 30 прыжков и хранятся только в памяти, после перезапуска игры повторов нет. Записываются только свои телепорты.

Показ нажатий в повторе

Пока пишется прыжок, в каждый кадр повтора записывается, какие клавиши нажаты: W A S D, пробел, Shift, Ctrl, E, левая и правая кнопки мыши, клавиша телепорта на последнюю позицию, клавиша магнита мода и состояние самого магнита (включён или нет). Короткие нажатия не теряются. В повторе над полосой времени рисуется панель INPUTS в стиле спидраннеров: нажатые клавиши подсвечены, и при перемотке она показывает нужный момент. Панель прячется вместе с остальным интерфейсом клавишей H.

  • Нажатия входят в код повтора (формат NSR1, версия 2), поэтому друг, получивший ваш повтор, видит то же самое. Повторы, записанные до этой версии, и старые коды открываются как раньше, но без панели.
  • Записывается физическое состояние клавиатуры и мыши. Если клавиши переназначены в самой игре, показываются стандартные.
  • Код записи и панели: Plugin.ReplayKeys.cs.

Темы

Простые цветовые темы (crimson, violet, ocean, moss, amber, mono) меняют только цвета. Готические темы (blood, bone, amethyst, ash gothic) добавляют оформление: двойная рамка со свечением, угловые завитки, звезда на верхней грани, меч у левого края и чернильное пятно с трещинами у левой стороны окна. Орнаменты рисуются на всех окнах мода и красятся цветом темы.

Счётчик попыток

Выключен по умолчанию, включается в settings (attempt counter). Полностью ручной: клавиши = и - добавляют удачную или проваленную попытку последней использованной позиции. Автоматического подсчёта нет.

Погода

Погода выбирается из выпадающего списка (world, кнопка погоды рядом с луной). На луне, где стоит корабль, она меняется сразу, без пересадки. Если корабль в орбите, погода включится при посадке.

Темы меню

Второе окно, вкладка themes: шесть цветовых тем (crimson, violet, ocean, moss, amber, mono). Кнопка use у темы, она применяется сразу и запоминается. Меняется акцент и лёгкий оттенок фона, расположение и размеры не меняются.

Бэкап

settings, backup. При запуске игры мод копирует позиции, сессии с линиями, ориентиры карты, принятые позиции и конфиг в BepInEx\config\NeedStaminaCruiser.backups\<дата_время>\, если с прошлой копии прошло не меньше суток (EveryHours в конфиге). Хранятся последние 7 копий (Keep). Кнопки backup now (копия сразу) и open folder. Чтобы вернуть данные: закройте игру и скопируйте файлы из нужной папки в BepInEx\config с заменой.

Экспорт карты

На карте кнопка export png сохраняет картинку выбранной луны и сессии (линии, позиции, корабль, выходы, подпись с названием луны, счётом и датой) в BepInEx\config\NeedStaminaCruiser.exports\. Масштаб автоматический (всё помещается), зум окна на картинку не влияет. Кнопка open folder рядом открывает эту папку.

Важно

  • Мод должен стоять у хоста и у каждого, кто жмёт кнопки или ведёт машину. Остальным он не нужен. Обмен позициями в игре работает между игроками, у которых стоит мод.
  • Сохранение одно на лобби и хранится у хоста.
  • При проблемах пришлите BepInEx\LogOutput.log (строки с NeedStaminaCruiser). В логе при первом запуске будет список найденных полей Cruiser.

Тема bone gothic

Потрёпанный серый стиль: неровная рамка с тонкой внутренней линией, зерно и царапины на фоне, затемнённая шапка, меч в боковой колонке. Остальные темы не затронуты. Текстуры генерирует gothic_gen.py (save_bone), результат лежит в GothicData.cs, отрисовка в Plugin.Gothic.cs (DrawBoneFrame), цвета в Plugin.Theme.cs. Примерный вид: bone_preview.png.

Вкладка glow

Постоянное мягкое свечение всей картинки (HDRP Bloom): кнопка on/off и ползунок силы 0-100%. По умолчанию свечение выключено. Значение и состояние запоминаются в конфиге (раздел Glow, переключатель Active; свечение перезаписывается каждый кадр, поэтому игра его не сбрасывает. Под ползунком показано, сколько компонентов Bloom найдено в сцене. Код в Plugin.Glow.cs.

Запись повтора в GIF

В окне watch cruiser у каждого прыжка (последние, сохранённые, присланные) есть кнопка gif. Во время просмотра повтора то же делает клавиша G (запись идёт с начала). Файл появляется в BepInEx\config\NeedStaminaCruiser.exports\ (needstamina_<луна>_<дата_время>.gif), открыть папку можно кнопкой open folder в том же окне.

  • В кадр попадает картинка игры, линия пути, панель INPUTS с нажатиями и полоса с названием луны, временем и ходом прыжка. HUD игры и остальной интерфейс мода на время записи скрыты. Камера та же, что выбрана в повторе (C во время записи меняет её).
  • Запись идёт строго по кадрам повтора (шаг 1/fps), поэтому не зависит от частоты кадров игры. Если кодировщик не успевает, повтор сам подождёт, картинка может на это время подтормаживать. Esc или I отменяют запись, файл удаляется.
  • Размер: gif size small (480 px по ширине), medium (640), large (1280, по умолчанию). Частота: gif fps 10, 15 или 20 (по умолчанию 15). Те же значения в конфиге, раздел Gif (Size, Fps). large при 15 fps на 10-20 секунд прыжка весит порядка 10-30 МБ, для Discord (лимит 10 МБ) берите medium или small, либо fps 10.
  • GIF кодируется в фоновом потоке (свой кодировщик, без внешних библиотек): неизменившиеся пиксели между кадрами становятся прозрачными, у каждого кадра своя палитра на 255 цветов. По окончании в игре появляется надпись с размером файла.
  • Кадр берётся с экрана в конце кадра (ReadPixels). Если картинка оказалась пустой, мод сам переключается на ScreenCapture и пишет об этом в лог. Менять размер окна игры во время записи нельзя (запись прервётся).
  • Код: Plugin.Gif.cs (запись и фоновая работа), GifWriter.cs (кодировщик GIF).

Перемотка повтора мышью

Полосу времени внизу повтора можно кликать и тянуть: время прыгает в нужное место, пока держите кнопку, повтор стоит на паузе, после отпускания возвращается прежнее состояние (играл или стоял). Над полосой показывается время под курсором. Клавиши ←→ по-прежнему двигают на 1 с.