Configuration

All Config keys in config.lua, with defaults and effects.

All keys live in config.lua.

Key	Type	Default	Description
`Config.Version`	string	`'1.0.0'`	Resource version string. Do not change unless updating the resource itself.
`Config.CreatorCommand`	string	`'shopcreator'`	Chat/console command that opens the shop creator UI. Admin-only, enforced server-side via `Framework.GetIsFrameworkAdmin`.
`Config.RestockEnabled`	boolean	`true`	Enables automatic periodic restocking of shop item stock.
`Config.RestockInterval`	number	`30`	Minutes between automatic restock ticks.
`Config.RestockPercent`	number	`25`	Percentage (not a decimal — `25` means 25%) of an item's `max_stock` restored per restock tick.
`Config.FluctuationEnabled`	boolean	`true`	Enables automatic price fluctuation for shop items over time.
`Config.FluctuationInterval`	number	`60`	Minutes between price fluctuation ticks.
`Config.FluctuationRange`	number	`15`	Maximum percentage (+/-) an item's price can drift from its base price per tick.
`Config.InteractionDistance`	number	`2.5`	Distance at which a player can interact with a shop ped to open the store.
`Config.DefaultBlipSprite`	number	`52`	Default blip sprite for shop blips unless overridden per-shop.
`Config.DefaultBlipColor`	number	`2`	Default blip color for shop blips unless overridden per-shop.
`Config.DefaultBlipScale`	number	`0.7`	Default blip scale for shop blips unless overridden per-shop.
`Config.PedPresets`	table	10 entries (Shop Clerk Male/Female, Convenience Store, Farmer, Mechanic, Bartender, Fisherman, Doctor, Ammunation, Street Vendor)	List of `{ label, model }` entries offered as selectable ped presets in the shop creator UI.
`Config.Webhooks`	table	`{ ShopCreated='', ShopEdited='', ShopDeleted='', ItemPurchased='', RestockEvent='' }`	Discord webhook URLs per event type. Leave a value as `''` to disable logging for that event.

Notes

Config.CreatorCommand only sets the command name — admin enforcement happens in server/server.lua (~line 511), not in config.lua. Restricting who can use it requires editing server code / your permission setup.
Config.Webhooks entries must stay as empty strings ('') to disable; do not remove the keys entirely.
Config.PedPresets model names must be valid, streamable ped models — invalid names may fail silently or crash ped creation in the creator.
Config.RestockPercent and Config.FluctuationRange are plain percentages (e.g. 25 = 25%), not decimals — using 0.25 produces a near-zero effect.
Config.FluctuationEnabled and Config.RestockEnabled run on independent timers; disabling one does not affect the other.
Disabling fluctuation after prices have already been generated leaves the previously generated prices in place (unused) until fluctuation is re-enabled and the next interval tick fires, or the resource restarts.

Key

Type

Default

Description

Config.Version

string

'1.0.0'

Resource version string. Do not change unless updating the resource itself.

Config.CreatorCommand

string

'shopcreator'

Chat/console command that opens the shop creator UI. Admin-only, enforced server-side via Framework.GetIsFrameworkAdmin.

Config.RestockEnabled

boolean

true

Enables automatic periodic restocking of shop item stock.

Config.RestockInterval

number

30

Minutes between automatic restock ticks.

Config.RestockPercent

number

25

Percentage (not a decimal — 25 means 25%) of an item's max_stock restored per restock tick.

Config.FluctuationEnabled

boolean

true

Enables automatic price fluctuation for shop items over time.

Config.FluctuationInterval

number

60

Minutes between price fluctuation ticks.

Config.FluctuationRange

number

15

Maximum percentage (+/-) an item's price can drift from its base price per tick.

Config.InteractionDistance

number

2.5

Distance at which a player can interact with a shop ped to open the store.

Config.DefaultBlipSprite

number

52

Default blip sprite for shop blips unless overridden per-shop.

Config.DefaultBlipColor

number

2

Default blip color for shop blips unless overridden per-shop.

Config.DefaultBlipScale

number

0.7

Default blip scale for shop blips unless overridden per-shop.

Config.PedPresets

table

10 entries (Shop Clerk Male/Female, Convenience Store, Farmer, Mechanic, Bartender, Fisherman, Doctor, Ammunation, Street Vendor)

List of { label, model } entries offered as selectable ped presets in the shop creator UI.

Config.Webhooks

table

{ ShopCreated='', ShopEdited='', ShopDeleted='', ItemPurchased='', RestockEvent='' }

Discord webhook URLs per event type. Leave a value as '' to disable logging for that event.

Notes

Config.CreatorCommand only sets the command name — admin enforcement happens in server/server.lua (~line 511), not in config.lua. Restricting who can use it requires editing server code / your permission setup.

Config.Webhooks entries must stay as empty strings ('') to disable; do not remove the keys entirely.

Config.PedPresets model names must be valid, streamable ped models — invalid names may fail silently or crash ped creation in the creator.

Config.RestockPercent and Config.FluctuationRange are plain percentages (e.g. 25 = 25%), not decimals — using 0.25 produces a near-zero effect.

Config.FluctuationEnabled and Config.RestockEnabled run on independent timers; disabling one does not affect the other.

Disabling fluctuation after prices have already been generated leaves the previously generated prices in place (unused) until fluctuation is re-enabled and the next interval tick fires, or the resource restarts.