configuration

File content database.sql

iSanz Labs Configuration Documentation

Complete guide to the config.lua file with detailed explanations, Bridge system documentation, and practical examples.

---

Table of Contents

• Introduction

• Config.Base

• Config.FatherTable

• Config.Raids

• Config.LaptopPenalty

• Config.Dispatch

• Config.Commands

• Config.MiniGames

• Config.Products

• Config.Upgrades

• Config.XP

• Config.Ranks

• Config.RandomLocations

• Config.BlipSettings

• Config.LabSettings

• Config.Items

• Config.FeedSettings

• Config.Growth

• Config.PlantSettings

• Config.Plant

• Config.TableInteractions

• Config.DollCraft

• Config.RollingPaper

• Config.Strains

• Config.SellingBehavior

• Config.SellingZones

• Config.Selling

• Config.Interactions

• Config.Locations

• Bridge System

• Best Practices

• Troubleshooting

---

Introduction

This documentation covers all configuration options available in the iSanz Labs resource. The configuration is split between shared/config.lua (main configuration) and shared/locations.lua (location-specific settings).

Configuration Access

You can access the configuration from other resources using the export:

local Config = exports['iSanz_Labs']:GetConfig()

---

Config.Base

Purpose: Core framework dependencies and external resources configuration. This section determines which framework systems the script will use.

Structure

Config.Base = {
    core = 'qb-core',              -- Framework: qb-core or qbx_core
    menu = 'iSanz-menu',           -- Menu: iSanz-menu, qb-menu, or ox_lib
    input = 'iSanz-input',         -- Input: iSanz-input, qb-input, or ox_lib
    interact = 'interact',         -- Interaction: interact, qb-target, or ox_target
    inventory = 'qb-inventory',    -- Inventory: qb-inventory, ox_inventory, ps-inventory, or qs-inventory
    progressbar = 'qb',            -- Progressbar: qb or ox
    notify = 'qb',                 -- Notify: qb or ox_lib
    webhooks = false,              -- Enable Discord webhooks
    webhookURL = ''                -- Discord webhook URL
}

Available Options

Parameter	Options	Description
core	qb-core, qbx_core	Your framework name. The script auto-detects which is running.
menu	iSanz-menu, qb-menu, ox_lib	Menu system for UI interactions.
input	iSanz-input, qb-input, ox_lib	Input dialog system for text/number inputs.
interact	interact, qb-target, ox_target	Interaction system for world interactions.
inventory	qb-inventory, ox_inventory, ps-inventory, qs-inventory	Inventory system your server uses.
progressbar	qb, ox	Progress bar system for timed actions.
notify	qb, ox_lib	Notification system for player messages.
webhooks	true, false	Enable/disable Discord webhook integration.
webhookURL	string	Discord webhook URL (required if webhooks enabled).

Example

Config.Base = {
    core = 'qb-core',
    menu = 'ox_lib',
    input = 'ox_lib',
    interact = 'ox_target',
    inventory = 'ox_inventory',
    progressbar = 'ox',
    notify = 'ox_lib',
    webhooks = true,
    webhookURL = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_URL'
}

Bridge System Integration

The Bridge system automatically adapts to your Config.Base settings. For example:

• Setting inventory = 'ox_inventory' makes the Bridge use exports.ox_inventory functions

• Setting interact = 'qb-target' makes the Bridge use exports['qb-target'] functions

---

Config.FatherTable

Purpose: Main laptop location and access permissions configuration. This is where players hack the laptop to gain lab access.

Structure

Config.FatherTable = {
    coords = vector3(x, y, z),     -- Laptop coordinates in the world
    gang = "gang_name",            -- Allowed gang name (must match QB-Core gang name)
    passwordLength = {min = number, max = number}  -- Password length range for laptop
}

Example

Config.FatherTable = {
    coords = vector3(1396.22, 1132.43, 113.85),
    gang = "mafia",
    passwordLength = {min = 4, max = 7}
}

Details

• coords: World coordinates where the laptop spawns. Use /tp command in-game to find exact coordinates.

