🛠️Configuration

This document describes all configuration options for the DevHub Air Drops resource.

🛠️ Configuration

---

Shared Configuration (configs/shared.lua)

Debug Configuration

Controls debug output for the air drops system.

Shared.Debug = {
    Enabled = true,     -- Set to false to disable all debug prints
    Levels = {
        Info = true,    -- General information
        Success = true, -- Success operations
        Warning = true  -- Warning and potential issues
    }
}

• Enabled: Enables/disables all debug prints.

• Levels: Controls specific debug message types (Info, Success, Warning).

---

Drop Presets Configuration

Defines different categories of items that can be dropped in airdrops. Each preset contains a list of items with their spawn properties.

Shared.DropPresets = {
    ["food"] = { 
        { name = "bread", amount = {min = 1, max = 3}, chance = 75 },
        { name = "water", amount = {min = 1, max = 5}, chance = 20 },
        -- { name = "canned_food", amount = {min = 1, max = 3}, chance = 5 }
    },
    ["medical"] = {
        { name = "bandage", amount = {min = 1, max = 5}, chance = 33 },
        { name = "first_aid_kit", amount = {min = 1, max = 2}, chance = 33 },
        { name = "painkiller", amount = {min = 1, max = 10}, chance = 34 }
    },
    ["weapons"] = {
        { name = "weapon_pistol", amount = {min = 1, max = 1}, chance = 25 },
        { name = "weapon_rifle", amount = {min = 1, max = 1}, chance = 25 },
        { name = "ammo_9mm", amount = {min = 1, max = 150}, chance = 50 }
    },
}

Structure Explanation:

• name: The item identifier/name (must match your inventory system).

• amount: Min and max quantity range for the item.

  • min: Minimum amount to spawn.

  • max: Maximum amount to spawn.

• chance: Percentage chance (0-100) for the item to spawn.

Note: Each preset's chances should ideally sum to 100% for proper distribution.

---

Mission Drop Configuration

Defines special mission-based airdrops with specific loot tables and requirements.

Shared.MissionDrop = {
    { 
        name = "food", 
        chance = 50, 
        amount = {min = 1, max = 5}, 
        requiredItem = { 
            ["crate_key"] = 3,
            ["tools"] = 1
        }
    },
    { 
        name = "medical", 
        chance = 30, 
        amount = {min = 1, max = 5}, 
        requiredItem = false 
    },
    { 
        name = "weapons", 
        chance = 20, 
        amount = {min = 1, max = 5}, 
        requiredItem = { 
            ["crate_key"] = 1
        } 
    }
}

Structure Explanation:

• name: The drop preset category (references Shared.DropPresets).

• chance: Percentage chance for this mission drop type to occur.

• amount: Number of items from the preset to drop.

  • min: Minimum number of items.

  • max: Maximum number of items.

• requiredItem: Items required to open the crate (false = no requirements).

  • Key: Item name.

  • Value: Required quantity.

---

Client Configuration (configs/client.lua)

Guards Settings

Configures NPC guards that protect the air drop zones.

Config.GuardsSettings = {
    amount = {
        min = 5,  -- Minimum number of guards to spawn
        max = 15  -- Maximum number of guards to spawn
    },
    modelsPresets = {
        { "s_m_y_armymech_01", "s_m_m_armoured_02", "mp_s_m_armoured_01" },
        { "s_m_y_blackops_01", "s_m_y_blackops_02", "s_m_y_blackops_03" },
        { "s_m_m_highsec_01", "s_m_m_highsec_02", "a_m_y_hasjew_01", "a_m_m_hasjew_01" },
        { "g_m_y_lost_02", "g_m_y_lost_01", "g_m_y_lost_03" },
        { "s_m_m_marine_01", "s_m_y_marine_01", "s_m_m_marine_02", "s_m_y_marine_02", "s_m_y_marine_03" },
    },
    weapons = {
        "WEAPON_PISTOL",
        "WEAPON_ASSAULTRIFLE",
        "WEAPON_SMG",
        "WEAPON_CARBINERIFLE",
        "WEAPON_COMBATPISTOL",
        "WEAPON_MICROSMG",
        "WEAPON_PUMPSHOTGUN",
        "WEAPON_ASSAULTSHOTGUN",
    }
}

