🚚OLRP Truck Heist

🎯 Overview

OLRP Truck Heist is an advanced armored truck heist system that provides immersive and challenging heist experiences on your FiveM server. This professional-grade script features realistic AI guards, explosive mechanics, and comprehensive reward systems that create exciting interactions between criminals and law enforcement.

Key Features

• 🚛 Dynamic Truck Spawning - Multiple realistic bank locations with escort vehicles

• 🤖 Intelligent AI Guards - Realistic combat behavior and vehicle exit mechanics

• 💣 Explosive Mechanics - Plant explosives with countdown timers for realistic gameplay

• 💰 Comprehensive Rewards - Money and item rewards worth up to $250k per heist

• 🚨 Police Integration - Automatic dispatch alerts for law enforcement

• 📡 Tracker System - Real-time truck location tracking for all players

• 🔧 Fully Customizable - Every aspect can be configured to your needs

• ⚡ Performance Optimized - Efficient resource usage for high player counts

🚀 Quick Start

1

Install

Install the script to your server.

2

Configure

Configure your framework (QBCore/ESX) and dependencies.

3

Customize

Customize spawn locations, rewards, and police requirements.

4

Start

Start the resource and begin heists.

5

Monitor

Monitor player activity and adjust settings as needed.

📋 Requirements

• Framework: Qbox, QBCore or ESX

• Required Dependencies: ultra-voltlab (Voltage hacking minigame)

• Optional Dependencies: ox_lib (notifications), ps-dispatch (police alerts)

• Permissions: Admin access for configuration

• Server: FiveM server with Lua 5.4 support

• Players: 50+ recommended for best experience

🎮 How It Works

1

Information Gathering

Players interact with NPCs to start the heist.

2

Intermediate Location

Players visit info ped for truck location.

3

Truck Spawn

Armored truck spawns at bank location.

4

Combat Phase

Players damage truck to make guards exit.

5

Explosive Planting

Players plant explosives on the truck.

6

Countdown

30-second explosion timer.

7

Looting

After explosion, players loot the destroyed truck.

8

Rewards

Money and items distributed to successful players.

---

Installation Guide

📋 Prerequisites

Before installing OLRP CIT Heist, ensure you have:

• FiveM Server with admin access and Lua 5.4 support

• Framework: Qbox, QBCore or ESX installed and running

• ultra-voltlab - Required dependency for voltage hacking minigame

• ox_lib (optional) for enhanced notifications

• ps-dispatch (optional) for police integration

• Server Restart capability for testing

🚀 Installation Steps

1

Download & Extract

• Download the OLRP CIT Heist script from your purchase

• Extract the files to your server's resources folder

Ensure the folder structure is correct:

resources/olrp_citheist/

resources/
└── olrp_citheist/
    ├── client.lua
    ├── server.lua
    ├── config.lua
    └── fxmanifest.lua

2

Framework Setup — QBCore

1. Ensure qb-core is installed and running

2. Configure framework setting in config.lua:

config.lua (QBCore)

Config.Framework = "qb-core"
Config.Notification = "qb-core" -- or "ox_lib"

3

Framework Setup — ESX

1. Ensure es_extended is installed and running

2. Configure framework setting in config.lua:

config.lua (ESX)

Config.Framework = "esx"
Config.Notification = "ox_lib" -- Recommended for ESX

4

Dependencies

1. Download ultra-voltlab - Voltage hacking minigame

2. Extract to your resources folder

Add required dependencies to your server.cfg:

server.cfg

# Required dependency
ensure ultra-voltlab   # Voltage hacking minigame (REQUIRED)

# Optional dependencies
ensure ox_lib          # For notifications (optional but recommended)
ensure ps-dispatch     # For police alerts (optional)

5

Server Configuration

Add the resource to your server.cfg:

server.cfg (add resource)

# Add this line to your server.cfg
ensure olrp_citheist

Important startup order example:

server.cfg (startup order)