• gang: Must match the gang name in your QB-Core qb-core/shared/gangs.lua file (case-sensitive).

• passwordLength: Random password length generated for each hack attempt.

---

Config.Raids

Purpose: Raid mechanics configuration for attacking other labs.

Structure

Config.Raids = {
    OnlyRandomRaids = boolean,           -- Only random raids (no targeted raids)
    RandomRaidPrice = number,            -- Price for random raid (cash/bank)
    RaidPrice = number,                  -- Price for targeted raid (cash/bank)
    SafePassTime = number,               -- Time to open safe (minutes, 0 = instant)
    RaidCooldownBetweenRaids = number,   -- Cooldown between raids (minutes)
    ImmunityAfterRaid = number,          -- Immunity period after being raided (minutes)
    DoorOpenCooldown = number            -- Wait time before door opens during raid (minutes)
}

Example

Config.Raids = {
    OnlyRandomRaids = true,
    RandomRaidPrice = 7500,
    RaidPrice = 15000,
    SafePassTime = 0,
    RaidCooldownBetweenRaids = 25,
    ImmunityAfterRaid = 45,
    DoorOpenCooldown = 1
}

Details

• OnlyRandomRaids: If true, players can only raid random labs. If false, they can target specific gangs.

• RaidPrice: Cost is deducted from player's cash/bank (based on Config.Products.defaultMoneyType).

• SafePassTime: Time window to open the safe during a raid (0 = no time limit).

• Cooldowns: All time values are in minutes.

---

Config.LaptopPenalty

Purpose: Configure XP loss penalty for failed laptop hacks.

Structure

Config.LaptopPenalty = {
    xpLoss = number  -- XP amount lost on failed hack attempt
}

Example

Config.LaptopPenalty = {
    xpLoss = 500
}

---

Config.Dispatch

Purpose: Police dispatch system configuration for suspicious sales.

Structure

Config.Dispatch = {
    system = "qb",                    -- qb | ps | cd | custom
    title = "Suspicious Sale",        -- Dispatch title
    code = "10-90",                   -- Dispatch code
    message = "Suspicious street sale reported.",  -- Dispatch message
    blip = {                          -- Blip settings
        sprite = 161,                 -- Blip sprite ID (GTA V sprite IDs)
        color = 1,                    -- Blip color ID (0-85)
        scale = 1.2                   -- Blip scale/size
    }
}

Available Systems

• qb - QB-Core dispatch (default)

• ps - Project Sloth dispatch

• cd - Core Dispatch

• custom - Custom dispatch system (requires custom code)

Example

Config.Dispatch = {
    system = "ps",
    title = "Suspicious Activity",
    code = "10-90",
    message = "Suspicious street sale reported in the area.",
    blip = { sprite = 161, color = 1, scale = 1.2 }
}

Bridge Integration

The Bridge automatically calls the correct dispatch system based on Config.Dispatch.system. See bridge/dispatch.lua for implementation details.

---

Config.Commands

Purpose: Command permissions and access control for admin/gang commands.

Structure

Config.Commands = {
    command_name = {
        enabled = boolean,              -- Enable/disable command
        permissions = {"permission"},   -- qb-core permission groups (e.g., "god", "admin")
        jobs = {"job_name"},            -- Allowed jobs (empty = all jobs)
        gangs = {"gang_name"},          -- Allowed gangs (must match QB-Core gang names)
        identifiers = {},               -- Allowed identifiers (steam:/license:/fivem:/discord:/citizenid)
        denyMessage = "message"         -- Message shown when access is denied
    }
}

Example

Config.Commands = {
    labsetup = {
        enabled = true,
        permissions = {"god", "admin"},
        jobs = {"mafia"},
        gangs = {"mafia"},
        identifiers = {},
        denyMessage = "You are not allowed to use labsetup."
    },
    editlab = {
        enabled = true,
        permissions = {"god", "admin"},
        jobs = {},
        gangs = {},
        identifiers = {"steam:110000xxxxxxxxx"},
        denyMessage = "You are not allowed to edit lab."
    }
}

Access Logic

