# Fluid trait reference

Fluid phases, flags, traits and container descriptors.

Edit an existing fluid at `data/<fluid-namespace>/fluid_property/<fluid-path>.json`. The required outer fields are listed below. See [Datapack Settings](https://movblock.mov/ntm-next/26.3/wiki/settings.md) for loading and replacement behavior, and [fluid property patches](https://movblock.mov/ntm-next/26.3/wiki/settings.md#fluid-property-patches) for changing part of a file.

## Outer fields

| Field | Meaning and default | Range |
| - | - | - |
| `type` | Fluid phase: `liquid`, `gaseous`, or `plasma`, as one string or a nonempty list of phase strings. For example, `["liquid", "gaseous"]` declares both phases. | |
| `color` | Fluid display tint as an integer or `#RRGGBB`. | `i32` or #RRGGBB |
| `symbol` | Fluid hazard symbol shown in the UI. | |
| `temperature` | Fluid temperature used by thermal behavior. | `i32` |
| `nfpa` | Health, flame, and reactivity ratings. | |
| `nfpa.health` | Health hazard rating. | `i32` |
| `nfpa.flame` | Flammability rating. | `i32` |
| `nfpa.react` | Reactivity rating. | `i32` |
| `flags` (Optional) | Stateless trait names from the table below. | |
| `traits` (Optional) | Map of [parameterized traits](https://movblock.mov/ntm-next/26.3/wiki/fluid-traits/traits.md). | |
| `containers` (Optional) | Map of [container descriptors](https://movblock.mov/ntm-next/26.3/wiki/fluid-traits/containers.md). | |
| `shares` (Optional) | Fluid-tag references accepted as equivalents by loose tanks. | |

## Stateless flags

| Flag | Effect |
| - | - |
| `gaseous_art` | Enables gas handling by flare and tank systems. |
| `viscous` | Uses viscous fluid handling and flow behavior. |
| `amat` | Applies antimatter containment and drain handling. |
| `leadcontainer` | Requires a lead-compatible fluid container. |
| `delicious` | Heals living entities exposed to its mist. |
| `noid` | Hides the fluid from the fluid identifier. |
| `nocontainer` | Excludes standard fluid-container families. |
| `unsiphonable` | Excludes the fluid from siphon pickup. |

## Value names

| Vocabulary | Accepted names |
| - | - |
| Fuel grade | `LOW`, `MEDIUM`, `HIGH`, `AERO`, `GAS` |
| Heating mode | `BOILER`, `HEATEXCHANGER`, `PWR`, `ICF`, `PA` |
| Cooling mode | `TURBINE`, `HEATEXCHANGER` |
| Pollution | `SOOT`, `POISON`, `HEAVYMETAL`, `FALLOUT` |
| Protection class | `gas_lung`, `gas_monoxide`, `gas_inert`, `particle_coarse`, `particle_fine`, `bacteria`, `gas_blistering`, `sand`, `light` |
| Symbol | `NONE`, `NOWATER`, `RADIATION`, `ACID`, `ANTIMATTER`, `CRYOGENIC`, `OXIDIZER`, `ASPHYXIANT` |

## Foreign-fluid equivalence

`shares` is one hashed fluid-tag reference such as `"#c:diesel"` or a list of references. Loose/code-typed tanks accept tag members and lock to the first arriving fluid. Explicitly selected tank types and ducts use the exact fluid; outputs stay NTM fluids.