ensure qb-core        # Or es_extended for ESX
ensure ultra-voltlab   # REQUIRED - Voltage hacking minigame
ensure ox_lib          # Optional dependency
ensure ps-dispatch     # Optional dependency
ensure olrp_citheist   # Your script

6

Initial Configuration

1. Open config.lua and configure basic settings:

config.lua (examples)

Config.Framework = "qb-core" -- or "esx"
Config.Notification = "qb-core" -- or "ox_lib"
Config.CooldownTime = 60 -- Minutes between heists per player
Config.HeistDuration = 45 -- Maximum heist duration

1. Configure spawn locations (if needed):

config.lua (spawn locations)

Config.TruckSpawnLocations = {
    vector4(-2958.72, 493.05, 15.31, 89.11), -- Great Ocean Highway Bank
    -- Add more locations as needed
}

1. Configure rewards (default values are provided):

config.lua (rewards)

Config.Rewards = {
    minMoney = 5000,
    maxMoney = 15000,
    items = {
        {item = "markedbills", amount = {min = 1, max = 2}},
        {item = "goldbar", amount = {min = 200, max = 200}},
    }
}

7

Start the Resource

1. Restart your server or use the command:

restart olrp_citheist

1. Check the console for initialization messages:

[OLRP CIT Heist] Resource started successfully
[OLRP CIT Heist] Framework detected: QBCore
[OLRP CIT Heist] Heist system initialized

🔧 Post-Installation Setup

Police Integration Setup (Optional)

1. Install ps-dispatch (if not already installed)

2. Configure dispatch settings in config.lua:

config.lua (dispatch)

Config.Dispatch = {
    enabled = true,
    code = "10-90",
    message = "CIT Truck Robbery in Progress",
    -- ... other settings
}

Item Requirements Setup (Optional)

If you want to require items to start heists:

1. Add items to your framework:

   • QBCore: Add to qb-core/shared/items.lua

   • ESX: Add to your database

2. Configure the script:

config.lua (required item)

Config.RequireItem = true
Config.RequiredItem = "calling_card" -- Your item name

Testing the Installation

1. Test Basic Functionality:

   • Join your server

   • Find the NPC informant (check config.lua coordinates)

   • Start a heist by pressing E on the NPC

   • Follow the truck and test mechanics

2. Test Advanced Features:

   • Test with multiple players

   • Verify police dispatch (if enabled)

   • Check reward distribution

   • Test cooldown system

⚠️ Troubleshooting

Common Issues

Script Won't Start

• Check Dependencies: Ensure frameworks and dependencies are installed

• Verify Framework: Confirm your framework (QBCore/ESX) is running

• Check Syntax: Validate Lua syntax in config files

Guards Don't Spawn

• Check Guard Model: Verify guard model exists in your server

• Model Name: Check Config.Guards.model setting

• Framework Load: Ensure framework is fully loaded before script start

Truck Doesn't Spawn

• Check Truck Model: Verify truck model is available

• Spawn Coordinates: Check spawn location coordinates

• Conflicting Scripts: Check for conflicting vehicle spawn scripts

Notifications Don't Work

• Check Config: Verify notification settings

• Framework Issues: Ensure framework integration is working

• ox_lib: Ensure ox_lib is installed (if using)

Police Dispatch Issues

• Verify ps-dispatch: Ensure ps-dispatch is installed and configured

• Dispatch Config: Check dispatch configuration in config.lua

• Police Jobs: Ensure police job names match your server

ultra-voltlab Issues

• Install ultra-voltlab: Download ultra-voltlab from GitHub

• Ensure startup order: Add ensure ultra-voltlab BEFORE ensure olrp_citheist in server.cfg

Debug Commands

Admin commands for troubleshooting:

/resetcitcooldown [playerid] -- Reset player cooldown
/endcitheist [playerid] -- Force end active heist
/citheiststatus -- Check current heist status

---

Configuration Guide

⚙️ Configuration Overview

OLRP Truck Heist offers extensive customization through the main config.lua file:

• Framework Settings - Qbox, QBCore or ESX configuration

• General Settings - Cooldowns, durations, and requirements

• NPC Settings - Informant NPCs and locations

