# Configuration

### General Settings

Basic configuration options for the warehouse system.

```
Config = {} 
-- General 
Config.Debug = true 
Config.Locale = 'en' 
Config.AllowMultipleWarehouses = false -- one per citizen by default 
Config.TargetSystem = 'ox_target' -- 'ox_target' or 'qb-target' 
Config.InventorySystem = 'ox_inventory' -- 'ox_inventory' or 'qb-inventory'
-- Money source for purchase
Config.PurchaseAccount = 'bank' -- Account type for buying warehouse "bank or cash"
Config.SellAccount = 'bank' -- Account type for receiving sell money
```

### 💰 Pricing Configuration

Configure warehouse and storage slot pricing to match your server's economy.

```
Config.Warehouse = {
    price = 150000, -- Base warehouse price
    sellPrice = 75000, -- Warehouse sell price (50% of purchase price)
    slotPrice = 5000, -- Default price per additional storage slot
    maxSlots = 6, -- Maximum storage slots a player can purchase (matches 6 crates)
    
    -- Individual slot pricing - each slot can have its own price
    slotPrices = {
        [1] = 5000,   -- Slot 1 price
        [2] = 7500,   -- Slot 2 price (more expensive)
        [3] = 10000,  -- Slot 3 price (premium)
        [4] = 12500,  -- Slot 4 price (luxury)
        [5] = 15000,  -- Slot 5 price (exclusive)
        [6] = 20000,  -- Slot 6 price (ultimate)
    },
```

**💡 Tip:** You can set individual prices for each storage slot to create a progression system where later slots cost more, encouraging balanced gameplay.

### 🏢 Location Configuration

Set custom locations for the sales ped, warehouse entrance, and interior coordinates.

```
-- Sales Ped
Config.SalesPed = {
    model = 's_m_m_dockwork_01',
    coords = vector4(-57.34, -2659.82, 6.0, 351.66),
    scenario = 'WORLD_HUMAN_CLIPBOARD',
    targetLabel = 'Warehouse Services'
}

-- Public entrance marker
Config.Entrance = {
    coords = vector3(-59.87, -2660.43, 6.0),
    heading = 89.0,
    markerDrawDistance = 15.0,
    markerRange = 1.5
}

-- Entrance door prop for visual clarity
Config.EntranceDoor = {
    enabled = true,
    model = 'v_ilev_ph_door01', -- Office door that should work
    offset = vector3(0.0, 0.0, 0.5), -- Keep the raised offset that worked
    headingOffset = 0.0 -- Relative to entrance heading
}
```

### 🏠 Interior Configuration

Configure the warehouse interior settings and storage crate positions.

```
interiorAnchor = vector4(1094.988, -3101.776, -39.00363, 0.0),
    ipls = {
        'ex_exec_warehouse_placement_interior_1_int_warehouse_s_dlc_milo',
    },
    exitOffset = vector3(-7.33, 2.48, 0.00),
    
    -- Storage configuration - using closed crates positioned along warehouse wall
    crates = {
        -- Wall-mounted crates with exact positioning (dropped down to floor level)
        { model = 'ex_prop_crate_closed_bc', offset = vec3(-6.34, 5.39, -1.0), heading = 174.60 },
        { model = 'ex_prop_crate_closed_bc', offset = vec3(-3.85, 5.26, -1.0), heading = 183.00 },
        { model = 'ex_prop_crate_closed_bc', offset = vec3(0.07, 5.32, -1.0), heading = 180.59 },
        { model = 'ex_prop_crate_closed_bc', offset = vec3(2.57, 5.12, -1.0), heading = 176.24 },
        { model = 'ex_prop_crate_closed_bc', offset = vec3(6.29, 5.22, -1.0), heading = 168.63 },
        { model = 'ex_prop_crate_closed_bc', offset = vec3(8.82, 5.04, -1.0), heading = 177.88 },
    },
    
    -- Storage slot positions (relative to crates) - 4 slots per crate
    crateSlots = {
        -- Front slots (closest to player)
        vec3(0.0, 0.0, 0.5), vec3(0.0, 0.0, 1.0),
        vec3(0.5, 0.0, 0.5), vec3(0.5, 0.0, 1.0),
        -- Middle slots
        vec3(0.0, 0.0, 1.5), vec3(0.0, 0.0, 2.0),
        vec3(0.5, 0.0, 1.5), vec3(0.5, 0.0, 2.0),
        -- Back slots
        vec3(0.0, 0.0, 2.5), vec3(0.0, 0.0, 3.0),
        vec3(0.5, 0.0, 2.5), vec3(0.5, 0.0, 3.0),
        -- Side slots
        vec3(0.0, 0.0, 3.5), vec3(0.0, 0.0, 4.0),
        vec3(0.5, 0.0, 3.5), vec3(0.5, 0.0, 4.0),
    }
}
```

