# Installation

> Setup guide for ML LootZones

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

## Overview

ML LootZones creates dynamic loot areas where specific props spawn for players to search and collect. Zones, categories, loot tables, and prop placements are configured through an in-game admin panel. Supports category-based zone rotation, fixed and random prop spawning, tool requirements, minigames, dispatch alerts, loot box stashes, and optional ml_skills XP rewards.

## Quick Start

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

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_lootzones
```

> **WARNING:** Load Order
>
> `ml_lootzones` must start AFTER `ml_bridge`.

## Database

Tables are created automatically on first start:

`ml_lootzones_areas`: Zone configurations and prop placements

`ml_lootzones_categories`: Loot categories and reward pools

`ml_lootzones_settings`: Global creator settings

`ml_loot_types`: Loot type definitions (fixed/probability loots)

`ml_world_props`: Persistent world prop configurations

`ml_prop_categories`: World prop category cycling rules

## Verify

After starting, the console will print:

```lua
[ml_lootzones] Database initialized successfully.
[ml_lootzones] Loot active. Loaded 0 areas.
```

Open the admin panel with `/mlloot` (requires admin permissions via your framework).

**Troubleshooting**

- Script not starting. Verify all dependencies are running. Check ensure order in `server.cfg`.
- Admin command not working. Confirm admin permissions in your framework. Check console for permission errors.
- Props not spawning. Verify "Spawn Props" is enabled in the zone config and valid prop models are assigned.
- Density warning in console. Too many props configured for the zone radius. Reduce count or increase radius.
- Loot unavailable right after a restart. The Dynamic System startup delay is active. Wait for it to elapse, or set it to `0` in the Settings tab.