LG Phone Snatching (Standalone/QB/ESX/TMC)

Package Description

This asset is protected by the FiveM Asset Escrow Protection System.

LGMods Phone Snatching

LGMods Phone Snatching is a realistic, server-authoritative phone theft system that introduces a thrilling new layer of criminal roleplay to your server. Players can snatch phones directly from other players while sprinting past them on foot or riding pillion on a motorbike — just like real-life street theft scenarios.

With a skill-based hold-to-arm mechanic, direction-based success chances, a contested recovery window, and full anti-grief protections, this script delivers an experience that is immersive, balanced, and fair for both criminals and victims.

🏃 Hold-to-Arm Snatch Mechanic

Hold-to-Arm System: Players must hold a configurable key to enter snatch-ready mode — preventing accidental triggers.
Sprint Detection: Automatically detects valid targets while sprinting within range.
Snatch Animation: Realistic arm-out and grab animations for immersive gameplay.
Rebindable Controls: Fully compatible with FiveM’s built-in keybind settings.

🎯 Skill-Based Success System

Direction-Based Chance: Higher success rates from behind, lower from the front — stealth is rewarded over brute force.
Sprint Speed Bonus: Full sprinting grants an additional edge during the success roll.
Stumble on Failure: Failed attempts cause the robber to ragdoll, giving victims time to react.
Fully Configurable: Base chances, bonuses, and penalties are all adjustable in the config.

📱 Contested Recovery Period

Chase Window: Victims receive a configurable time window to pursue and recover their phone.
3D Floating Prompt: A floating “[E] Recover Phone” prompt appears above the phone prop.
Phone Prop Visual: A physical phone model attaches to the robber’s hand during the contested phase.
Full Metadata Transfer: Contacts, messages, apps, and data are preserved throughout the process.

🏍️ Motorbike & Bicycle Snatching

Passenger Snatching: Snatch phones while riding as a passenger on motorbikes, mopeds, or bicycles.
Speed-Based Activation: The vehicle must be moving for the snatch to trigger.
Separate Snatch Radius: Configurable drive-by grab distance independent of on-foot settings.
Realistic Execution: Mirrors authentic real-world phone snatching tactics.

🛡️ Anti-Grief & Safety Systems

Triple Cooldown System: Per-snatcher, per-victim, and per-pair cooldowns prevent spam targeting.
Safe Zones: Configurable no-snatch areas (police stations, hospitals, courthouses, etc.).
Vehicle Protection: Victims inside vehicles cannot be targeted.
Armed Victim Check: Snatching disabled if the victim has a weapon drawn.
Death Recovery: Phone automatically returns if the robber dies.
Disconnect Safety: Phones safely return if either player disconnects.
Resource Stop Safety: All contested phones are returned if the resource stops unexpectedly.

📱 Phone Script Compatibility (Require Phone Out)

Optional Restriction: Only allow snatching if the victim has their phone open — fully toggleable.
State Bag Support: Works out of the box with lb-phone, qb-phone, qs-smartphone-pro, high-phone, gksphone, roadphone, and npwd.
Universal Animation Fallback: Animation-based detection ensures compatibility with any phone script.

🔔 Custom Notification Support

Auto-Detection: Uses your framework’s notification system by default, with ox_lib auto-detected.
Custom System Integration: Supports mythic_notify, okokNotify, pNotify, LGMods_Notify, or your own system.
Simple Setup: Uncomment a line or plug in your own export/event.

🚔 Dispatch Integration

Toggle On/Off: Enable or disable dispatch alerts via config.
Pre-Configured Examples: ps-dispatch, cd_dispatch, core_dispatch, qs-dispatch ready to use.
Universal Compatibility: Works with any dispatch system using a simple export or event.

🔧 Framework & Inventory Support

Multi-Framework: Auto-detects QBCore, Qbox, ESX, TMC, or runs standalone — no manual setup required.
Multi-Inventory: Auto-detects ox_inventory, qb-inventory, qs-inventory, tgiann-inventory, or falls back to framework-native systems.
Multiple Phone Items: Supports multiple phone item names (phone, black_phone, red_phone, etc.).

⚡ Performance & Security

Server-Authoritative Logic: All critical systems run server-side — distance checks, cooldowns, safe zones, inventory, and success rolls.
Optimised Codebase: Localised natives, cached constants, adaptive sleep timers, and early-out checks.
Minimal Performance Impact: Idle threads sleep at 500ms; active threads only run when necessary.
Built-In Rate Limiting: Prevents event exploitation and abuse.

🌐 Fully Configurable

Single Config File: Everything controlled through one clean, easy-to-read config.lua.
Customisable Strings: Every player-facing message can be edited for translation or branding.
Configurable Animations: Modify arm and snatch animation dictionaries, clips, and flags.
Configurable Safe Zones: Easily add, remove, or adjust zone coordinates and radii.

Transform your server’s criminal roleplay

Introduce a phone snatching mechanic that feels authentic, skill-driven, and fully protected against abuse. Whether players are sprinting through the streets or riding pillion on a motorbike, every snatch becomes a high-stakes, heart-pounding encounter for both the robber and the victim.

Perfect for serious roleplay servers looking to elevate realistic street crime.