Configuration Details:

• amount: Random number of guards spawned per air drop.

  • min: Minimum guards (5).

  • max: Maximum guards (15).

• modelsPresets: Arrays of ped models for guard variety.

  • Each array represents a thematic group (military, blackops, security, gang, marines).

  • System randomly selects one preset per air drop for visual consistency.

• weapons: List of weapons guards can be equipped with.

  • Guards are randomly assigned weapons from this list.

---

Server Configuration (configs/server.lua)

Air Drop Zones

Defines all possible locations where air drops can occur.

Config.AirDropZones = {
    { coords = vec3(-1215.0327, -1550.9435, 4.3715), radius = 2.0 },
}

• coords: vec3 coordinates (x, y, z) - the center point of the air drop zone.

• radius: The spawn radius around the coordinates (in meters). The air drop will spawn at a random location within this radius from the center point.

To add more zones:

Config.AirDropZones = {
    { coords = vec3(-1215.0327, -1550.9435, 4.3715), radius = 60.0 },   -- 60m spawn radius
    { coords = vec3(2500.0, 3700.0, 45.0), radius = 45.0 },  -- Sandy Shores - 45m radius
    { coords = vec3(-2000.0, 2500.0, 5.0), radius = 35.5 },  -- Paleto Bay - 35.5m radius
}

---

Air Drop Stats

Controls the behavior of falling air drops.

Config.AirDropStats = {
    fallTime = {
        min = 2000,  -- Minimum fall time in milliseconds
        max = 5000,  -- Maximum fall time in milliseconds
    }
}

• fallTime: How long the air drop takes to fall from the sky.

  • min: Minimum fall duration (2 seconds).

  • max: Maximum fall duration (5 seconds).

• Note: Actual fall time is randomized between min and max for each drop.

---

Translation Configuration (configs/translation.lua)

Customize all user-facing text in the resource.

Shared.Lang = {
    ["weight_too_heavy"] = "Weight is too heavy for you, you need to unlock the skill first",
}

• Modify these strings to change the language or customize messages.

• Add your own language translations by following the same format.

---

Customization

Adding New Drop Presets

Create custom loot categories for different scenarios:

Shared.DropPresets = {
    -- Existing presets...
    ["rare_items"] = {
        { name = "diamond", amount = {min = 1, max = 3}, chance = 10 },
        { name = "gold_bar", amount = {min = 2, max = 5}, chance = 30 },
        { name = "rare_artifact", amount = {min = 1, max = 1}, chance = 60 }
    },
    ["tools"] = {
        { name = "lockpick", amount = {min = 5, max = 15}, chance = 40 },
        { name = "advanced_lockpick", amount = {min = 1, max = 5}, chance = 30 },
        { name = "drill", amount = {min = 1, max = 2}, chance = 30 }
    },
}

---

Adjusting Guard Difficulty

Easier (Fewer Guards):

Config.GuardsSettings = {
    amount = {
        min = 2,
        max = 5
    },
    -- Keep weapons list minimal
    weapons = {
        "WEAPON_PISTOL",
        "WEAPON_COMBATPISTOL",
    }
}

Harder (More Guards & Better Weapons):

Config.GuardsSettings = {
    amount = {
        min = 15,
        max = 25
    },
    weapons = {
        "WEAPON_ASSAULTRIFLE",
        "WEAPON_CARBINERIFLE",
        "WEAPON_SPECIALCARBINE",
        "WEAPON_COMBATMG",
        "WEAPON_ASSAULTSHOTGUN",
    }
}

---

Modifying Drop Chances

Adjust the probability of different loot types:

High-Value Drops (More Weapons/Medical):

Shared.MissionDrop = {
    { name = "food", chance = 10, amount = {min = 1, max = 3}, requiredItem = false },
    { name = "medical", chance = 40, amount = {min = 2, max = 6}, requiredItem = false },
    { name = "weapons", chance = 50, amount = {min = 1, max = 3}, requiredItem = { 
            ["crate_key"] = 1
        } 
    }
}

