Beathoven's Night Vision Framework
Фото и видео: 1 из 12. Материалы автора из Steam Workshop.
О материале
«Beathoven's Night Vision Framework» — материал мастерской Project Zomboid. Карты, транспорт, оружие и моды для выживания. Данные Steam, описание автора и ссылка для установки через подписку. Совместимость редакцией не проверена.
Описание автора
Night Vision Framework
A framework for adding realistic night vision functionality to Project Zomboid items. Includes a working example item: Night Vision Goggles that can be found in military loot.
Known supported Mods
How to Use
-
Find or spawn the example Night Vision Goggles.
-
Right-click the goggles in your inventory and select Insert Battery. This is only available while they are in inventory and not worn.
-
Wear the goggles.
-
Press V to toggle night vision on or off. If your item supports exact _ON / _OFF or _DOWN / _UP state tokens, the visor model flips automatically.
Features
-
Multiple NV modes — shipped with Default, Default /w Glare, Single Point Light, Single Point Light /w Glare, White Phosphor, White Phosphor Overlay, White Phosphor Overlay /w Glare, and Zomboid Native modes, with room for add-on modes from other mods. The Debug authoring mode is exposed only in debug-enabled singleplayer.
-
Custom framework overlay — tint, grain, vignette, flicker, and climate tinting driven by per-mode profiles.
-
Dynamic directional lighting — raycasted light cone with opening-aware LOS, low-cover exemptions, curtain-aware windows and see-through openings, plus reduced lightpost churn for better performance.
-
Single-point-light modes — built-in point-light variants can replace the directional cone with one client-local light centered on the player.
-
Debug authoring mode — built-in live editor with instant preset import for registered non-vanilla modes plus direct directional-light controls, available only in debug-enabled singleplayer.
-
Overlay glare variants — dedicated glare-enabled built-in modes are available for Default, Single Point Light, and White Phosphor Overlay.
-
Vanilla helper light — the built-in Zomboid Native mode can still receive a framework indoor helper light in very dark rooms.
-
Singleplayer helper sandbox toggle — the sandbox can choose whether singleplayer uses the TorchCone-backed directional helper or the lamppost-style fallback helper.
-
Battery system — install/remove batteries via right-click. Each battery lasts 12 in-game hours. Charge bar visible on the item tooltip and updates live while charge drains. Low battery triggers a flicker warning below 20%.
-
Multiplayer sync — battery state, live charge-bar updates, battery install/remove actions, and named visor state variants are synchronized through shared/server framework code.
-
Sound support — on/off clicks plus a subtle ambient hum while NV is active.
-
Fully localized — 27 language translations included.
Mod Options
Open Options → Mod Options → Night Vision Framework to configure:
-
Night Vision Mode — choose between the shipped modes or registered add-on modes. The debug authoring mode only appears in debug-enabled singleplayer.
-
Legacy light cone sampling — defaults to on for the denser classic cone look; disable it to switch to the lighter sparse sampler on weaker PCs.
-
Toggle key — rebind the NV toggle key (default: V).
-
Debug Overlay Editor key — open the live editor while the debug mode is active (default: N). This row only appears in debug-enabled singleplayer.
-
Enable ambient NV hum — toggle the looping ambient sound (default: on).
-
Ambient hum volume — slider 0–100% (default: 30%). Changes apply live.
Shipped mode notes:
-
Default — classic green phosphor look with the restored wide light cone and no glare.
-
Default /w Glare — the Default profile with bright-room glare enabled.
-
Single Point Light — reuses the Default overlay but swaps the cone for one client-local light centered on the player.
-
Single Point Light /w Glare — the single-point-light variant with glare enabled.
-
Directional shipped modes default to legacy cone sampling, but legacy rebuild checks are throttled and players can switch to sparse sampling at runtime in Mod Options.
-
Directional LOS now treats fences, counters, and half walls as low cover instead of solid walls, and supported windows or see-through openings follow curtain state.
-
Debug — live overlay and directional-light authoring mode with instant preset import for registered non-vanilla modes, exposed only in debug-enabled singleplayer.
-
White Phosphor — cooler grayscale or blue-white profile.
-
White Phosphor Overlay — white-phosphor overlay paired with the single-point-light path instead of the directional cone.
-
White Phosphor Overlay /w Glare — the phosphor overlay point-light variant with glare enabled.
-
Zomboid Native — Zomboid's built-in night vision effect plus a tuned indoor helper light.
For Modders
Add NightVision = true, to a clothing item script and the framework will handle the rest. Tags = NVITEM, is still accepted as a legacy fallback. Full documentation lives in README.md.
Features available to modders:
-
Automatic NV detection via the NightVision = true script key
-
Battery-aware toggle flow with automatic shutdown on invalid gear or empty battery
-
Exact state-token swapping for _ON / _OFF and _DOWN / _UP
-
Dynamic directional-light helper, single-point-light helper, or vanilla-style indoor helper reuse
-
Texture-backed overlay noise via noiseTexturePaths for filmed or sensor-style modes
-
Built-in in-game debugger for live overlay and directional-light tuning in debug-enabled singleplayer
-
External mode registration through NV.RegisterNightVisionMode({ ... })
-
Copyable dummy mode example with tuned overlay and light profiles, including comments for the framework light flags and profile variables
-
Complete example item with models and textures
Model swap: To get the visor-up or visor-down visual, provide two item variants that use exact _ON / _OFF or _DOWN / _UP state tokens in the item name. The framework swaps only that exact token, so names like ..._UP-HeadStrap are handled safely.
Multiplayer note: Battery state, live battery-bar updates, battery install/remove, and named visor state variants use shared or server-authoritative synchronization. The screen effect itself remains local to the wearer, as intended.
This mod can be added to and extended by anyone in the community, but credit must be given to the original author within the files of the mod - and posted alongside the mod wherever it roams.
Workshop ID: 3684087856 Mod ID: NVFramework
Как установить и запустить
Откройте оригинальную страницу в Steam Workshop, проверьте версию игры, зависимости и порядок загрузки в описании автора. Нажмите «Подписаться» и дождитесь загрузки Steam. Включите материал в меню модификаций или контента игры, если это требуется. Совместимость и запуск редакцией не проверены.