# Equipment protection

Hazard protection, gas-mask filters and armor cladding.

File: `data/<namespace>/hbm/equipment_protection/<path>.json`.

The registry loads with the world and syncs to clients. Each item belongs to one rule; overlapping selectors fail world startup. Replace the original resource ID to change a shipped assignment. Reopen singleplayer or restart the server after editing rules or their tags.

## Fields

| Field | Meaning and default | Range |
| - | - | - |
| `targets` | Item ID, `#namespace:tag`, or item-ID list. | |
| `hazards` (Optional) | Hazard classes blocked by the item; default empty. | |
| `filter_exclusions` (Optional) | Declares the item as a gas mask and lists hazards it cannot block through a filter. An empty list declares a mask without exclusions; omission leaves it undeclared as a mask. | |
| `filter` (Optional) | Allows the item to be installed as a gas-mask filter; default false. | |
| `filter_tooltip_after_item` (Optional) | Places mask filter information after the item's own tooltip; default false. | |
| `cladding` (Optional) | Declares an armor cladding item and its radiation resistance, installation slots, and tooltip. | |
| `cladding.resistance` | Radiation resistance exponent added by the installed cladding. | `[0, f64::MAX]` |
| `cladding.slots` | Nonempty list of head, chest, legs, or feet. | |
| `cladding.show_tooltip` (Optional) | Shows cladding resistance and allowed armor slots; default true. | |

Hazard names are `gas_lung`, `gas_monoxide`, `gas_inert`, `particle_coarse`, `particle_fine`, `bacteria`, `gas_blistering`, `sand`, and `light`. Hazard-class checks read the head slot: the worn item's `hazards`, a mask's installed filter `hazards` minus the mask's `filter_exclusions`, and the same for each armor mod installed in the worn item. Cladding resistance adds to [worn armor resistance](https://movblock.mov/ntm-next/26.3/wiki/hazards-and-radiation/hazmat-protection.md).

## Faraday armor

A player wearing Faraday armor in all four armor slots takes no Tesla Coil damage. A piece is Faraday armor when it is in `#hbm:faraday_armor` or has installed cladding with positive resistance.

## Example:

File: `data/example/hbm/equipment_protection/helmet_mask.json`.

```json
{
  "targets": "minecraft:iron_helmet",
  "filter_exclusions": [
    "gas_monoxide"
  ]
}
```

This declares the helmet as a mask that accepts filters but excludes carbon-monoxide protection.
