Exports

Client

DisableShop

Disables a specific shop by its ID

Usage:

exports['envi-shops']:DisableShop(shopID, cooldownTime)

-- Disables the '24/7 - Strawberry' shop until it is enabled again
exports['envi-shops']:DisableShop('24/7 - Strawberry')

-- Disables the '24/7 - Strawbeery' shop for 300 seconds
exports['envi-shops']:DisableShop('24/7 - Strawberry', 300)

Parameters:

• shopID (string): The ID of the shop to disable.

• cooldownTime (number): The cooldown time in seconds before the shop is auto-enabled again.

EnableShop

Enables a specific shop by its ID.

Usage:

exports['envi-shops']:EnableShop(shopID)

-- Enables the '24/7 - Strawberry' shop, if it is disabled
exports['envi-shops']:EnableShop('24/7 - Strawberry')

Parameters:

• shopID (string): The ID of the shop to enable.

DisableAllShops

Disables all shops in the config file

Usage:

exports['envi-shops']:DisableAllShops(cooldownTime)

-- Disables all shops for 600 seconds (10 minutes)
exports['envi-shops']:DisableAllShops(600)

Parameters:

• cooldownTime (number): The cooldown time in seconds before the shops are auto-enabled again.

EnableAllShops

Enables all shops

Usage:

exports['envi-shops']:EnableAllShops()

Server

GetItemStock

Get the current stock quantity for a specific item in a shop.

local stock = exports['envi-shops']:GetItemStock(shopName, itemName)

Parameters:

• shopName (string): The name of the shop (e.g., "24/7 Supermarket 1")

• itemName (string): The item identifier (e.g., "water")

Returns:

• number: Current stock quantity (returns 0 if not found)

Example:

local waterStock = exports['envi-shops']:GetItemStock("24/7 Supermarket  1", "water")
print("Water bottles in stock:", waterStock)

SetItemStock

Set the stock quantity for a specific item in a shop to an exact value.

local success = exports['envi-shops']:SetItemStock(shopName, itemName, quantity)

Parameters:

• shopName (string): The name of the shop

• itemName (string): The item identifier

• quantity (number): The new stock quantity

Returns:

• boolean: true if successful, false if shop/item not found

Example:

-- Set water stock to exactly 100
local success = exports['envi-shops']:SetItemStock("24/7 Supermarket  1", "water", 100)
if success then
    print("Stock updated successfully")
end

AddItemStock

Add stock to a specific item (increases current stock).

local success = exports['envi-shops']:AddItemStock(shopName, itemName, quantity)

Parameters:

• shopName (string): The name of the shop

• itemName (string): The item identifier

• quantity (number): Amount to add

Returns:

• boolean: true if successful, false if shop/item not found

Example:

-- Add 50 water bottles to existing stock
exports['envi-shops']:AddItemStock("24/7 Supermarket  1", "water", 50)

RemoveItemStock

Remove stock from a specific item (decreases current stock).

local success = exports['envi-shops']:RemoveItemStock(shopName, itemName, quantity)

Parameters:

• shopName (string): The name of the shop

• itemName (string): The item identifier

• quantity (number): Amount to remove

Returns:

• boolean: true if successful, false if shop/item not found

Example:

-- Remove 10 water bottles from stock
exports['envi-shops']:RemoveItemStock("24/7 Supermarket  1", "water", 10)

GetShopStock

Get all stock for a specific shop.

local stockTable = exports['envi-shops']:GetShopStock(shopName)

Parameters:

• shopName (string): The name of the shop

Returns:

• table: Table of all items and their quantities (empty table if shop not found)

Example:

local stock = exports['envi-shops']:GetShopStock("24/7 Supermarket  1")
for itemName, quantity in pairs(stock) do
    print(itemName, "has", quantity, "in stock")
end

GetAllStock

Get the complete stock table for all shops.

local allStock = exports['envi-shops']:GetAllStock()

Returns:

• table: Complete stock table with all shops and items

Example:

local allStock = exports['envi-shops']:GetAllStock()
for shopName, shopStock in pairs(allStock) do
    print("Shop:", shopName)
    for itemName, quantity in pairs(shopStock) do
        print("  -", itemName, ":", quantity)
    end
end

ResetShopStock

Reset stock for a specific shop back to config values.

local success = exports['envi-shops']:ResetShopStock(shopName)

Parameters:

• shopName (string): The name of the shop

Returns:

• boolean: true if successful, false if shop not found in config

Example:

-- Reset one shop's stock to config defaults
exports['envi-shops']:ResetShopStock("24/7 Supermarket  1")

ResetAllStock

Reset all shop stock back to config values.

local success = exports['envi-shops']:ResetAllStock()

Returns:

• boolean: Always returns true

Example:

-- Reset all shops to config defaults
exports['envi-shops']:ResetAllStock()

Stock Exports Usage Examples

Example 1: Restocking Script

CreateThread(function()
    while true do
        Wait(3600000) -- 1 hour
        local shopName = "24/7 Supermarket  1"
        exports['envi-shops']:ResetShopStock(shopName)
        print("Shop restocked:", shopName)
    end
end)

Example 2: Admin Command

RegisterCommand('restock', function(source, args)
    if not IsPlayerAceAllowed(source, 'admin') then return end
    
    if args[1] == 'all' then
        exports['envi-shops']:ResetAllStock()
        TriggerClientEvent('chat:addMessage', source, {
            args = {'[ADMIN]', 'All shops restocked!'}
        })
    else
        local shopName = table.concat(args, ' ')
        local success = exports['envi-shops']:ResetShopStock(shopName)
        if success then
            TriggerClientEvent('chat:addMessage', source, {
                args = {'[ADMIN]', 'Shop restocked: ' .. shopName}
            })
        else
            TriggerClientEvent('chat:addMessage', source, {
                args = {'[ERROR]', 'Shop not found: ' .. shopName}
            })
        end
    end
end, false)

Example 3: Low Stock Print

-- Check for low stock every 30 minutes
CreateThread(function()
    while true do
        Wait(1800000) -- 30 mins
        local allStock = exports['envi-shops']:GetAllStock()
        for shopName, shopStock in pairs(allStock) do
            for itemName, quantity in pairs(shopStock) do
                if quantity < 5 then
                    print(string.format("[LOW STOCK] %s in %s: %d remaining", itemName, shopName, quantity))
                end
            end
        end
    end
end)

---

Shop Names

To use these exports, you need the exact shop names from your config. Default examples:

• "24/7 Supermarket 1"

• "24/7 Supermarket 2"

• "Liquor Store 1"

• "Liquor Store 2"