Better Vanilla Filters and UI
Build 42.16.x / 42.17 gas mask and respirator filter HUD with better mask actions, optional no-mask auto-hide, Best Available filter swaps, and RealismV4-friendly QoL.
This mod adds a cleaner and more practical gas mask and respirator filter HUD for Build 42.16.x and 42.17 while staying focused on vanilla-style gameplay.
What This Mod Does
[hr][list]
[*] Adds a compact on-screen Filter UI for gas masks and respirators.
[*] Shows the actually equipped mask, not a fake UI-only item.
[*] Displays live remaining filter durability with a large, easy-to-read status bar.
[*] Uses a transparent HUD that can be moved freely and remembers its saved position.
[*] Lets you drag the HUD by left-clicking the mask frame.
[*] Opens custom Mask Actions and quick-equip options when you right-click the HUD icon.
[*] Shows only real wearable masks in Wear Filtered Mask, not refill filters or carrier items.
[*] Can automatically fade the HUD out when no compatible mask is equipped, if enabled in Mod Options.
[*] Changes bar color as durability drops and gives a strong warning when the filter is critical or missing.
[/list]
Gameplay Integration
[hr][list]
[*] Built around vanilla and RealismV4 filter behavior first.
[*] Reads the real filter state from the equipped item so HUD and tooltip stay aligned.
[*] Includes a sandbox filter durability multiplier so filters can last longer without changing the HUD's 0-100% scale.
[*] Supports vanilla-style gas masks, respirators, and compatible modded masks that use the normal filter system.
[*] Filter Actions search your inventory recursively for compatible filters instead of only checking the top level.
[*] Best Available always chooses the non-empty compatible filter with the highest remaining durability.
[*] Replacing a filter puts the old filter back into your inventory instead of deleting it.
[*] Attaching and replacing filters use timed actions instead of instant swaps.
[/list]
Sandbox & Options
[hr][list]
[*] Sandbox option: Filter durability multiplier from x1.0 up to x5.0.
[*] Mod options: separate scale controls for the mask icon and the durability bar.
[*] Compact presets include 0.75x and 0.5x, and the durability bar also supports a dedicated 3x option.
[*] Mod option: optional no-mask auto-hide. Off by default.
[*] When no-mask auto-hide is enabled, mouseover brings the HUD back temporarily and equipping a mask brings it back normally.
[*] The durability bar always stays normalized to 0-100%, even when filters last longer.
[/list]
Compatibility
[hr][list]
[*] Works standalone.
[*] Compatible with Build 42.16.x and Build 42.17.
[*] Designed around vanilla and RealismV4 first.
[*] Compatible with Gas Mask Attach for hotbar/attachment-based gas mask carry and quick equip workflows.
[*] Compatible with Necroa Mod and Necroa Mod | Legacy as fallback-compatible filter sources.
[*] Compatible with supported modded gas-mask items such as KATTAJ1 Military Pack and the supported [J&G] uniform packs.
[*] Does not require Susceptible to function.
[*] If Susceptible-style HUDs are present, this mod is intended to replace their filter display with its own cleaner panel.
[*] Avoids false HUD triggers from mask carrier pouches and other non-mask container items.
[/list]
Known Compatible Masks & Mods
[hr][list]
[*] Vanilla gas masks and respirators
[*] RealismV4
[*] Gas Mask Attach
[*] Necroa Mod
[*] Necroa Mod | Legacy
[*] KATTAJ1 Military Pack
[*] [J&G] Umbrella Corp Uniform
[*] [J&G] Alpine Multicam Uniform
[*] [J&G] Caution Pack
[*] [J&G] Firefighter Uniform
[/list]
Design Notes
[hr][list]
[*] Focus is clarity, low UI clutter, and practical information during normal play.
[*] The panel is intentionally lightweight and visually distinct from Susceptible.
[*] No fake extra systems, no decorative nonsense, just a better read on your filter status.
[/list]
Current Features
[hr][list]
[*] Transparent HUD background
[*] Optional no-mask auto-hide with quick fade and mouseover reveal
[*] Large equipped-mask display
[*] Separate icon scale and durability bar scale options
[*] Thick, high-visibility durability bar with compact presets and bar-only 3x
[*] Color states for safe / warning / critical filter levels
[*] Motion warning for critical durability and No Filter
[*] HUD right-click submenu for Wear Filtered Mask, All Mask Actions, and Filter Actions
[*] Attach Best Available and Replace With Best Available shortcuts
[*] Recursive best-filter search that ignores empty filters
[*] Timed filter attach and replace behavior instead of instant actions
[*] Old filter is returned to inventory when you replace it
[/list]
Recommended Mods
My Mods
Feedback & Bug Reports
Balancing and compatibility feedback are welcome.
For bug reports, include:
- Game build
- Which mask/filter was used
- Relevant mods that may affect masks, filters, UI, or Realism/Necroa behavior
- Relevant lines from:
console.txt
usually in:
C:\Users\*YOUR NAME*\Zomboid
Workshop ID: 3710116647
Mod ID: bettervanillafiltersanduiID