KS-Shops

Installation

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

Configuration

Config.Shops = {
  {
    label = "Épicerie de Sandy Shores",
    coords = vec4(1961.6, 3739.9, 32.3, 210.0),
    items = {
      { name = "sandwich", price = 5, stock = 50 },
      { name = "water_bottle", price = 3, stock = 100 },
    },
    linkedCompany = nil, -- optionnel : identifiant d'entreprise KS-Corporate
  },
}

Leave linkedCompany as nil for a classic shop whose revenue goes straight to the player or the server, depending on Config.DefaultRevenueTarget.

Linking a shop to a company

Simply fill in the relevant KS-Corporate company identifier:

Config.Shops[1].linkedCompany = "epicerie_sandy"
-- chaque vente reverse automatiquement la recette à la trésorerie de l'entreprise via KS-Corporate

The link is one-way (revenue flows up to the company) — stock stays managed independently on the shop side.

Common issues

Stock doesn’t restock automatically. Enable Config.RestockInterval (in minutes) — left as nil, restocking stays manual via the dedicated admin command.

Revenue doesn’t flow to the linked company. Check that linkedCompany exactly matches the identifier configured in KS-Corporate, and that KS-Corporate starts before ks-shops in server.cfg.