Access is granted if ANY of the following conditions are met:

• Player has required permission

• Player has required job (if jobs is not empty)

• Player is in required gang (if gangs is not empty)

• Player identifier matches (if identifiers is not empty)

---

Config.MiniGames

Purpose: Minigame types for hacking lab doors and laptops.

Structure

Config.MiniGames = {
    LabHack = 'minigame_type',      -- Lab door hack minigame
    LaptopHack = 'minigame_type'    -- Laptop hack minigame
}

Available Types

• digit - Digit sequence minigame (from bl_ui resource)

• minesweeper - Minesweeper minigame (from bl_ui resource)

• nil - Custom (requires custom implementation in bridge/minigames.lua)

Example

Config.MiniGames = {
    LabHack = 'digit',
    LaptopHack = 'minesweeper'
}

Custom Minigames

To use custom minigames, set the value to nil and modify bridge/minigames.lua:

function PlayHackGame(type, options)
    if type == "custom_type" then
        -- Your custom minigame code
        return exports['your_minigame']:Start(options)
    end
    return false
end

---

Config.Products

Purpose: Products available in the lab shop (purchased via laptop).

Structure

Config.Products = {
    defaultMoneyType = 'cash',  -- Payment type: 'cash' or 'bank'
    {
        id = number or string,      -- Unique product ID
        name = 'name',              -- Display name
        price = number,             -- Price in dollars
        image = 'url',              -- Image URL (displayed in shop)
        item = 'item_name',         -- Inventory item name (must exist in database)
        requiredLevel = number      -- Required lab level (optional, 0 = no requirement)
    }
}

Example

Config.Products = {
    defaultMoneyType = 'cash',
    {
        id = '1',
        name = 'Shovel',
        price = 2500,
        image = 'https://example.com/shovel.png',
        item = 'plant_shovel'
    },
    {
        id = '7',
        name = 'Blue Weed Seed',
        price = 2500,
        image = 'https://example.com/seed.png',
        item = 'seed_bluedream',
        requiredLevel = 1
    }
}

Important Notes

• item: Must exactly match the item name in your qb-core/shared/items.lua (case-sensitive).

• requiredLevel: Products are hidden if player's lab level is below this.

• defaultMoneyType: Determines if payment is taken from cash or bank.

---

Config.Upgrades

Purpose: Lab upgrade configurations (purchased via laptop).

Structure

Config.Upgrades = {
    defaultMoneyType = 'cash',
    ["upgrade_name"] = {
        label = "name",                    -- Display name
        description = "text",              -- Description shown in menu
        icon = "url",                      -- Icon URL
        baseCost = number,                 -- Base price for first level
        costMultiplier = number,           -- Price multiplier per level (1.25 = +25% per level)
        maxLevel = number,                 -- Maximum level (1 = one-time purchase)
        requiredLevel = number,            -- Required lab level (single requirement)
        requiredLevelByLevel = {           -- OR required level per upgrade level
            [level] = number
        },
        objectsByLevel = {},              -- Objects spawned per level (from Config.Locations)
        waterPrice = number,              -- Water price (water system only)
        waterAmount = number              -- Water amount added (water system only)
    }
}

Example

Config.Upgrades = {
    defaultMoneyType = 'cash',
    
    ["cctv"] = {
        label = "Enable CCTV",
        description = "Enable CCTV to monitor the lab.",
        icon = "https://example.com/cctv.webp",
        baseCost = 7500,
        costMultiplier = 1.25,
        maxLevel = 1,
        requiredLevel = 9,
        objectsByLevel = {}
    },
    
    ["tables"] = {
        label = "Tables Upgrade",
        description = "Upgrade tables in your lab. Each level adds more tables.",
        icon = "https://example.com/table.png",
        baseCost = 5000,
        costMultiplier = 1.3,
        maxLevel = 3,
        requiredLevelByLevel = {
            [1] = 1,
            [2] = 2,
            [3] = 3
        },
        objectsByLevel = (Config.Locations and Config.Locations.UpgradeTables) or {}
    },
    
    ["water"] = {
        label = "Water System",
        description = "Manage water supply for your lab plants.",
        icon = "https://example.com/water.png",
        baseCost = 0,
        costMultiplier = 1.0,
        maxLevel = 1,
        requiredLevel = 0,
        objectsByLevel = {},
        waterPrice = 5000,
        waterAmount = 25
    }
}

