Configuration — foltone_cctv

All configuration is in the config.lua file.

Framework & Locale

Config.Framework = "esx"       -- "esx", "qbcore" or "qbx"
Config.Locale = "en"           -- "en" or "fr"
Config.InteractionType = "ox_target" -- "ox_target", "drawtext" or "marker"
Config.Debug = false

Items

Config.TabletItem = "cctv_tablet"
Config.StationItem = "cctv_station"
Config.StationProp = "prop_cctv_unit_01"

Shop Accessories

Config.ShopAccessories = {
    {
        id = "tablet",
        item = "cctv_tablet",
        label = "CCTV Tablet",
        image = "tablet.png",
        description = "Portable tablet to check your cameras remotely.",
        specs = { "PORTABLE", "WIRELESS" },
        price = 2000,
    },
    {
        id = "station",
        item = "cctv_station",
        label = "CCTV Monitor",
        image = "station.png",
        description = "Fixed control station to monitor all your cameras.",
        specs = { "HD SCREEN", "MULTI-CAM" },
        price = 5000,
    },
}

Accessories are displayed alongside cameras in the shop. The station item can be placed in the world using the item.

Camera types

Config.MaxCamerasPerPlayer = 10
Config.PlacementDistance = 8.0

Camera type structure

Each entry in Config.CameraTypes defines a camera model:

{
    id = "standard",
    item = "cctv_cam_standard",
    label = "Standard",
    image = "standard.png",
    description = "Classic wall camera. Reliable and discreet.",
    specs = { "FOV 70", "ZOOM x4", "60 FPS" },
    prop = "prop_cctv_cam_03a",
    price = 3000,
    wallOffset = 0.0,
    offset = {
        pos = vector3(0.45, 0.37, 0.35),
        pitch = 1.3,
        yaw = -56.3,
        propPitch = 0.0,
        propRoll = 0.0,
        propYaw = 170.0,
    },
    fov = { default = 70.0, min = 25.0, max = 100.0 },
    zoomStep = 5.0,
    rotationSpeed = 2.0,
    maxVertAngle = 60.0,
},

Default camera types

Calibrating offsets

Use the in-game debug command to calibrate camera offsets:

/cctv_debug

1. Approach a placed camera (< 15m)
2. Run the command — enters debug camera view
3. Adjust with controls:
   • Mouse — pitch / yaw offset
   • Scroll — prop yaw rotation
   • Arrow keys — position offset (forward/back/left/right)
   • E / Q — position offset (up/down)
   • Backspace — exit and print values
4. Copy the printed values into Config.CameraTypes[x].offset

Permissions

Config.AllowedJobs = {
    "police",
    "ambulance",
}

Motion detection

Config.MotionDetection = {
    Radius = 15.0,
    Cooldown = 60,
    Default = true,
}

Destruction

Config.DestructionHits = 3

Config.DestructionWeapons = {
    "WEAPON_CROWBAR",
    "WEAPON_PISTOL",
    -- ...
}

Camera visual effects

Config.CameraEffect = {
    timecycle = "CAMERA_secuirity",
    strength = 0.6,
    vignette = 1.0,
    grain = 1.0,
    scanline = 1.0,
}

Available timecycles: CAMERA_secuirity (default), CAMERA_BW (black & white), NG_filmic08 (cinematic), phone_cam3 (webcam look).

Captures

Config.MaxCaptures = 20

Maximum number of screenshots saved per player. When exceeded, the oldest capture is automatically deleted.

Requires screenshot-basic and set screenshot_basic_allow_fs_write "true" in server.cfg.

Shop PED

Config.Ped = {
    model = "s_m_y_ammucity_01",
    scenario = "WORLD_HUMAN_STAND_IMPATIENT",
}

Shop positions

Config.ShopPositions = {
    {
        pos = vector3(72.25, -1399.10, 29.38),
        heading = 270.0,
        blip = {
            sprite = 689,
            color = 3,
            scale = 0.7,
            label = "Security Shop",
        },
    },
}

Computer positions

Config.ComputerPositions = {
    {
        pos = vector3(441.81, -982.08, 30.69),
        heading = 0.0,
        label = "computer_label",
    },
}

Fixed computer terminals that open the camera panel (no prop spawned, zone-based interaction).

Station positions

Config.StationPositions = {
    {
        pos = vector3(441.81, -982.08, 30.69),
        heading = 0.0,
    },
}

Fixed monitoring stations with prop_cctv_unit_01 prop spawned. Same functionality as tablets.

Interaction

Config.InteractionDistance = 2.5

Config.Marker = {
    type = 1,
    scale = vector3(1.0, 1.0, 0.5),
    color = { r = 59, g = 130, b = 246, a = 120 },
}

Notifications

function ClientNotification(message, type)
    exports['ox_inventory']:Notification(message)
end

Override this function in config.lua to use your own notification system. The server triggers the client event foltone_cctv:notify which calls this function.