• Vehicle Settings - Truck and escort vehicle configuration

• Guard Settings - AI guard behavior and equipment

• Explosive Settings - Explosion mechanics and requirements

• Reward Settings - Money and item rewards

• Police Settings - Dispatch and police requirements

🖥️ Basic Configuration

Framework Configuration

config.lua (framework)

Config.Framework = "qb-core" -- "qb-core" or "esx"
Config.Notification = "qb-core" -- "qb-core" or "ox_lib"

General Settings

config.lua (general)

Config.CooldownTime = 60 -- Minutes between heists per player
Config.HeistDuration = false -- Maximum heist duration (false to disable)
Config.MaxDistance = false -- Maximum distance truck can travel (false to disable)
Config.RequireItem = false -- Require item to start heist

Cooldown Management

Setting	Description	Default	Options
CooldownTime	Minutes between heists	60	30-300
HeistDuration	Max heist duration (minutes)	false	false or 30-120
MaxDistance	Max truck travel distance	false	false or number

🚛 Truck & Vehicle Configuration

Truck Spawn Locations

config.lua (truck spawn locations)

Config.TruckSpawnLocations = {
    vector4(-2958.72, 493.05, 15.31, 89.11), -- Bank location
    -- Add more locations
}

Truck Models

config.lua (truck model)

Config.TruckModel = "stockade3" -- Armored truck model

Available truck models:

• stockade3 - Main armored truck

• stockade2 - Alternative armored truck

• stockade - Original armored truck

Escort Vehicle Configuration

config.lua (escort vehicle)

Config.EscortVehicle = {
    enabled = false, -- Enable escort vehicle
    model = "insurgent", -- Escort vehicle model
    guardCount = 4, -- Number of guards in escort
    followDistance = 15.0, -- Follow distance
}

Available escort models:

• insurgent, mesa, fbi2, sheriff2, riot, stockade

🤖 Guard Configuration

Guard Settings

config.lua (guards)

Config.Guards = {
    count = 4, -- Number of guards in the main truck
    model = "s_m_m_prisguard_01", -- Guard model
    weapons = {
        "weapon_carbinerifle",
        "weapon_specialcarbine",
        "weapon_advancedrifle"
    },
    armor = 200, -- Guard armor level (0-100)
}

Guard Behavior

• Auto-Exit: Guards automatically exit when truck is damaged

• Combat AI: Guards fight back with configured weapons

• Armor System: Configurable armor levels

• Death Detection: Guards removed when killed

💣 Explosive Configuration

Explosive Settings

config.lua (explosive)

Config.Explosive = {
    requireItem = false, -- Require explosive item
    requiredItem = "explosive", -- Item needed to plant
    countdown = 30, -- Countdown time in seconds
    damageThreshold = 500, -- Truck damage needed
    explosionRadius = 10.0, -- Explosion radius
    explosionDamage = 1000, -- Explosion damage
}

Explosive Mechanics

• Damage Threshold: Truck must take 500 damage before guards exit

• Countdown Timer: 30-second countdown before explosion

• Visual Effects: Explosion effects and sound

• Item Requirement: Optional explosive item requirement

🎁 Reward Configuration

Money Rewards

config.lua (rewards money)

Config.Rewards = {
    minMoney = 5000, -- Minimum money reward
    maxMoney = 15000, -- Maximum money reward
}

Item Rewards

config.lua (rewards items)

Config.Rewards.items = {
    {item = "markedbills", amount = {min = 1, max = 2}},
    {item = "goldbar", amount = {min = 200, max = 200}},
}

Reward Structure

• Total Value: ~$250k per heist

• Money Range: $5k - $15k

• Marked Bills: $1k - $6k

• Gold Bars: $237k (200 × $1,185)

🚨 Police Configuration

Police Requirements

config.lua (police)

Config.RequirePolice = false -- Require police on duty
Config.MinPoliceCount = 3 -- Minimum police officers required
Config.PoliceJobs = {
    ["police"] = true,
    ["bcso"] = true,
    ["sheriff"] = true,
    -- Add more police jobs
}