Cost Calculation

Upgrade cost formula: baseCost * (costMultiplier ^ (level - 1))

Example with baseCost = 5000 and costMultiplier = 1.3:

• Level 1: 5000 * (1.3^0) = 5000

• Level 2: 5000 * (1.3^1) = 6500

• Level 3: 5000 * (1.3^2) = 8450

objectsByLevel

Objects are loaded from Config.Locations.UpgradeTables or Config.Locations.UpgradePlantLamps. See Config.Locations section.

---

Config.XP

Purpose: Experience point rewards for successful hacks.

Structure

Config.XP = {
    LabHack = {min, max},      -- XP range for lab door hack
    LaptopHack = {min, max}    -- XP range for laptop hack
}

Example

Config.XP = {
    LabHack = {50, 1000},
    LaptopHack = {50, 1000}
}

Details

• XP is awarded randomly within the specified range on successful hack.

• Failed hacks result in XP loss (see Config.LaptopPenalty).

• XP determines player rank (see Config.Ranks).

---

Config.Ranks

Purpose: Ranking system based on total XP earned.

Structure

Config.Ranks = {
    {
        minXP = number,         -- Minimum XP required for this rank
        maxXP = number,         -- Maximum XP for this rank
        rank = "name",          -- Rank identifier (lowercase, no spaces)
        image = "path/to/image" -- Rank badge image path (relative to html/images/rank/)
    }
}

Example

Config.Ranks = {
    {
        minXP = 0,
        maxXP = 999,
        rank = "iron",
        image = "images/rank/Iron.png"
    },
    {
        minXP = 1000,
        maxXP = 4999,
        rank = "bronze",
        image = "images/rank/bronze.png"
    },
    {
        minXP = 5000,
        maxXP = 9999,
        rank = "silver",
        image = "images/rank/silver.png"
    }
}

Important Notes

• Ranks must be in ascending order (lowest XP first).

• The last rank should have a very high maxXP (e.g., 999999999) to act as the maximum rank.

• Image paths are relative to the resource root html/ folder.

---

Config.RandomLocations

Purpose: Random dealer locations for selling products (used when no specific zone is configured).

Structure

Config.RandomLocations = {
    {
        coords = vector4(x, y, z, heading)  -- Dealer location with heading
    }
}

Example

Config.RandomLocations = {
    {coords = vector4(299.88, 2892.97, 43.61, 12.95)},
    {coords = vector4(100.0, 200.0, 30.0, 90.0)},
    {coords = vector4(-500.5, -1000.2, 25.0, 180.0)}
}

---

Config.BlipSettings

Purpose: Map blip appearance and behavior for dealer locations.

Structure

Config.BlipSettings = {
    deleteTime = number,    -- Deletion time in milliseconds (300000 = 5 minutes)
    blipSprite = number,    -- Sprite ID (GTA V sprite IDs)
    blipColor = number,     -- Color ID (0-85, see GTA V color IDs)
    blipScale = number     -- Scale/size (1.0 = normal)
}

Example

Config.BlipSettings = {
    deleteTime = 300000,
    blipSprite = 140,
    blipColor = 2,
    blipScale = 1.2
}

Common Blip Sprites

• 140 - Drug dealer

• 161 - Alert/Police

• 225 - Shop

• 303 - Money

---

Config.LabSettings

Purpose: General lab behavior settings.

Structure

Config.LabSettings = {
    minMembers = number  -- Minimum gang members required (0 = no requirement)
}

Example

Config.LabSettings = {
    minMembers = 0
}

---

Config.Items

Purpose: Maps display names to inventory item names. Used for item checking and validation.

Structure

Config.Items = {
    DisplayName = 'item_name'
}

Example

