Docs/ORB Shops/Configuration

Configuration

All configuration is in config.lua (not escrowed).

Core Settings

lua
Config.Debug         = false       -- Verbose logging (security checks, validation)
Config.Locale        = 'en'        -- 'en' | 'es' | '' for auto-detect
Config.AutoHideHud   = true        -- Hide the framework HUD while a shop is open
Config.AutoHideChat  = false
Config.PaymentMethod = 'cash'      -- 'cash' | 'bank'
Config.ItemImagePath = ''          -- Override item image path (empty = auto-detect)

Item Shops

Locations (ships with 11 pre-placed 24/7 stores):

lua
Config.ItemShops = {
    {
        name   = '24/7 Store',
        coords = vec3(1985.85, 3052.11, 47.21),
        blip   = { id = 52, color = 2, scale = 0.5, label = '24/7 Store' },
    },
}

Products, grouped into category tabs:

lua
Config.ShopItems = {
    {
        category = 'Food',
        items = {
            { name = 'burger', label = 'Burger', price = 10 },
            { name = 'water',  label = 'Water',  price = 5  },
        },
    },
}

Weapon Shops

Locations (ships with 6 Ammunations) and products use the same structure. Weapons use the WEAPON_ prefix; ammo uses plain item names:

lua
Config.WeaponShops = {
    { name = 'Ammunation', coords = vec3(15.44, -1109.56, 29.79),
      blip = { id = 110, color = 1, scale = 0.5, label = 'Ammunation' } },
}

Config.WeaponItems = {
    {
        category = 'Pistols',
        items = {
            { name = 'WEAPON_COMBATPISTOL', label = 'Combat Pistol', price = 50000 },
        },
    },
    {
        category = 'Ammo',
        items = {
            { name = 'ammo-9', label = '9mm Ammo', price = 20000 },
        },
    },
}

Opening a Shop

Players open a shop by walking within ~2m of a location and pressing E. There are no commands. Press ESC (or Cancel in the UI) to close.