### 🤝 Sharing Configuration

Configure the warehouse sharing system settings. Permission Levels should be ignored.

```
-- Warehouse Sharing System Configuration
Config.Sharing = {
    enabled = true,
    permissionLevels = {
        'read',    -- Read-only access
        'write',   -- Read and write access
        'admin'    -- Full access except ownership
    },
    
    defaultPermission = 'read',
    maxSharedUsers = 10,
    allowTemporaryAccess = true,
    maxTemporaryDuration = 24 * 60 * 60, -- 24 hours in seconds
    
    -- UI Settings
    showPermissionLevels = true,
    showExpirationDates = true,
    showOwnerNames = true,
    showAccessTimestamps = false,
    maxWarehousesPerPage = 5
}

```

### 📦 Storage Configuration

Configure storage limits and inventory system settings.

```
-- Stash settings for storage slots
Config.Storage = {
    maxWeight = 100000,
    maxSlots = 30,
    -- ox_inventory specific settings
    ox_inventory = {
        maxWeight = 100000,
        maxSlots = 30
    },
    -- qb-inventory specific settings
    qb_inventory = {
        maxWeight = 100000,
        maxSlots = 30
    }
}
```

### 🎯 Interaction Configuration

Configure interaction distances and visual elements.

```
-- Distances
Config.DrawDistance = 30.0
Config.InteractDistance = 2.0

-- Blips
Config.Blips = {
    SalesPed = { sprite = 478, color = 5, scale = 0.8, text = 'Warehouse Sales', shortRange = false },
    Entrance = { sprite = 50, color = 3, scale = 0.65, text = 'Your Warehouse', shortRange = true }
}
```

### 🔧 System Integration

Configure integration with different target and inventory systems.

#### Target System Options

\-- Choose between ox\_target or qb-target Config.TargetSystem = 'ox\_target' -- or 'qb-target'

#### Inventory System Options

\-- Choose between ox\_inventory or qb-inventory Config.InventorySystem = 'ox\_inventory' -- or 'qb-inventory'

**⚠️ Important:** Make sure the target and inventory systems you choose are properly installed and configured on your server. The script will automatically detect and use the appropriate system.

Customize the user interface appearance and behavior.

\-- UI Customization Config.UI = { showPermissionLevels = true, showExpirationDates = true, showOwnerNames = true, showAccessTimestamps = false, maxWarehousesPerPage = 5 }

### 📝 Configuration Tips

Best practices for configuring the warehouse system:

* **Economy Balance:** Set prices that fit your server's economy and player progression
* **Location Choice:** Choose locations that are easily accessible but not in high-traffic areas
* **Storage Limits:** Adjust storage limits based on your server's item economy
* **Sharing Limits:** Set reasonable limits for shared users to prevent abuse
* **Debug Mode:** Enable debug mode during testing, disable in production

**💡 Pro Tip:** Test your configuration changes with a small group of players before applying them to your entire server. This helps identify any issues before they affect all players.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sergeis-scripts.gitbook.io/sergeis-scripts-docs/sergeis-warehouse/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.