Installation

Requirements

Required

• ox_lib - UI and utility library (GitHub (opens in a new tab))

Optional (Auto-detected)

• ox_target or qb-target (for NPC/crate interaction)
• QB-Core, QBX-Core, or ESX (for notifications and item checks)

Installation Steps

Step 1: Download the Resource

Download legends_airdrop from your Keymaster grants or the store.

Step 2: Extract to Resources

Place the legends_airdrop folder into your server's resources directory.

resources/
└── legends_airdrop/
    ├── fxmanifest.lua
    ├── config.lua
    ├── props_config.lua
    ├── client/
    │   └── main.lua
    ├── server/
    │   ├── main.lua
    │   └── utils.lua
    ├── editable/
    │   ├── client.lua
    │   ├── server.lua
    │   └── framework.lua
    └── lang/
        ├── locale.lua
        └── en.json

Step 3: Add to Server Config

Add the following to your server.cfg:

ensure ox_lib

# Optional: targeting system
ensure ox_target   # or qb-target

ensure legends_airdrop

Step 4: Configure Admin Permissions

To use the /airdrop admin command, add the following ACE permission:

add_ace group.admin command.airdrop allow

This grants the admin group permission to use the airdrop command.

Step 5: Add Required Item (Optional)

If using NPC interaction, add the required item to your inventory system.

For ox_inventory

Add to ox_inventory/data/items.lua:

['usb_airdrop'] = {
    label = 'Airdrop USB',
    weight = 50,
    stack = true,
    close = true,
    description = 'Contains coordinates for an airdrop location.'
}

For qb-core

Add to qb-core/shared/items.lua:

['usb_airdrop'] = {
    name = 'usb_airdrop',
    label = 'Airdrop USB',
    weight = 50,
    type = 'item',
    image = 'usb_airdrop.png',
    unique = false,
    useable = false,
    shouldClose = true,
    description = 'Contains coordinates for an airdrop location.'
}

Step 6: Configure (Optional)

Customize settings in config.lua. See the Configuration page for all options.

Step 7: Restart Server

Restart your server or use the refresh and ensure legends_airdrop commands.

Verification

After installation:

1. Use /airdrop 1 as admin to spawn a test airdrop
2. Travel to the location (check your map for the blip)
3. Fight the guards and collect the crate
4. Verify items are added to your inventory

Admin Commands

Custom Maps Installation

The resource includes custom map props that spawn at drop locations. These are handled automatically through props_config.lua.

If you need to add custom MLO or map modifications:

1. Ensure the MLO/IPL is loaded before the airdrop spawns
2. Adjust guard spawn locations in config.lua to match your map

Need help? Join our Discord (opens in a new tab) and open a support ticket!