Skip to content
KS-Inventory

KS-Inventory

Installation

  1. Unzip the delivered archive into your resources/ folder, under the name ks-inventory.
  2. Import the provided install.sql file into your database.
  3. Add ensure ks-inventory to your server.cfg, after oxmysql and qb-core.
  4. Restart your server.

Configuration

Config.Containers = {
  glovebox = { enabled = true, maxWeight = 4000, sharedWithPlate = true },
  trash = { enabled = true, maxWeight = 2000, despawnAfter = 900 }, -- secondes avant vidage auto
  stash = { defaultWeight = 100000 },
}

sharedWithPlate = true ties the glovebox to the vehicle’s plate: every player holding the keys can access it, regardless of which garage it’s parked in.

Creating a shared stash

A stash restricted to a job or faction is declared with:

exports['ks-inventory']:RegisterStash('faction_police', {
  label = "Armurerie LSPD",
  slots = 40,
  maxWeight = 80000,
  groups = { ["police"] = 0 }, -- accessible à partir du grade 0
})

The stash’s contents are shared in real time between every authorized player who opens it at the same time.

Common issues

Gloveboxes don’t appear on some vehicles. Check that the vehicle model is listed in Config.Containers.glovebox.vehicleWhitelist (empty = all vehicles allowed by default) and that sharedWithPlate matches the behavior you want.

Items disappear from trash bins too quickly. Adjust Config.Containers.trash.despawnAfter (in seconds) — the default value auto-empties trash bins to prevent clutter from piling up over time.

Something not covered here? Join our Discord.