Configuration Guide

Laser System Usage

Config File Location

The main configuration file is located at: shared/config.lua

Configuration Options

Framework Selection

-- Core framework selection: "QBCore" for qb-core, "ESX" for es_extended, or "Qbox" for qbox_core
J0.Core = "QBCore"

Options:

• "QBCore" - For QBCore framework

• "ESX" - For ESX framework

• "Qbox" - For Qbox framework

Inventory System Selection

-- Inventory system selection: "qb" for QB inventory or "ox" for ox inventory
J0.Inventory = 'ox'

Options:

• 'ox' - For OX-Inventory

• 'qb' - For QB-Inventory

Laser Configuration

J0.LaserCfg = {
    cooldown_on_place = true,  -- Enable cooldown when placing lasers
    cooldown_time = 5,          -- Cooldown time in seconds
    shop_coords = vector4(221.57, -1514.10, 28.29, 227.77),  -- Shop location (X, Y, Z, Heading)
    shop_ped = 's_m_m_fiboffice_02',  -- Ped model for shop NPC
    items = { 
        [1] = { itemname = "laser_device", price = 10 },
        [2] = { itemname = "laser_remover", price = 10 },
        [3] = { itemname = "laser_devicepol", price = 10 },
    }
}

Configuration Parameters Explained

cooldown_on_place

• Type: boolean

• Default: true

• Description: Enables a cooldown period after placing a laser to prevent spam placement

cooldown_time

• Type: number (seconds)

• Default: 5

• Description: The duration of the cooldown period in seconds

shop_coords

• Type: vector4

• Default: vector4(221.57, -1514.10, 28.29, 227.77)

• Description: The coordinates and heading for the shop NPC location

• Format: vector4(X, Y, Z, Heading)

• How to find coordinates: Use /tp command or a coordinate finder script in-game

shop_ped

• Type: string

• Default: 's_m_m_fiboffice_02'

• Description: The ped model hash for the shop NPC

• Common ped models:

  • 's_m_m_fiboffice_02' - FIB Office Worker

  • 's_m_y_ammucity_01' - Ammunation Worker

  • 's_m_m_shop_mask' - Shop Mask Vendor

  • 's_m_y_shop_mask' - Shop Mask Vendor (Young)

  • Or any other valid GTA V ped model

items

• Type: table

• Description: Array of items available for purchase at the shop

• Structure:

  [index] = {
      itemname = "item_name",  -- Must match the item name in your inventory
      price = 100              -- Price in cash (not bank)
  }

Example Custom Configuration

J0 = {}

J0.Core = "ESX"
J0.Inventory = 'qb'

J0.LaserCfg = {
    cooldown_on_place = false,  -- Disable cooldown
    cooldown_time = 10,
    shop_coords = vector4(-47.70, -1757.23, 29.42, 45.0),  -- Custom location
    shop_ped = 's_m_y_ammucity_01',  -- Ammunation worker
    items = { 
        [1] = { itemname = "laser_device", price = 500 },      -- More expensive
        [2] = { itemname = "laser_remover", price = 100 },
        [3] = { itemname = "laser_devicepol", price = 1000 },  -- Police lasers cost more
    }
}

Database Configuration

The laser system uses a JSON file for persistent storage: shared/database.json

Database Structure

{
    "license:xxxxxxxxxxxxx": {
        "lasers": [
            {
                "laserId": 1234,
                "start": { "x": 0.0, "y": 0.0, "z": 0.0 },
                "finish": { "x": 0.0, "y": 0.0, "z": 0.0 },
                "color": [255, 0, 0, 255],
                "isOwnedByPolice": false,
                "control": true,
                "still": false,
                "isMoving": false,
                "movement": {
                    "upDown": { "min": 0, "max": 0 },
                    "leftRight": { "min": 0, "max": 0 }
                }
            }
        ]
    }
}

Warning: Do not manually edit database.json while the server is running. The file is automatically managed by the script.

Laser Properties

Each laser has the following properties (stored in database):

• laserId: Unique identifier for the laser

• start: Starting coordinates (vector3)

• finish: Ending coordinates (vector3)

• color: RGBA color array [R, G, B, A] (0-255)

• isOwnedByPolice: Boolean indicating if it's a police laser

• control: Boolean indicating if detection is enabled

• still: Boolean for movement behavior

• isMoving: Boolean indicating if laser moves

• movement: Movement configuration (currently not fully implemented in UI)

Performance Considerations

• Lasers are only rendered when players are within 50 units of the laser start point

• The detection system uses optimized distance calculations

• Database is only written to when lasers are created or removed

---

Configuration complete! Customize the settings to match your server's needs.