Note: This documentation covers all configuration options available to server owners. The script automatically detects your framework (ESX, QBCore, QBox) and requires no manual setup.
1) Overview
Risk Market Robbery is a dynamic store robbery system for FiveM servers featuring:
🏪 21 pre-configured robbery locations across the map
⏱️ Time-based robbery mechanics with progress tracking
👮 Police notification system with GPS alerts
💰 Configurable reward system (cash, black money, or items)
🔒 Item/weapon requirements for robberies
🌍 Multi-language support (6 languages included)
📊 Discord webhook integration
🎨 Fully customizable UI themes
2) Basic Configuration
Framework Detection
Config.Framework =nil
Leave as nil — The script automatically detects ESX, QBCore, or QBox
Language Selection
Available languages:'de', 'en', 'pl', 'fr', 'pt', 'es'
Notification System
To use default notifications:
To integrate other notification systems:
3) Robbery Settings
Core Mechanics
Configuration details:
RobTime: Duration in seconds (900 = 15 minutes)
MinPolice: Minimum police officers required to start robbery
PoliceJobs: Job names that count as police
Cooldown: Time before store can be robbed again (600 = 10 minutes)
Time conversion reference:
Reward System
RewardType options:
'cash' — Gives cash money
'black_money' — Gives black/dirty money
'item' — Gives item (specify in Config.RewardItem)
Global Limits
MaxSimultaneousRobberies: Maximum concurrent robberies server-wide
UseStreetNames: Display street names in notifications and webhooks
Distance Settings
InteractionKey: Key to interact (38 = E) — Key Codes
InteractionDistance: Distance to show "Press E" prompt
MarkerDistance: Distance to render 3D markers
MaxDistance: Maximum distance before robbery auto-cancels
4) Requirements System
Item Requirements
How it works:
RequireItem: Player must have one of the listed items
RemoveItemOnUse: Remove item when starting robbery
RemoveItemAmount: How many items to remove
Example configurations:
No requirements:
Require lockpick (consumed):
Require lockpick (not consumed):
Multiple accepted items:
Weapon Requirements
How it works:
Player must have one of the listed weapons equipped (in hand)
✅ Balance robbery time with police count — Longer robberies need more police
✅ Test different reward ranges — Adjust based on your economy
✅ Use cooldowns on high-reward locations — Prevent farming
✅ Consider item consumption — Makes robberies more costly
✅ Place NPCs/props carefully — Avoid traffic or busy areas
✅ Test police alerts — Verify GPS blips appear correctly
✅ Use street names — Helps police respond faster
✅ Customize for server type — RP vs PvP need different settings
✅ Monitor Discord webhooks — Track patterns and adjust
✅ Regular config reviews — Update based on player feedback
Config.UseBlips = true
Config.BlipSettings = {
sprite = 849,
color = 1,
scale = 0.5,
name = 'Market Robbery'
}
sprite = 52 -- Convenience store
sprite = 156 -- Skull (danger)
sprite = 161 -- Police alert
sprite = 487 -- Dollar sign
sprite = 849 -- Store robbery
Config.UseMarker = true
Config.MarkerType = 1
Config.MarkerColor = {r = 255, g = 0, b = 0, a = 100}
Config.MarkerSize = {x = 1.0, y = 1.0, z = 1.0}
-- Red
Config.MarkerColor = {r = 255, g = 0, b = 0, a = 100}
-- Yellow
Config.MarkerColor = {r = 255, g = 255, b = 0, a = 100}
-- Green
Config.MarkerColor = {r = 0, g = 255, b = 0, a = 100}
-- Blue
Config.MarkerColor = {r = 0, g = 0, b = 255, a = 100}
Config.ShowRobberyRadiusMarker = true
Config.RadiusMarkerType = 1
Config.RadiusMarkerColor = {r = 255, g = 255, b = 0, a = 170}
