Night Vision Goggles
A fully-featured night vision system with three distinct vision modes, intelligent auto-activation, and extensive customization options. Perfect for tactical gameplay, roleplay servers, or any scenario where darkness is a challenge.
NOW FEATURING A Q MENU CLIENT CONFIGURATION MENU!
Three Vision Modes
– Standard Night Vision – Classic green phosphor tube aesthetic with authentic bloom and grain effects
– White Phosphorus – Modern military-grade white/blue-tinted vision for improved clarity
– Thermal Imaging – Advanced heat signature detection with through-wall visibility (configurable range and wall penetration)
Flexible Control Options
– SWEP Controls – Left Click: toggle on/off | Right Click: cycle modes | Reload: toggle auto-activation
– Console Commands – Full functionality without needing the weapon equipped (see commands section)
– Auto-Activation System – Automatically enables NVG in dark environments with smart cooldown to prevent flickering
Deep Customization
– Server-Side Configuration – Control visual effects, thermal detection rules, HUD elements, and performance limits
– Client-Side Settings Panel – Players can customize their experience via F1 menu (Utilities > User > Night Vision Settings)
– Individual Crosshair Control – Players choose their own crosshair style and visibility regardless of server settings
Configurable Effects
– Adjustable vignette intensity (0-255)
– Film grain overlay
– Horizontal CRT scanlines
– Vertical distortion sweep effect
– Dynamic projected lighting with ADS auto-disable
– Thermal grain "snow" effect (toggleable for performance)
Thermal Mode Features
– Detect players, NPCs, NextBots, Lambda Players, and scripted entities
– Optional vehicle and prop detection
– See through walls (configurable: 0 – # of wall penetration)
– Admin invisibility support (respects noclip/fly/invisible states)
– Custom heat signature support via entity variables
– Performance-optimized with entity count and distance limits
Available Elements
– Real-time light level (LUX) meter
– Power/battery indicator
– Current vision mode display
– Timestamp display
– Corner bracket frames
– Device information text
– Three crosshair styles: Simple cross, Circular with ticks, Angled brackets with rangefinder
Positioning Control
All HUD elements can be positioned independently in any corner (top_right, top_left, bottom_right, bottom_left) with adjustable offsets and opacity.
Auto-Activation Settings
Vision Mode Control
Performance Tuning
Thermal Detection
Basic Controls (work without SWEP)
Player Crosshair Customization
Players can customize their experience via F1 Menu > Utilities > User > Night Vision Settings:
– Toggle individual visual effects (grain, scanlines, vignette, etc.)
– Adjust vignette intensity
– Choose crosshair style and visibility
– Control HUD element visibility
– Set HUD opacity
– Enable/disable thermal grain effect
– Reset to defaults button
All settings save automatically and persist between sessions.
Setup
1. Subscribe to this addon
2. Join your server or start singleplayer
3. Find "Night Vision Goggles" in spawn menu under "Tetra" category
4. (Optional) Edit lua/autorun/nvg_config.lua for server-wide settings
5. (Optional) Players customize via Q > Utilities > User > Night Vision Settings
Usage
– Equip the SWEP and use mouse buttons + reload key
– OR use console commands (nvg_toggle, nvg_mode, etc.)
– Players adjust their crosshair without affecting others
For Developers
– Mark entities as heat sources: `ent:SetNWBool("HeatSignature", true)`
– Mark entities as cold: `ent:SetNWBool("ThermalCold", true)`
– Hook into client-only mode: `NVG_GetClientOnlyState()` returns active state and current mode
– Check command availability: `NVG_AreClientCommandsAllowed()`
Performance Optimized
– Configurable entity limits for thermal mode
– Distance-based culling
– Optional line-of-sight checking
– Efficient material override system
– Smart cache updates with adjustable refresh rates
– Fully multiplayer compatible with proper networking
– No external dependencies or requirements
– Client-side settings don’t require server changes
– Server administrators control thermal detection rules
– Individual players customize visual preferences
– Supports custom NPCs, NextBots, and Lambda Players
– Respects admin invisibility (noclip, fly mode, invisible players [configurable])
Works with most addons out of the box. Thermal mode automatically detects:
– Players and NPCs
– NextBot entities
– Lambda Players
– Scripted entities
– Vehicles (optional)
– Props (optional)
– Custom entities with heat signature flags
Full documentation included in addon files. All configuration options are clearly commented.
Questions? Issues? Leave a comment or check the configuration file for detailed explanations of each setting.