Config.Items = {
    Shovel = 'plant_shovel',
    Shears = 'plant_shears',
    Fertilizer = 'plant_fertilizer',
    Pot = 'plant_pot',
    WateringCan = 'watering_can',
    Baggie = 'plant_emptybag'
}

Important Notes

• Display names are used in menus and notifications.

• Item names must match your database exactly (case-sensitive).

---

Config.FeedSettings

Purpose: Water and fertilizer consumption rates for plants.

Structure

Config.FeedSettings = {
    Water = {
        StartAmount = number,   -- Initial water percentage (0-100)
        LoseAmount = number,    -- Lost per cycle (%)
        LoseTime = number,      -- Time between loss (seconds)
        FeedAmount = number     -- Added when feeding (%)
    },
    Fertilizer = {
        StartAmount = number,   -- Initial fertilizer percentage (0-100)
        LoseAmount = number,    -- Lost per cycle (%)
        LoseTime = number,      -- Time between loss (seconds)
        FeedAmount = number     -- Added when feeding (%)
    }
}

Example

Config.FeedSettings = {
    Water = {
        StartAmount = 100,
        LoseAmount = 35,
        LoseTime = 300,
        FeedAmount = 35
    },
    Fertilizer = {
        StartAmount = 90,
        LoseAmount = 30,
        LoseTime = 300,
        FeedAmount = 30
    }
}

Details

• Values are percentages (0-100).

• LoseTime determines how often the plant loses resources.

• Plant dies if water/fertilizer reaches 0 for too long (see Config.PlantSettings.StarveTime).

---

Config.Growth

Purpose: Plant growth speed and rate.

Structure

Config.Growth = {
    GainAmount = number,  -- Growth percentage per cycle (%)
    GainTime = number     -- Time between cycles (seconds)
}

Example

Config.Growth = {
    GainAmount = 1,
    GainTime = 36
}

Calculation

With GainAmount = 1 and GainTime = 36:

• Plant gains 1% growth every 36 seconds

• To reach 100% growth: 100 * 36 = 3600 seconds (60 minutes)

---

Config.PlantSettings

Purpose: General plant behavior settings.

Structure

Config.PlantSettings = {
    Lifetime = number,        -- Plant lifetime in minutes (after reaching 100% growth)
    MinDistance = number,     -- Minimum distance between plants (meters)
    StarveTime = number,      -- Time before plant dies from starvation (seconds)
    DeathProp = 'model_name'  -- Model to show when plant dies (must exist in stream/)
}

Example

Config.PlantSettings = {
    Lifetime = 180,
    MinDistance = 0.5,
    StarveTime = 900,
    DeathProp = 'bzzz_growing_freepot_d'
}

---

Config.Plant

Purpose: Individual plant type configurations.

Structure

Config.Plant = {
    ['plant_key'] = {
        label = 'name',                        -- Display name
        seed = 'item_name',                    -- Seed item name
        baggie = 'item_name',                  -- Bag item name
        bud = 'item_name',                     -- Bud item name
        budMin = number,                       -- Min buds harvested
        budMax = number,                       -- Max buds harvested
        BudsForBag = number,                   -- Buds needed per bag
        PlacingProgressBarDuration = number,   -- Planting time (seconds)
        RequirePot = boolean,                  -- Requires pot to plant
        RemovePot = number,                    -- Pots removed (0 = not consumed)
        RequireShovel = boolean,               -- Requires shovel to plant
        RemoveShovel = number,                 -- Shovels removed (0 = not consumed)
        Props = {                              -- Growth stage models
            [1] = 'model_name',                -- Stage 1: Small (0-33%)
            [2] = 'model_name',                -- Stage 2: Medium (34-66%)
            [3] = 'model_name'                 -- Stage 3: Large (67-100%)
        }
    }
}

Example