Dispatch Settings

config.lua (dispatch settings)

Config.Dispatch = {
    enabled = true,
    code = "10-90",
    message = "CIT Truck Robbery in Progress",
    sprite = 477,
    color = 1,
    scale = 1.0,
}

📍 Location Configuration

Info Ped Location

config.lua (info ped)

Config.InfoPed = {
    model = "a_m_y_hipster_01",
    coords = vector4(706.12, -964.9, 30.4, 0.0),
}

NPC Informant Locations

config.lua (npcs)

Config.NPCs = {
    {
        model = "a_m_m_prolhost_01",
        coords = vector4(-1392.83, -1326.67, 4.15, 76.88),
    },
    -- Add more NPCs
}

📡 Tracker Configuration

Tracker Settings

config.lua (tracker)

Config.Tracker = {
    updateInterval = 5000, -- Update interval (milliseconds)
    movementThreshold = 5.0, -- Movement threshold
    activateDistance = 50.0, -- Activate distance
}

Performance Optimization

For high player count servers (100+), increase update interval:

Config.Tracker.updateInterval = 5000 -- Increased from default 2000

🎯 Blip Configuration

Blip Settings

config.lua (blips)

Config.Blips = {
    truck = {
        sprite = 477,
        color = 1,
        scale = 1.0,
        name = "CIT Truck"
    },
    delivery = {
        sprite = 500,
        color = 2,
        scale = 0.8,
        name = "Delivery Point"
    }
}

⚡ Performance Optimization

For High Player Count Servers (100+)

Config.CooldownTime = 60 -- Increase cooldown
Config.Tracker.updateInterval = 5000 -- Increase update interval
Config.Loot.lootingTime = 8000 -- Reduce looting time

For Standard Servers (50-100)

Config.CooldownTime = 30 -- Standard cooldown
Config.Tracker.updateInterval = 2000 -- Standard update interval
Config.Loot.lootingTime = 10000 -- Standard looting time

---

Features & Functionality

🎯 Core Features

Dynamic Truck Spawning

• Multiple Locations: Truck spawns at various bank locations

• Realistic Locations: Actual in-game banks and financial institutions

• Random Selection: Each heist uses a random spawn location

• Escort Vehicles: Optional escort vehicles for increased difficulty

AI Guard System

• Intelligent Behavior: Guards exit vehicle when truck is damaged

• Realistic Combat: Guards fight back with configured weapons

• Armor System: Configurable armor levels for challenge

• Multiple Guards: 4+ guards per truck with escort option

Explosive Mechanics

• Planting System: Players plant explosives on truck

• Countdown Timer: 30-second explosion countdown

• Visual Effects: Realistic explosion effects and sound

• Damage Threshold: Truck must be damaged before guards exit

• Required Items: Optional explosive item requirement

Looting System

• Post-Explosion: Looting available after truck is destroyed

• Interaction: Press E to loot destroyed truck

• Progress Bar: Visual progress indicator during looting

• Comprehensive Rewards: Money and items worth up to $250k

Police Integration

• Dispatch Alerts: Automatic police notifications when heist starts

• Real-time Tracking: Police receive truck location updates

• Radio Codes: Configurable dispatch codes and messages

• Blip Updates: Police blips update as truck moves

🎮 Player Experience

Starting a Heist

1

Locate NPC

Find the informant NPC marked on map.

2

Get Information

Press E to receive truck information.

3

Visit Info Ped

Go to marked location for final info.

4

Tracker Active

Receive tracker location update.

5

Rush to Location

Get to truck before it escapes.

Combat Phase

1

Engage Truck

Approach and damage the armored truck.

2

Guard Exit

Guards exit vehicle when damage threshold reached.

3

Eliminate Guards

Fight and eliminate all guards.

4

Plant Explosive

Place explosive on truck.

5

Get Away

Evacuate area before explosion.

Explosion Phase

1

Countdown

30-second countdown begins.

2

Visual Timer

Countdown displayed to player.

3

Explosion

