# Installation

> Setup guide for ML Airdrop

Category: AIRDROP · Source: https://miciomods.it/docs/ml-airdrop-installation · Last updated: 2026-07-28

## Overview

ml_airdrop runs a server-controlled supply drop. A plane flies in, a crate parachutes down, and players race to open it and grab the loot slot by slot. Drops run on a timer, from a flare item, from the admin panel, or from another resource.

## Quick Start

1. Download from [CFX Portal](https://portal.cfx.re).

2. Extract to your `resources` folder as `ml_airdrop`.

3. Add it to `server.cfg` after ml_bridge:

**server.cfg**

```cfg
ensure oxmysql
ensure ox_lib
ensure ml_bridge
ensure ml_airdrop
```

> **WARNING:** Load Order
>
> `ml_airdrop` must start after `ml_bridge`, `ox_lib` and `oxmysql`.

## Database

Tables are created automatically on first start. To provision them upfront, run `_INSTALL/schema.sql`.

- `ml_airdrop_config`: stores the planes, crates, loot, zones and flares edited in the panel.
- `ml_airdrop_history`: stores every past drop and who took what.

## Item Registration

Add these to your inventory items file. `crowbar` and `drill` often already exist, so only add what is missing.

- `airdrop_flare`: fired by a player to call a drop to their position.
- `crowbar`: opens standard containers.
- `drill`: opens reinforced containers and vehicle drops.

Ready-to-paste definitions are in `_INSTALL/items.lua`. The tools each crate needs are set per crate in the admin panel.

## Open The Panel

Type `/airdrop` in chat as an admin to open the panel. From there you trigger drops and edit planes, crates, loot, zones and flares.

## Verify

After starting, the console prints:

```bash
[ml_airdrop] Resource started
```

**Troubleshooting**

- Panel will not open - confirm your account passes the admin check, or set `Config.Admin.AcePermission`.
- Nothing drops on a solo test - use the panel and pick "here" so the drop lands at your position, or lower `Config.AutoEvents.minPlayers`.
- Crate cannot be opened - the crate needs a tool the player is missing. Check the crate open method in the panel.