Config.Plant = {
    ['bluedream'] = {
        label = 'Blue Dream Plant',
        seed = 'seed_bluedream',
        baggie = 'bluedream_bag',
        bud = 'bud_bluedream',
        budMin = 5,
        budMax = 7,
        BudsForBag = 5,
        PlacingProgressBarDuration = 5,
        RequirePot = true,
        RemovePot = 1,
        RequireShovel = true,
        RemoveShovel = 0,
        Props = {
            [1] = 'an_weed_blue_01_small_01a',
            [2] = 'an_weed_blue_med_01b',
            [3] = 'an_weed_blue_lrg_01a'
        }
    }
}

Prop Models

Prop models must exist in your stream/ folder. Available models:

• Blue: an_weed_blue_01_small_01a, an_weed_blue_med_01b, an_weed_blue_lrg_01a

• Purple: an_weed_purple_01_small_01a, an_weed_purple_med_01b, an_weed_purple_lrg_01a

• White: an_weed_white_01_small_01a, an_weed_white_med_01b, an_weed_white_lrg_01a

• Yellow: an_weed_yellow_01_small_01a, an_weed_yellow_med_01b, an_weed_yellow_lrg_01a

---

Config.TableInteractions

Purpose: Table interaction types and requirements for crafting.

Structure

Config.TableInteractions = {
    [table_id] = {
        label = "name",           -- Display name
        type = "type",            -- "bagging", "joint", or "doll"
        requiredBuds = number,    -- Buds needed (bagging/doll only)
        description = "text",     -- Description shown in menu
        dollCraft = boolean       -- Enable doll crafting (doll type only)
    }
}

Example

Config.TableInteractions = {
    [1] = {
        label = "Bagging Table",
        type = "bagging",
        requiredBuds = 10,
        description = "Convert 10 buds into 1 bag"
    },
    [2] = {
        label = "Rolling Table",
        type = "joint",
        description = "Roll buds into joints",
        dollCraft = false
    },
    [3] = {
        label = "Final Table",
        type = "doll",
        description = "Craft hidden dolls with buds",
        dollCraft = true,
        requiredBuds = 35
    }
}

Table Types

• bagging: Converts buds into bags (uses Config.Plant[].BudsForBag or requiredBuds)

• joint: Converts buds into joints (uses Config.Strains)

• doll: Converts buds into dolls (uses Config.DollCraft)

---

Config.DollCraft

Purpose: Doll crafting configuration (hidden drug packages).

Structure

Config.DollCraft = {
    enabled = boolean,              -- Enable/disable doll crafting
    requiredBuds = number,          -- Buds needed per doll
    outputItem = 'item_name',       -- Output item name (fallback)
    outputItems = {                 -- Output items per bud type
        ['bud_type'] = 'item_name'
    },
    label = "name",                 -- Display name
    description = "text"            -- Description
}

Example

Config.DollCraft = {
    enabled = true,
    requiredBuds = 35,
    outputItem = 'weed_doll',
    outputItems = {
        ['bud_bluedream'] = 'cokepacked_bluedream',
        ['bud_purplehaze'] = 'cokepacked_purplehaze',
        ['bud_glue'] = 'cokepacked_glue',
        ['bud_bananakush'] = 'cokepacked_bananakush'
    },
    label = "Doll",
    description = "Convert 35 buds into 1 doll"
}

---

Config.RollingPaper

Purpose: Rolling paper requirements for joint crafting.

Structure

Config.RollingPaper = {
    required = boolean,       -- Require rolling paper item
    item = 'item_name',       -- Paper item name
    amount = number,          -- Amount consumed per use
    defaultUses = number,     -- Uses per paper (if paper has no metadata)
    removeWhenEmpty = boolean -- Remove item when uses reach 0
}

Example

Config.RollingPaper = {
    required = true,
    item = 'rolling_paper',
    amount = 1,
    defaultUses = 3,
    removeWhenEmpty = true
}

Usage System

If defaultUses > 1, the system tracks uses via item metadata. When uses reach 0, the item is removed (if removeWhenEmpty = true).

---

Config.Strains

Purpose: Weed strain configurations for joint rolling.

Structure

Config.Strains = {
    ['Strain Name'] = {
        joint = 'item_name',      -- Joint item created
        effect = 'effect_type',   -- Effect when smoked
        receive = number,         -- Joints per craft
        required = {
            item = 'item_name',   -- Required bud item
            amount = number       -- Buds needed per joint
        }
    }
}