Truck destroyed with realistic effects.

4

Cleanup

Guards and vehicles removed.

Looting Phase

1

Truck Destroyed

Destroyed truck becomes lootable.

2

Press E

Interact with destroyed truck.

3

Looting Animation

Progress bar shows looting progress.

4

Receive Rewards

Money and items distributed.

5

Cooldown

Player enters cooldown period.

🎨 Visual Features

Blip System

• Truck Blip: Red blip showing truck location

• Delivery Blip: Green blip for delivery location

• Info Ped Blip: Flashing blip for info location

• Real-time Updates: Blips update as truck moves

Notification System

• Color-Coded: Different colors for different events

• Rich Formatting: Professional notification styling

• Progress Indicators: Visual progress for looting

• Countdown Timers: Visual explosion countdown

AI Behavior

• Realistic Movement: Guards move naturally

• Combat AI: Guards fight back intelligently

• Vehicle Exit: Guards exit damaged vehicles

• Death Cleanup: Guards removed when killed

🔧 Technical Features

Performance Optimization

• Efficient Threads: Optimized thread management

• Distance-Based: Features activate based on distance

• Proper Cleanup: Entities removed when not needed

• Memory Management: Efficient memory usage

Error Handling

• Graceful Failures: System continues if errors occur

• Partial Rewards: Players get what they can

• Logging System: Comprehensive error logging

• Fallback Systems: Default behaviors for edge cases

Framework Compatibility

• QBCore Support: Full integration with QBCore

• ESX Support: Compatible with ESX framework

• Dual Framework: Automatic framework detection

• Bridge System: Seamless framework switching

📊 Police Interactions

Dispatch Features

• Automatic Alerts: Police notified when heist starts

• Real-time Location: Police track truck movements

• Multiple Job Support: Configurable police job names

• Dispatch Integration: ps-dispatch compatibility

Police Requirements

• Minimum Count: Configurable minimum police officers

• On-Duty Check: Only counts on-duty police officers

• Job Names: Configurable police job names

• Disable Option: Can disable police requirements

🛡️ Security Features

Cooldown System

• Per-Player: Individual cooldowns for each player

• Configurable Time: Customizable cooldown duration

• Server-Side: Cooldowns tracked server-side

• Admin Reset: Admins can reset cooldowns

Item Requirements

• Optional Requirement: Can require items to start heist

• Item Removal: Configured item removal after start

• Framework Integration: Works with framework inventory

• Flexible System: Multiple item support

Share System

• Nearby Sharing: Share heist with nearby players

• Distance Configuration: Configurable sharing distance

• Team Coordination: Groups can work together

• Cooldown Respect: All participants enter cooldown

---

Rewards System

🎁 Rewards Overview

The OLRP CIT Heist rewards system provides balanced and exciting rewards that enhance gameplay while maintaining server economy balance. Each successful heist yields approximately $250k in total value.

💰 Reward Structure

Money Rewards

• Minimum: $5,000 cash

• Maximum: $15,000 cash

• Random Range: Random amount within range per heist

Item Rewards

Marked Bills

• Amount: 1-2 marked bills

• Value: $1,000 - $6,000 total

• Purpose: Untraceable cash for roleplay

Gold Bars

• Amount: 200 gold bars

• Value: $237,000 (200 × $1,185)

• Purpose: Primary high-value reward

📊 Total Heist Value

Default Configuration

• Cash: $5,000 - $15,000

• Marked Bills: $1,000 - $6,000

• Gold Bars: $237,000

• Total: ~$248,000 - $258,000 per heist

Reward Distribution

• Immediate Cash: Received upon looting

• Items: Distributed via framework inventory

• Notification: Success message with reward amounts

• Logging: All rewards logged server-side

🎲 Reward Mechanics

Selection Process

1. Random Money: Money amount randomly selected within range

2. Random Items: Item amounts randomly selected within range

3. All Rewards: Player receives all configured rewards

4. Framework Distribution: Rewards given via framework functions

Error Handling

• Partial Success: Player gets successful rewards if some fail

