Configuration

All keys live in config.lua.

Key	Type	Default	Description
`Config.Version`	string	`'1.0.0'`	Resource version string, checked against remote on boot.
`Config.CreatorCommand`	string	`'shopcreator'`	Command name (registered server-side) that opens the admin shop creator UI.
`Config.RestockEnabled`	boolean	`true`	Enables the periodic restock loop for finite-stock items.
`Config.RestockInterval`	number	`30`	Minutes between restock sweeps.
`Config.RestockPercent`	number	`25`	Percent of an item's `max_stock` restored per restock sweep.
`Config.FluctuationEnabled`	boolean	`true`	Enables random price fluctuation over time.
`Config.FluctuationInterval`	number	`60`	Minutes between price fluctuation regenerations.
`Config.FluctuationRange`	number	`15`	Max percent (+/-) an item's price can randomly vary per fluctuation tick.
`Config.InteractionDistance`	number	`2.5`	Distance at which the target interaction to open a store becomes available (client-side).
`Config.DefaultBlipSprite`	number	`52`	Fallback blip sprite when a shop doesn't specify one.
`Config.DefaultBlipColor`	number	`2`	Fallback blip color when a shop doesn't specify one.
`Config.DefaultBlipScale`	number	`0.7`	Fallback blip scale when a shop doesn't specify one.
`Config.PedPresets`	table	10 built-in entries	`{ label, model }` list offered in the creator's ped selector (Shop Clerk Male/Female, Convenience Store, Farmer, Mechanic, Bartender, Fisherman, Doctor, Ammunation, Street Vendor).
`Config.Webhooks`	table	all keys `''`	Discord webhook URLs. Keys: `ShopCreated`, `ShopEdited`, `ShopDeleted`, `ItemPurchased`, `RestockEvent`. Leave a key as `''` to disable that webhook.

Notes

Config.RestockEnabled/Config.FluctuationEnabled run on independent timers — disabling one does not affect the other.
Config.RestockInterval and Config.FluctuationInterval are in minutes.
Config.DefaultBlipSprite/Color/Scale are fallbacks only; per-shop blip settings configured in the creator override them and changing defaults does not retroactively affect existing shops.
Config.PedPresets only populates the creator's selector list — it does not restrict which ped models can be used if set another way.
Leave unused Config.Webhooks entries as empty strings (''), not nil, to avoid errors.
Changing Config.CreatorCommand requires only editing config.lua and restarting the resource; the actual registration happens in server/server.lua.

Configuration

All keys live in config.lua.

Key

Type

Default

Description

Config.Version

string

'1.0.0'

Resource version string, checked against remote on boot.

Config.CreatorCommand

string

'shopcreator'

Command name (registered server-side) that opens the admin shop creator UI.

Config.RestockEnabled

boolean

true

Enables the periodic restock loop for finite-stock items.

Config.RestockInterval

number

30

Minutes between restock sweeps.

Config.RestockPercent

number

25

Percent of an item's max_stock restored per restock sweep.

Config.FluctuationEnabled

boolean

true

Enables random price fluctuation over time.

Config.FluctuationInterval

number

60

Minutes between price fluctuation regenerations.

Config.FluctuationRange

number

15

Max percent (+/-) an item's price can randomly vary per fluctuation tick.

Config.InteractionDistance

number

2.5

Distance at which the target interaction to open a store becomes available (client-side).

Config.DefaultBlipSprite

number

52

Fallback blip sprite when a shop doesn't specify one.

Config.DefaultBlipColor

number

2

Fallback blip color when a shop doesn't specify one.

Config.DefaultBlipScale

number

0.7

Fallback blip scale when a shop doesn't specify one.

Config.PedPresets

table

10 built-in entries

{ label, model } list offered in the creator's ped selector (Shop Clerk Male/Female, Convenience Store, Farmer, Mechanic, Bartender, Fisherman, Doctor, Ammunation, Street Vendor).

Config.Webhooks

table

all keys ''

Discord webhook URLs. Keys: ShopCreated, ShopEdited, ShopDeleted, ItemPurchased, RestockEvent. Leave a key as '' to disable that webhook.

Notes

Config.RestockEnabled/Config.FluctuationEnabled run on independent timers — disabling one does not affect the other.

Config.RestockInterval and Config.FluctuationInterval are in minutes.

Config.DefaultBlipSprite/Color/Scale are fallbacks only; per-shop blip settings configured in the creator override them and changing defaults does not retroactively affect existing shops.

Config.PedPresets only populates the creator's selector list — it does not restrict which ped models can be used if set another way.

Leave unused Config.Webhooks entries as empty strings (''), not nil, to avoid errors.

Changing Config.CreatorCommand requires only editing config.lua and restarting the resource; the actual registration happens in server/server.lua.