Effect Types

• health_small - Small health boost

• health_medium - Medium health boost

• health_large - Large health boost

• armor_small - Small armor boost

• armor_medium - Medium armor boost

• armor_large - Large armor boost

• speed - Speed boost

• stamina - Stamina boost

Example

Config.Strains = {
    ['Blue Dream'] = {
        joint = 'blue_dream_joint',
        effect = 'health_small',
        receive = 1,
        required = {
            item = 'bud_bluedream',
            amount = 3
        }
    },
    ['Purple Haze'] = {
        joint = 'purple_haze_joint',
        effect = 'health_medium',
        receive = 1,
        required = {
            item = 'bud_purplehaze',
            amount = 3
        }
    }
}

---

Config.SellingBehavior

Purpose: Selling behavior and risk mechanics.

Structure

Config.SellingBehavior = {
    stealChanceBase = number,           -- Base chance of being scammed (%)
    stealReductionPerLevel = number,    -- Chance reduction per lab level (%)
    stealMinChance = number,            -- Minimum scam chance (%)
    policeChance = number,              -- Chance of police dispatch (%)
    priceBonusPerLevel = number         -- Price bonus per lab level ($)
}

Example

Config.SellingBehavior = {
    stealChanceBase = 35,
    stealReductionPerLevel = 2,
    stealMinChance = 5,
    policeChance = 12,
    priceBonusPerLevel = 25
}

Scam Chance Calculation

Final scam chance = stealChanceBase - (lab_level * stealReductionPerLevel), minimum stealMinChance

Example with level 5 lab: 35 - (5 * 2) = 25% (minimum 5%)

---

Config.SellingZones

Purpose: Selling zone locations and settings.

Structure

Config.SellingZones = {
    ["zone_name"] = {
        coords = vector3(x, y, z),       -- Zone center coordinates
        radius = number,                 -- Zone radius (meters)
        interactDistance = number,       -- Interaction distance (meters)
        enabled = boolean,               -- Enable/disable zone
        blipName = "name"                -- Blip display name
    }
}

Example

Config.SellingZones = {
    ["del_perro"] = {
        coords = vector3(-1276.44, -1391.98, 4.34),
        radius = 10000000.0,
        interactDistance = 4.0,
        enabled = true,
        blipName = "Street Dealer"
    },
    ["grove_st"] = {
        coords = vector3(90.4, -1955.61, 20.75),
        radius = 10000000.0,
        interactDistance = 4.0,
        enabled = true,
        blipName = "Alley Sales"
    }
}

Notes

• Large radius values (like 10000000.0) effectively make the zone work anywhere in the area.

• Blips are created on the map when zones are enabled.

---

Config.Selling

Purpose: Items that can be sold and their pricing.

Structure

Config.Selling = {
    item_key = {
        label = 'name',              -- Display name
        item = 'item_name',          -- Inventory item name
        priceMin = number,           -- Minimum price
        priceMax = number,           -- Maximum price
        paymentMethods = {'cash', 'bank'}  -- Payment methods
    }
}

Example

Config.Selling = {
    bluedream = {
        label = 'Blue Dream Bag',
        item = 'bluedream_bag',
        priceMin = 280,
        priceMax = 360,
        paymentMethods = {'cash', 'bank'}
    },
    doll = {
        label = 'Doll Package',
        item = 'weed_doll',
        priceMin = 1100,
        priceMax = 1400,
        paymentMethods = {'cash', 'bank'}
    },
    bud_bluedream = {
        label = 'Raw Blue Dream Bud',
        item = 'bud_bluedream',
        priceMin = 45,
        priceMax = 65,
        paymentMethods = {'cash'}
    }
}

Price Calculation

Final price = random(priceMin, priceMax) + (lab_level * Config.SellingBehavior.priceBonusPerLevel)

---

Config.Interactions

Purpose: Interaction sprite/texture configuration for world interactions.

Structure

