# Item settings

Storage, dropped-item reactions, tool abilities, guns and potion sickness.

Registry: `hbm:item_config`. Files: `data/hbm/hbm/item_config/<group>.json`. See [Game settings](https://movblock.mov/ntm-next/26.3/wiki/game-settings.md) for loading, replacement and validation.

## items

| Field | Meaning and default |
| - | - |
| `crate_keeps_contents` | The Iron, Steel, Desh and Tungsten Crates, the Safe and Pneumatic Storage Network - Clutter Storage keep their inventory in the dropped block item. `false` spills the contents and drops an empty block; a locked crate or Safe drops unlocked and its contents are destroyed. Default `true`. |
| `enable_mku` | Enables MKU contagion: infection, spread between entities and items, and its effects; default `true`. |
| `taint_trails` | Tainted entities leave taint below them, and Tainted Creeper explosions spread taint that keeps creeping; default `false`. |

Example: `data/hbm/hbm/item_config/items.json`.

```json
{
  "crate_keeps_contents": true,
  "enable_mku": true,
  "taint_trails": false
}
```

## drops

Each item below disappears when it triggers, whether or not its effect is enabled.

| Field | Meaning and default |
| - | - |
| `antimatter_cell_explodes` | A landed Antimatter Cell or Antimatter Cluster explodes, and a landed Antischrabidium Cell detonates a blast of [`a_schrab_radius`](https://movblock.mov/ntm-next/26.3/wiki/game-settings/explosion_config.md#explosions); default `true`. |
| `dead_man_explosive_detonates` | A landed Dead Man's Explosive explodes; default `true`. |
| `singularity_spawns` | A landed Miniature Black Hole, Singularity, Contained Counter-Resonant Singularity, Superheated Resonating Singularity or Spark Singularity spawns its black hole or vortex; a landed Digamma Particle spawns a quasar; default `true`. |
| `star_blaster_cell_explodes` | A dropped Rigged Star Blaster Energy Cell detonates a radius-100 blast when burning or 50 seconds after dropping; default `true`. |
| `xen_crystal_moves_blocks` | A landed Artificial Xen Crystal lifts nearby blocks; default `true`. |

Example: `data/hbm/hbm/item_config/drops.json`.

```json
{
  "antimatter_cell_explodes": true,
  "dead_man_explosive_detonates": true,
  "singularity_spawns": true,
  "star_blaster_cell_explodes": true,
  "xen_crystal_moves_blocks": true
}
```

## tools

Disabled abilities are unavailable on every tool.

| Field | Meaning and default |
| - | - |
| `ability_centrifuge` | Auto-Centrifuge; default `true`. |
| `ability_crystallizer` | Auto-Crystallizer; default `true`. |
| `ability_explosion` | Explosion; default `true`. |
| `ability_furnace` | Auto-Smelter; default `true`. |
| `ability_hammer` | AoE and Flat AoE; default `true`. |
| `ability_luck` | Fortune; default `true`. |
| `ability_mercury` | Mercury Touch; default `true`. |
| `ability_shredder` | Auto-Shredder; default `true`. |
| `ability_silk` | Silk Touch; default `true`. |
| `ability_vein` | Vein Miner; default `true`. |
| `veinminer_breaks_netherrack` | Vein Miner runs from blocks in `#minecraft:base_stone_nether`; default `false`. |
| `veinminer_breaks_stone` | Vein Miner runs from blocks in `#minecraft:base_stone_overworld`; default `false`. |

Example: `data/hbm/hbm/item_config/tools.json`.

```json
{
  "ability_centrifuge": true,
  "ability_crystallizer": true,
  "ability_explosion": true,
  "ability_furnace": true,
  "ability_hammer": true,
  "ability_luck": true,
  "ability_mercury": true,
  "ability_shredder": true,
  "ability_silk": true,
  "ability_vein": true,
  "veinminer_breaks_netherrack": false,
  "veinminer_breaks_stone": false
}
```

## weapons

| Field | Meaning and default |
| - | - |
| `enable_guns` | NTM gun key controls: primary, secondary and tertiary actions and reloading; default `true`. |

Example: `data/hbm/hbm/item_config/weapons.json`.

```json
{
  "enable_guns": true
}
```

## player

| Field | Meaning and default | Range |
| - | - | - |
| `potion_sickness` | Potion Sickness applied by medical syringes and [`potion_sickness` treatment actions](https://movblock.mov/ntm-next/26.3/wiki/consumable-treatments/potion-sickness.md): `OFF` none, `NORMAL` the listed duration, `TERRARIA` 12 times the listed duration; default `OFF`. | `OFF`, `NORMAL`, `TERRARIA` |

Example: `data/hbm/hbm/item_config/player.json`.

```json
{
  "potion_sickness": "OFF"
}
```