Configuration

Overview of configuration files, limits, drop intervals, and modular item definitions.

Core Configuration (configs/config.lua)

• Framework: Automatically detects ESX or QBCore frameworks.
• Weight Limits: Configures Config.PlayerInvWeight default maximum inventory weight.
• Slot Limits: Configures Config.PlayerInvSlots default maximum inventory slots.
• Default Stash: Sets Config.DefaultStashWeight and Config.DefaultStashSlots capacity values.
• Item Drops: Sets ground item cleanup interval via Config.ClearDropInterval.

Weapon Configuration (configs/config-weapon.lua)

• Initial Ammo: Defines ammo count given when spawning weapons.
• Attachments: Maps weapon component items to weapon component hashes.
• Repair Mechanics: Defines required items and quantities for weapon repairs.

Clothing Configuration (configs/config-clothing.lua)

• Clothing Items: Defines inventory items that function as clothing props.
• Skin Mapping: Maps items to player ped drawable and texture IDs.

Backpack Configuration (configs/config-backpack.lua)

• Backpack Items: Defines items that provide additional inventory storage.
• Capacity: Sets custom slots and weight limits per backpack.
• Blacklists: Restricts nested backpacks or prohibited items within containers.

Vehicle Configuration (configs/config-vehicle.lua)

• Class Capacity: Sets default trunk and glovebox capacity by class.
• Model Overrides: Sets specific slot and weight limits per vehicle model.

Shared Directory (shared/)

• items.lua: Defines standard item labels, weights, stack limits, and decay.
• weapons.lua: Defines weapon entries, ammo types, durability degradation, and throwables.
• ammo.lua: Defines ammunition item entries and item weights.
• components.lua: Defines weapon attachment components and client weapon hashes.
• shops.lua / vending.lua: Configures shop coordinates, prices, stock, and required jobs.
• crafting.lua: Defines crafting stations, required ingredients, and craft duration.
• stash.lua / dumpsters.lua: Preconfigures static world stashes and dumpster loot tables.

Webhooks (webhooks.lua)

• Add and Remove: Logs spawned and deleted item transactions.
• Swap Item: Logs slot swaps within the same inventory.
• Transfer: Logs item transfers between players, stashes, and trunks.

Locales (locales/)

• Language Files: Contains translation strings for notifications, tooltips, and UI.
• Configuration: Set active locale in configs/config.lua.