• Inventory Space: Handles full inventory gracefully

• Item Validation: Ensures items exist before giving

• Logging: All reward attempts logged

🔧 Customization

Modifying Rewards

Adding New Items

Config.Rewards.items = {
    {item = "markedbills", amount = {min = 1, max = 2}},
    {item = "goldbar", amount = {min = 200, max = 200}},
    {item = "your_item", amount = {min = 1, max = 10}}, -- Add your item
}

Adjusting Money Amounts

Config.Rewards = {
    minMoney = 10000, -- Increase minimum
    maxMoney = 20000, -- Increase maximum
}

Custom Reward Logic

You can modify the reward distribution in server.lua to add custom logic:

• Server Events: Modify reward distribution events

• Framework Integration: Custom reward functions

• Validation: Additional reward validation

Economy Balance

For High-Economy Servers

Config.Rewards = {
    minMoney = 15000,
    maxMoney = 30000,
}

For Low-Economy Servers

Config.Rewards = {
    minMoney = 2000,
    maxMoney = 8000,
}

For Roleplay Servers

Keep default values and adjust item amounts based on your economy.

📊 Reward Examples

• Example 1: Cash $12,500 + Marked Bills 2 ($6,000) + Gold Bars 200 ($237,000) = $255,500

• Example 2: Cash $7,300 + Marked Bills 1 ($3,000) + Gold Bars 200 ($237,000) = $247,300

• Example 3: Cash $14,200 + Marked Bills 2 ($6,000) + Gold Bars 200 ($237,000) = $257,200

🎯 Player Experience

Reward Notification

When player successfully loots the truck:

• Success Message: "Heist completed successfully! You earned $X"

• Item Notifications: Framework-specific item notifications

• Logging: Server logs all reward distributions

Collection Experience

• Immediate Rewards: All rewards given instantly

• Visual Feedback: Clear success/error messages

• Inventory Management: Automatic inventory handling

• Error Recovery: Graceful handling of failures

Competition Element

• First-Come-First-Served: Only first player gets rewards

• Strategic Timing: Players must time approach carefully

• Risk vs Reward: Balance between safety and rewards

• Team Coordination: Groups must coordinate looting

🔒 Security

Server-Side Distribution

• Server Authority: All rewards processed server-side

• Validation: Item and money validation before distribution

• Framework Integration: Uses framework functions only

• No Client Authority: No client-side reward manipulation

Cooldown Protection

• Per-Player Cooldown: Individual cooldowns prevent spam

• Configurable Duration: Adjust cooldown based on economy

• Server Tracking: Cooldowns tracked server-side

• Admin Override: Admins can reset cooldowns

---

Troubleshooting

(See Installation Guide > Troubleshooting for common issues and debug commands)

🔧 Performance Issues

Server Lag During Heists

Solutions:

• Increase Cooldown: Reduce heist frequency

• Reduce Locations: Use fewer spawn locations

• Simplify Guards: Reduce guard count

• Optimize Settings: Adjust tracker update intervals

High Memory Usage

Solutions:

• Cleanup: Ensure proper cleanup of entities

• Reduce Entities: Lower guard count

• Disable Features: Disable escort vehicles

• Update Settings: Optimize performance settings

FPS Drops During Heists

Solutions:

• Reduce Entities: Lower guard and vehicle counts

• Distance Checks: Ensure proper distance-based activation

• Optimize Scripts: Check for performance issues in custom code

• Server Resources: Monitor server resources

📊 Debug Mode

Enabling Debug Information

Add debug logging to client.lua:

