# Installation

> Setup guide for ML Radiation

Category: RADIATION ZONES · Source: https://miciomods.it/docs/ml-radiation-installation · Last updated: 2026-07-28

## Overview

ML Radiation adds configurable radiation zones with a Geiger Counter UI system. Players accumulate radiation inside zones, take damage at thresholds, and use cure/immunity items for protection. Includes a 3D Geiger Counter prop with DUI rendering, battery system, vehicle/clothing protection, and persistent radiation tracking.

## Quick Start

1. Download from [CFX Portal](https://portal.cfx.re)
2. Extract to your `resources` folder as `ml_radiation`
3. Add to `server.cfg`:

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_radiation
```

> **WARNING:** Load Order
>
> `ml_radiation` must start AFTER `ml_bridge`. The folder must be named exactly `ml_radiation`.

## Database

The table is created automatically on first start:

`ml_player_radiation`: Stores per-player radiation level (auto-saved every 5 minutes and on disconnect)

## Item Registration

Register items from `_INSTALL/` in your inventory system.

**Geiger Counter items**: If using Advanced mode (`Config.RealTerminalItem = true`), register all items in `Config.AdvancedItems`. If using Simple mode (`Config.RealTerminalItem = false`), register only the item in `Config.SimpleMode`.

**Cure items**: Register items listed in `Config.CureItems.Items` (e.g. antiradiation syringes)

**Immunity items**: Register items in `Config.ImmunityItems.Items` (e.g. iodine pills)

**Battery recharge item**: Register the item in `Config.Battery.rechargeItem`

## Stream Assets

The resource includes a custom 3D Geiger Counter model (`dgm_geiger.ytyp`) in the `stream/` directory. Loaded automatically via the manifest.

## Verify

After starting, the console will print:

```lua
[ml_radiation] Resource started
[ml_radiation] Developed by Micio Mods | miciomods.it
```

Use a registered Geiger Counter item to activate the UI.

**Troubleshooting**

- Geiger Counter doesn't open. Verify the item is registered in your inventory and matches the name in `Config.AdvancedItems` or `Config.SimpleMode`.
- Resource name error on startup. The folder must be named exactly `ml_radiation`.
- Radiation is not saving. Check that `oxmysql` is running. Look for errors related to `ml_player_radiation` in the console.
- No visual effects. If `Config.HealthSystemIntegration = true`, damage and visuals are handled by ml_healthsystem instead.