# Installation

> Setup guide for ML LootProps

Category: LOOT PROPS · Source: https://miciomods.it/docs/ml-lootprops-installation · Last updated: 2026-07-05

## Overview

ML LootProps turns any GTA world prop or dead ped/animal into a lootable object. Supports weapon-based kill rewards (different loot per weapon for hunting), tool requirements with durability, minigame locks, dispatch alerts, no-loot zones, loot box stashes, and optional ml_skills XP rewards. All configured through an in-game admin panel.

## Quick Start

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

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_lootprops
```

> **WARNING:** Load Order
>
> `ml_lootprops` must start AFTER `ml_bridge`. Incorrect order causes startup errors.

## Database

> **INFO:** Auto Import
>
> All tables are created on first startup. No SQL to run manually.

The script auto-creates these tables:

- `ml_lootprops_configs`: Prop configurations
- `ml_lootprops_categories`: Loot categories
- `ml_lootprops_settings`: Global settings
- `ml_lootprops_noloot_zones`: Restricted loot areas

## Verify

Start the server and check for:

```lua
[ml_lootprops] [INFO] Database tables verified/created successfully
[ml_lootprops] [INFO] ML LootProps initialized
```

Open the admin panel:

```lua
/mllootprops
```

> **TIP:** Admin Access
>
> Requires admin permissions through your framework (ace perms for QBCore/QBox, admin group for ESX).

**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.
- Prop not lootable. Open the admin panel and verify the model hash is configured with loot tables.
- Dead ped not showing target. The scanner only detects dead non-player peds. Verify the ped model is configured.