ROBBERY SYSTEM

https://youtu.be/__RTH0m5mbI

🏪 Market Robbery System with Modern UI Give your players an immersive robbery experience across 21 unique store locations. Each robbery features real-time progress tracking, police notifications, and a professional UI interface. Rewards are dynamically calculated per location, and the entire system is protected against exploits with server-side validation.

🎮 Complete Robbery Experience No complex setup required. Players interact with marked locations, start robberies through a sleek UI, and must stay within range for the duration:

• 21 pre-configured robbery locations across the map
• Real-time progress bar showing elapsed time
• Visual distance marker showing safe zone
• Dynamic reward calculation (min/max per store)
• Automatic police alerts with map blips
• Street name display in all notifications

🎨 Modern NUI Interface All robbery actions are controlled through a polished UI:

• Live countdown timer with progress visualization
• Potential loot range display before starting
• "Start Robbery" button to begin the heist
• "Withdraw Money" button when completed
• Real-time status updates (active/complete)
• Fully responsive design

Settings are managed in config.lua with no file editing needed during gameplay. All configurations load automatically on server start.

🚨 Advanced Police Notification System When a robbery starts, the entire police force is alerted:

• Instant notification with street name & location
• Red map blip at robbery location (60 second duration)
• Cancellation alerts when robberies are abandoned
• Configurable police job names
• Minimum police requirement system

Police receive separate notifications for robbery start, completion, and cancellation - keeping them informed throughout the entire event.

⚙️ Flexible Requirement System Fine-tune difficulty with optional requirements:

• Item System: Require lockpicks or custom items
• Weapon System: Require equipped weapons (pistols, SMGs, etc.)
• Multiple Options: Players need ONE item from your list
• Remove on Use: Optional item consumption when starting
• Server-Side Validation: All checks happen server-side

Perfect for balancing difficulty and creating progression systems where advanced items unlock robbery access.

📊 Discord Webhook Logging Complete audit trail of all robbery activities:

• Robbery Started (Yellow) - Player name, identifier, location, coordinates, timestamp
• Robbery Completed (Green) - All above + exact amount stolen
• Robbery Cancelled (Red) - All above + cancellation reason (disconnect/distance)

Webhooks are fully customizable with:

• Custom bot name & avatar
• Configurable embed colors (hex to decimal)
• Custom footer text & icon
• Detailed field labels per locale

🎯 Smart Cooldown & Limit System Prevent abuse with built-in protection:

• Store Cooldown: Configurable delay before same store can be robbed again (default 10 minutes)
• Simultaneous Limit: Control max active robberies server-wide (default 3)
• Police Requirement: Set minimum online police officers needed
• Distance Checking: Auto-cancel if player moves too far (default 15m)

All limits are configurable in seconds for precise control. Cooldowns are tracked per location, not globally.

🛡️ Exploit-Safe Architecture All validation runs server-side with multiple protection layers:

• Reward amounts calculated server-side only
• Client cannot modify values via NUI DevTools
• Distance validation on every server tick
• Active robbery tracking prevents duplication
• Player verification on all requests
• Item/weapon checks server-side before starting
• Automatic cleanup on disconnect

🌍 Multi-Language Support Built-in translations for 6 languages:

• English (en)
• German (de)
• Polish (pl)
• French (fr)
• Portuguese (pt)
• Spanish (es)

Add custom languages easily via locales.lua. All UI text, notifications, and webhook messages support localization.

🎨 Fully Customizable Visuals Every visual element is configurable:

• Map Blips: Custom sprite, color, scale & name
• 3D Markers: Type (cylinder/sphere/circle), color (RGBA), size
• Radius Marker: Shows safe zone during robbery (yellow circle)
• NPC System: Optional NPCs at locations (any ped model)
• Prop System: Optional props/objects at locations

Configure interaction distance, marker visibility range, and max distance separately for perfect balance.

🔧 Plug & Play Integration

• Works with ESX, QBCore & Qbox (automatic framework detection)
• Custom notification support (e.g. risk-notify) or framework defaults
• Configurable reward types: cash, black_money, or items
• Item-based rewards for custom economies
• Compatible with all inventory systems

Framework is detected automatically on resource start. No manual configuration needed unless using custom exports.

💰 Dynamic Reward Balancing Each location has independent reward ranges:

• City stores: Lower risk, lower reward (e.g., $2,500 - $11,000)
• Suburban stores: Medium risk, medium reward (e.g., $5,000 - $15,000)
• Remote stores: High risk, high reward (e.g., $10,000 - $30,000)

Rewards are randomized between min/max on completion. Configure 21 locations or add unlimited custom ones with simple coordinate addition.

📍 Easy Location Management Adding new robbery locations takes seconds:

{
    coords = vector4(x, y, z, heading),
    rewards = {min = 5000, max = 15000}
}

No complex setup. Just coordinates and reward range. The system handles everything else automatically.

🎮 Player-Friendly Workflow

1. Player arrives at yellow map blip
2. Red 3D marker appears when close
3. Press E to check requirements
4. UI opens showing potential loot
5. Click "Start Robbery" in UI
6. Stay within yellow radius for duration (default 15 min)
7. Press E anytime to check progress
8. Timer completes, reward shown
9. Click "Withdraw Money" to collect
10. Store enters cooldown

Clear visual feedback at every step. Players always know their status, time remaining, and boundaries.

Designed for servers that want a professional robbery system with modern UI, complete logging, and zero exploit risk.