Мод «Gas Pump Indicator» для Project Zomboid

Мод окрашивает светодиодную полоску на топливных насосах — небольшой светящийся индикатор над каждым пистолетом — для отображения состояния топлива и питания.

В ванильной версии игры единственный способ проверить состояние насоса — нажать на него правой кнопкой мыши или прочитать табличку «OUT OF GAS», которая появляется рядом с некоторыми насосами случайным образом. Данный мод перекрашивает светодиодную полоску, уже присутствующую на спрайте каждого насоса, делая состояние насоса различимым с любого расстояния на экране.

Обновление (2026-08-07, v1.6): отображение остатка топлива перемещено из настроек мода в настройки песочницы, чтобы им можно было управлять на стороне сервера в мультиплеере. Если функция была включена в v1.5, после обновления она будет отключена по умолчанию. В новом мире её можно включить в настройках песочницы при создании мира. В существующем мире необходимо добавить -debug в параметры запуска игры, включить функцию в отладочном меню настроек песочницы, затем перезагрузить мир.

Состояния светодиода:

• Зелёный светодиод — питание есть, топливо осталось
• Красный светодиод — питание есть, бак пуст
• Светодиод не горит — питания нет (сеть или генератор отключены). В мультиплеере есть ещё один случай, когда светодиод не горит; см. раздел «Мультиплеер».

Свечение ночью (новое в v1.2): ночью светодиод светится зелёным или красным цветом, поэтому состояние остаётся читаемым в темноте. Днём он, как и прежде, сливается с окружающим освещением.

В ванильной версии 42.20 также добавлен эффект освещённого насоса, но он загорается только ночью, пока электросеть ещё работает, и только белым цветом. Светодиод данного мода также работает от генератора, а ночью светится зелёным или красным вместо белого света ванили.

Отображение остатка топлива: при включении параметра «Show remaining fuel in the right-click menu» в настройках песочницы в контекстном меню насоса (по правому клику) отображается оставшееся количество топлива. По умолчанию отключено.

Настройки песочницы фиксируются после создания мира, поэтому для изменения этого параметра в существующем мире требуется параметр запуска -debug и перезагрузка мира.

Насос без питания не показывает остаток, так как количество топлива в нём ещё не определено.

Визуал, соответствующий ванили: форма светодиодной полоски (небольшая щель-параллелограмм над пистолетом) взята напрямую из оригинального спрайта насоса, поэтому перекрашенный светодиод совпадает с ванильным рисунком попиксельно. Смешение по яркости сглаживает края в окружающий корпус насоса, избегая эффекта «плоской цветной наклейки».

Левый и правый пистолеты на одной плитке насоса оцениваются независимо. Поддерживаются разрешения спрайтов как 2x, так и 1x.

Поддерживаемые спрайты насосов: охвачены все 8 ванильных спрайтов топливных насосов:

• Насосы Fossoil (восточное/южное направление × левая/правая плитка)
• Насосы Gas2Go (восточное/южное направление × левая/правая плитка)

Совместимость:

• Поддерживает: Build 42
• Работает в одиночной и многопользовательской игре
• Автономный — работает с ванильной игрой, дополнительные моды не требуются
• Безопасно добавлять или удалять в существующих сохранениях (состояние мира не изменяется)
• Без добавления скриптов или рецептов — только рендеринг и интерфейс

Мультиплеер: протестирован на кооперативном хосте Build 42.

• Светодиод отображается локально на экране каждого игрока. Мод никогда не изменяет и не передаёт состояние мира — ни броски топлива, ни таблички, ни сетевые пакеты.
• Как и любой мод, он должен быть добавлен в список модов сервера, чтобы быть активным в мультиплеере.
• Деталь, характерная только для мультиплеера: насос под питанием может не показывать светодиод, если игра ещё не определила количество топлива в нём (обычно это насос, работающий от генератора, поставленного игроком, которым никто не пользовался). Это сделано намеренно — на клиенте мод читает только то, что уже определено сервером. Используйте насос один раз или покиньте и снова посетите область — любое из этих действий заставляет сервер определить количество топлива, и с этого момента светодиод загорается.

Примечания: после активации генератора, питающего насос, светодиод может появиться через несколько секунд. Сам мод опрашивает состояние часто, но эта задержка вызвана ванильным распространением питания по сети и не может быть сокращена модом.

Технические заметки:

• Использует IsoObject.setOverlaySprite(name, false) — универсальный слот оверлея, безусловно отрисовываемый движком, вызывается в непередающей форме, чтобы оверлей оставался на стороне клиента (безопасно для мультиплеера)
• Обнаружение насосов основано на координатах (а не на ссылках на IsoObject), поэтому выгрузка и загрузка чанков не может рассогласовать оверлей и насос
• Сочетает регистрацию события LoadGridsquare с 5-секундной страховочной проверкой области вокруг игрока, чтобы ни один насос не был пропущен, даже если событие сработало до подключения мода
• Состояние пересчитывается с частотой около 5 Гц на каждый отслеживаемый насос; затраты незначительны даже в насыщенных сценах
• Обрабатывает участки карты, где несколько объектов насосов перекрываются на одной клетке, каждый со своим запасом топлива (такие есть в ванильной карте, например, в районе Луисвилла)
• Ночное свечение — это полнояркостный спрайт оверлея с флагом unlit; белое световое пятно ванили 42.20 отключается у источника путём удаления свойства HasLightOnSprite со спрайтов насосов (v1.4), со старым заполнением слота в качестве запасного варианта

Техническая информация:

• Workshop ID: 3755993986
• ID мода: GasPumpIndicator
• Папка мода: GasPumpIndicator