Balanced Drops:

Shared.MissionDrop = {
    { name = "food", chance = 33, amount = {min = 2, max = 5}, requiredItem = false },
    { name = "medical", chance = 33, amount = {min = 2, max = 5}, requiredItem = false },
    { name = "weapons", chance = 34, amount = {min = 1, max = 3}, requiredItem = { 
            ["crate_key"] = 2
        } 
    }
}

---

Creating Locked vs Unlocked Crates

Control which crates require items to open:

All Crates Open (No Requirements):

Shared.MissionDrop = {
    { name = "food", chance = 33, amount = {min = 1, max = 5}, requiredItem = false },
    { name = "medical", chance = 33, amount = {min = 1, max = 5}, requiredItem = false },
    { name = "weapons", chance = 34, amount = {min = 1, max = 5}, requiredItem = false }
}

All Crates Locked:

Shared.MissionDrop = {
    { name = "food", chance = 33, amount = {min = 1, max = 5}, requiredItem = { 
            ["crate_key"] = 1
        } 
    },
    { name = "medical", chance = 33, amount = {min = 1, max = 5}, requiredItem = { 
            ["crate_key"] = 1
        } 
    },
    { name = "weapons", chance = 34, amount = {min = 1, max = 5}, requiredItem = { 
            ["crate_key"] = 2,
            ["advanced_tools"] = 1
        } 
    }
}

---

Advanced Configuration

Creating Themed Guard Presets

Customize guard appearance for different scenarios:

Config.GuardsSettings = {
    amount = { min = 5, max = 15 },
    modelsPresets = {
        -- Military Theme
        { "s_m_y_armymech_01", "s_m_m_armoured_02", "s_m_m_marine_01" },
        
        -- Police/SWAT Theme
        { "s_m_y_swat_01", "s_m_y_cop_01", "s_m_m_fibsec_01" },
        
        -- Gang Theme
        { "g_m_y_ballasout_01", "g_m_y_famca_01", "g_m_y_mexgang_01" },
        
        -- Private Security Theme
        { "s_m_m_highsec_01", "s_m_m_highsec_02", "mp_m_securoguard_01" },
    },
    weapons = {
        "WEAPON_ASSAULTRIFLE",
        "WEAPON_CARBINERIFLE",
        "WEAPON_SMG",
    }
}

---

Dynamic Fall Time Based on Height

Adjust fall times for different scenarios:

Quick Drops (Low Altitude):

Config.AirDropStats = {
    fallTime = {
        min = 1000,  -- 1 second
        max = 2000,  -- 2 seconds
    }
}

Realistic Drops (High Altitude):

Config.AirDropStats = {
    fallTime = {
        min = 5000,  -- 5 seconds
        max = 10000, -- 10 seconds
    }
}

Cinematic Drops (Very Slow):

Config.AirDropStats = {
    fallTime = {
        min = 8000,  -- 8 seconds
        max = 15000, -- 15 seconds
    }
}

---

Troubleshooting

Air drops not spawning:

• ✅ Verify Config.AirDropZones contains valid coordinates.

• Check server console for errors during resource start.

• Ensure the triggering event/command is correctly configured.

Guards not spawning:

• Check Config.GuardsSettings.amount values are greater than 0.

• Verify ped model names in modelsPresets are valid GTA V models.

• Enable debug mode to see spawn messages.

Players can't open crates:

• Verify players have the required items defined in Shared.MissionDrop.requiredItem.

• Check item names match your inventory system exactly (case-sensitive).

• Ensure inventory has space for the dropped items.

Items not being received:

• ✅ Confirm items in Shared.DropPresets exist in your database/item configuration.

• Check item names match exactly (case-sensitive).

• Verify player inventory has sufficient weight capacity.

• Enable debug mode to see item distribution logs.

Guards not attacking:

• Check weapon names in Config.GuardsSettings.weapons are valid.

• Verify no conflicting resources affecting NPC behavior.

---