Pickpocketing

A feature-rich pickpocketing script that allows players to steal items from NPCs using a difficulty-based minigame system.

Features

• Interactive pickpocketing minigame with moving safe zones

• Dynamic loot table with difficulty-based rewards

• Bystander witness system with police reporting

• Timeout/cooldown system to prevent spam

• Police dispatch integration

• Early exit option with configurable success/failure

• Blip system for reporting NPCs

• Multi-language locale support

Installation

1. Place ls_pickpocket in your resources folder

2. Configure the script (see Configuration section)

3. Add to server.cfg:

   ensure ls_pickpocket

4. Restart your server

Dependencies

• Required:

  • None (standalone)

• Recommended:

  • Framework (ESX/QBCore) for inventory integration

  • Dispatch system for police alerts

Configuration

Located in server/editables/editables.lua and client/editables/editables.lua

Main Configuration

Timeout System

Config.timeout = {
    enabled = true,           -- Enable cooldown system
    max_attempts = 3,         -- Maximum attempts before timeout
    duration = 120,           -- Timeout duration in seconds
}

Minigame Settings

Config.time_to_pickpocket = {
    min = 20,  -- Minimum game duration (seconds)
    max = 30,  -- Maximum game duration (seconds)
}

Config.early_exit_success = true  -- Exit early = automatic success

Difficulty Configuration

Safe zone width determines difficulty:

Config.safe_zone_width = {
    Easy = 50,     -- 50% safe zone
    Medium = 35,   -- 35% safe zone
    Hard = 25,     -- 25% safe zone
    Expert = 10,   -- 10% safe zone (very difficult)
}

Bystander System

Config.bystanders = {
    enabled = true,
    chance = 100,              -- Percentage chance of report (1-100)
    time_to_report = 5,        -- Seconds before calling police
    show_blips = true,         -- Show blip on reporting NPCs
    blip = {
        sprite = 161,
        color = 1,
        scale = 0.8,
    },
}

NPC Selection

Config.still_peds_only = false  -- Only allow pickpocketing stationary NPCs

Loot Table Configuration

Configure items in the loot table:

Config.items = {
    {
        name = 'wallet',
        label = 'Wallet',
        image = 'wallet.png',
        amount = {min = 1, max = 1},
        difficulty = 'Easy',
    },
    {
        name = 'phone',
        label = 'Phone',
        image = 'phone.png',
        amount = {min = 1, max = 1},
        difficulty = 'Medium',
    },
    {
        name = 'jewelry',
        label = 'Jewelry',
        image = 'jewelry.png',
        amount = {min = 1, max = 3},
        difficulty = 'Hard',
    },
    {
        name = 'rolex',
        label = 'Rolex Watch',
        image = 'rolex.png',
        amount = {min = 1, max = 1},
        difficulty = 'Expert',
    },
}

Police Dispatch

Config.dispatch = {
    enable = true,
    system = 'cd_dispatch',    -- 'cd_dispatch', 'ps-dispatch', etc.
    alertChance = 75,          -- Percentage chance of alert
    policeCode = '10-60',
    description = 'Pickpocketing in progress',
    blip = {
        sprite = 161,
        color = 1,
        scale = 1.0,
    },
    timeout = 60,              -- Blip duration (seconds)
}

How It Works

Player Experience

1

Target NPC

• Player approaches an NPC

• Initiates pickpocket action

2

Minigame

• Moving bar appears on screen

• Player must keep cursor in safe zone

• Duration: 20-30 seconds (random)

• Can exit early (configurable success/failure)

3

Outcome

• Success: Receives random loot based on difficulty

• Failure: No items obtained

• Witnesses: Nearby NPCs may report to police

• Cooldown: Timeout applied if max attempts reached

4

Police Response

• Dispatch alert sent (if configured)

• Police respond to location

• Blip shows on police map

Difficulty System

Item rewards are tied to difficulty levels:

• Easy: Common items (wallets, small cash)

• Medium: Moderate value items (phones, cards)

• Hard: Valuable items (jewelry, electronics)

• Expert: Rare/expensive items (luxury watches, diamonds)

Difficulty affects:

• Safe zone width in minigame

• Item rarity in loot pool

• Potential reward value

Usage Examples

Basic Pickpocketing

1

Approach any NPC on the street

2

Press interaction key

3

Complete the minigame

4

Receive items on success

Timeout System

After 3 failed attempts (default):

• Player is locked out for 120 seconds

• Timer displays remaining cooldown

• Can resume after timeout expires

Witness Reporting

When witnesses are enabled:

• Nearby NPCs can report the crime

• 100% chance by default (configurable)

• 5-second delay before reporting

• Blip appears on reporting NPC

• Police dispatch triggered

Customization

Adding New Items

1

Open loot table configuration

2

Add new item entry:

{
    name = 'item_id',
    label = 'Display Name',
    image = 'item_image.png',
    amount = {min = 1, max = 5},
    difficulty = 'Medium',  -- Easy, Medium, Hard, Expert
}

Adjusting Difficulty

Make the minigame easier:

Config.safe_zone_width.Hard = 35  -- Increase safe zone
Config.time_to_pickpocket.min = 15  -- Reduce duration

Make it harder:

Config.safe_zone_width.Easy = 30  -- Reduce safe zone
Config.time_to_pickpocket.min = 25  -- Increase duration

Disable Bystanders

Config.bystanders.enabled = false

Modify Cooldown

Config.timeout = {
    enabled = true,
    max_attempts = 5,      -- More attempts
    duration = 60,         -- Shorter timeout
}

Dispatch Integration

cd_dispatch

Config.dispatch.system = 'cd_dispatch'

-- Automatically integrated

ps-dispatch

Config.dispatch.system = 'ps-dispatch'

-- Configure in dispatch resource

Custom Dispatch

Modify event in client/client.lua:

-- Find dispatch trigger
TriggerServerEvent('your-dispatch:pickpocket', coords)

Troubleshooting

Minigame Not Appearing

• Check browser console for errors (F8)

• Verify NUI resources are loading

• Ensure script is fully started

No Items Received

• Check loot table configuration

• Verify item names match inventory

• Enable debug mode to check item spawning

Bystanders Not Reporting

• Verify Config.bystanders.enabled = true

• Check police job configuration

• Ensure dispatch system is running

Timeout Not Working

• Verify Config.timeout.enabled = true

• Check console for errors

• Ensure max_attempts is set correctly

Debug Mode

Enable debug output:

-- In config:
Config.debug = true

Debug information includes:

• NPC detection

• Minigame events

• Item rewards

• Timeout tracking

• Bystander detection

Performance

• Optimized NPC detection - Only checks nearby NPCs

• Efficient minigame - Lightweight UI

• Smart witness system - Limited radius checks

• Idle: 0.00ms

• Active: 0.01-0.02ms

Locale Support

Customize text in locale/en.lua (or your language):

Locale = {
    ['pickpocket_start'] = 'Pickpocketing...',
    ['pickpocket_success'] = 'You successfully pickpocketed!',
    ['pickpocket_failed'] = 'Pickpocket attempt failed!',
    ['timeout_active'] = 'You must wait %s seconds',
    -- ... more strings
}

API Reference

Exports

Currently no exports. Future versions may include:

• StartPickpocket(ped) - Start pickpocket on specific ped

• IsInTimeout(playerId) - Check if player is in timeout

Support

For issues or questions:

• Enable debug mode first

• Check console for errors

• Review configuration

• Contact Lith Studios support

Changelog

v1.0.0 - Initial Release

• Four difficulty levels

• Bystander witness system

• Timeout/cooldown system

• Police dispatch integration

• Multi-language support