-- Add print statements for debugging
print("Debug: Truck spawned at", coords)
print("Debug: Guards spawned:", #guards)

Admin Commands

/resetcitcooldown [playerid] -- Reset player cooldown
/endcitheist [playerid] -- Force end heist
/citheiststatus -- Check heist status

🔄 Update Issues

Configuration Migration

Solutions:

• Backup Config: Always backup working configurations

• Check Changelog: Review update changelog for changes

• Update Settings: Apply new configuration settings

• Test Thoroughly: Test in development environment

Version Compatibility

Solutions:

• Framework Version: Check framework version compatibility

• Update Framework: Update to compatible framework version

• Check Bridge: Verify framework bridge compatibility

• Test Compatibility: Test with different framework versions

📞 Getting Help

Before Contacting Support

1. Enable Debug Mode: Add debug logging

2. Check Console: Look for error messages

3. Test Configuration: Verify all config files

4. Document Steps: Note exact reproduction steps

5. Gather Information: Collect server details

Information to Provide

• Server Details: Framework, version, player count

• Error Messages: Exact console error messages

• Configuration: Relevant config file contents

• Reproduction Steps: Steps to reproduce issue

• Console Output: Full console output with errors

Community Support

• Discord: Join OLRP Discord for community help

• Documentation: Check this documentation thoroughly

• Forums: Search forums for similar issues

• GitHub: Check for known issues and solutions

---

FAQ

❓ Frequently Asked Questions

What frameworks does OLRP CIT Heist support?

A: OLRP CIT Heist supports both QBCore and ESX frameworks with automatic detection.

How long is the cooldown between heists?

A: The default cooldown is 60 minutes per player, but this is fully customizable in the configuration.

Can I customize the spawn locations?

A: Yes! You can add, remove, or modify spawn locations in config.lua. The script includes multiple realistic bank locations.

What happens if a player dies during the heist?

A: The heist continues, and other players can complete it. The dead player is still on cooldown.

Can multiple players participate in one heist?

A: Yes! The script supports nearby player sharing, allowing groups to work together on heists.

How do I change the reward amounts?

A: Edit the `Config.Rewards` section in config.lua to modify money amounts and item quantities.

Can I add my own custom items to the rewards?

A: Yes! Simply add your custom items to the rewards.items table in config.lua. Ensure item names match your server's item database.

How do I set up police dispatch notifications?

A: Install ps-dispatch, then configure the `Config.Dispatch` settings in config.lua. Set enabled to true and configure police job names.

Can I disable certain features?

A: Yes! Most features can be disabled or modified in config.lua. Check the configuration guide for details.

Does this script cause server lag?

A: No, OLRP CIT Heist is optimized for performance with efficient thread management and proper entity cleanup.

What if a player's inventory is full?

A: The script handles inventory management automatically. If some items can't be given, the player will receive what they can.

Can I run multiple heists simultaneously?

A: No, only one heist can be active at a time. This prevents conflicts and ensures balanced gameplay.

How do I update the script?

A: Download the new version, backup your configuration, replace the script files, restore your configs, and restart.

What is ultra-voltlab and why do I need it?

A: is a Cayo Perico voltage hacking minigame that provides the hacking interface for the heist. It's a required dependency that must be installed separately. Download it from GitHub and add it to your resources. (Link kept above.)

Will this script inflate my server's economy?

A: No, the rewards are designed to be balanced. Default rewards total ~$250k per heist with a 60-minute cooldown, keeping economy impact minimal.

Can I adjust the cash rewards for my server's economy?

A: Absolutely! All reward amounts are fully customizable in config.lua. Scale the amounts to match your server's economy.

What if I want to remove cash rewards entirely?

A: Simply set minMoney and maxMoney to 0, or remove cash distribution in the rewards function.

How many spawn locations should I use?

A: The script works well with 3-5 spawn locations, but you can add more for variety. More locations don't significantly impact performance.

Can I reduce the spawn frequency for better performance?

A: Yes! Increase the CooldownTime value in config.lua to reduce heist frequency and improve performance.

Should I enable escort vehicles?

A: Escort vehicles add difficulty and realism but increase server load slightly. Disable for better performance on high player count servers.

Where can I get help if I have issues?

A: Check this documentation first, then join the OLRP Discord community for support. Make sure to provide detailed information about your issue.

Do you provide custom modifications?

A: Contact support for information about custom modifications. Many requests can be handled through configuration changes.

Is there a warranty or guarantee?

A: Check your purchase agreement for warranty details. We provide ongoing support and updates for our scripts.