Config.Interactions = {
    interaction_type = {
        texture = "texture_name",        -- Normal texture name (in html/images/interactions/)
        textureRed = "texture_name",     -- Red/alert texture name
        sprite = {
            x = number,                  -- X position offset
            y = number,                  -- Y position offset
            width = number,              -- Width (0.03 = small, 0.08 = large)
            height = number,             -- Height (0.05 = small, 0.06 = large)
            rotation = number,           -- Rotation in degrees
            r = number,                  -- Red color (0-255)
            g = number,                  -- Green color (0-255)
            b = number,                  -- Blue color (0-255)
            a = number                   -- Alpha/transparency (0-255)
        }
    }
}

---

Best Practices

1. Always backup config before changes - Create a backup of your config.lua file before making modifications.

2. Test on development server first - Never test configuration changes on a production server.

3. Keep item names consistent - Ensure item names match your database exactly (case-sensitive).

4. Verify coordinates in-game - Test coordinates using /tp command before setting them in config.

5. Balance prices with server economy - Adjust prices to match your server's economic balance.

6. Document custom changes - Add comments to document any custom modifications you make.

7. Use proper data types - Ensure numbers are numbers, strings are strings, and booleans are booleans (no quotes on booleans).

8. Validate webhook URLs - Test Discord webhook URLs before enabling webhooks.

9. Check Bridge compatibility - Ensure your Bridge settings match your installed resources.

10. Test all systems - After changing Bridge settings, test menus, inventories, interactions, etc.

---

Troubleshooting

Items not working

Problem: Items don't appear or function correctly.

Solution:

• Verify item names match database exactly (case-sensitive)

• Check that items exist in your items.lua file

• Ensure item names in config match exactly with database entries

• Check server console for item-related errors

Coordinates not working

Problem: Locations don't spawn or are incorrect.

Solution:

• Test coordinates using /tp x y z command in-game

• Verify vector3/vector4 format is correct

• Check for typos in coordinate values

• Ensure coordinates are within the game world bounds

Webhooks not sending

Problem: Discord webhooks don't send messages.

Solution:

• Ensure webhooks = true in Config.Base

• Verify webhookURL is set correctly

• Test webhook URL in browser or Discord webhook tester

• Check server console for webhook errors

Upgrades not showing

Problem: Lab upgrades don't appear in menu.

Solution:

• Check requiredLevel matches player's lab level

• Verify upgrade is enabled in Config.Upgrades

• Ensure player has sufficient funds

• Check that upgrade hasn't reached maxLevel

• Verify objectsByLevel references Config.Locations correctly

Plants not growing

Problem: Plants don't grow or grow incorrectly.

Solution:

• Verify Config.Growth settings are correct

• Check Config.FeedSettings values

• Ensure plant props exist in stream folder

• Verify plant type is defined in Config.Plant

• Check server console for plant-related errors

Dispatch not working

Problem: Police dispatch doesn't trigger.

Solution:

• Verify dispatch system matches your server (qb/ps/cd/custom)

• Check that dispatch resource is running

• Ensure Config.Dispatch settings are correct

• Test dispatch system independently

• Check Bridge.Dispatch implementation for your system

Bridge system not working

Problem: Menus, inventory, or interactions don't work.

Solution:

• Verify resource names in Config.Base match your installed resources exactly

• Check that required resources are started before iSanz_Labs

• Ensure resource names match fxmanifest.lua dependency names

• Check server console for Bridge-related errors

• Test Bridge functions directly in server console

Interaction textures not showing

Problem: Interaction icons don't appear.

Solution:

• Verify texture files exist in html/images/interactions/

• Check texture names match Config.Interactions exactly

• Ensure texture files are PNG format

• Verify NUI files are loaded correctly

• Check browser console (F8) for texture loading errors

---

Support

• Documentation: This file

• Version: v3.0.0-BETA

• Last Updated: 2025

---

Note: This documentation is based on the latest version of iSanz Labs. Always refer to the latest config file for the most up-to-date configuration options. For Bridge system modifications, refer to the individual Bridge files in the bridge/ folder.