Lookout System – Illegal RP Scout / Spotter Script

🚨 Advanced FiveM illegal RP scout system with lookout NPC placement, police vehicle detection, immersive sound alerts, configurable limits and full administrative traceability.

Lookout System adds a tactical layer to illegal roleplay by allowing players to place sentinels that monitor the area and warn nearby criminals when law enforcement vehicles are detected.

🌐 Description

Lookout System is a FiveM scout / spotter script designed for illegal RP scenes such as drug dealing, robberies, stash protection or criminal zone surveillance.

Players can deploy a realistic lookout NPC who sits on a camping chair, smokes and watches the surroundings. When configured police vehicles pass nearby, the system triggers an immersive sound alert to warn players in the area.

This creates a more strategic and believable gameplay loop for criminal organizations without relying on unrealistic instant information systems.

✨ Main Features

🎮 Immersive Lookout Gameplay

• Realistic scout NPC placed in the world
• Camping chair setup with idle animation
• Smoking / lookout behavior for better immersion
• Perfect for illegal surveillance scenes

🚔 Smart Police Detection

• Automatically detects configured police vehicles
• Customizable detection radius
• Built to support tactical criminal gameplay
• Can be adapted to your own emergency vehicle list

🔊 Audio Alert System

• Sound warning triggered on detection
• Distance-based attenuation for realism
• Configurable alert radius and volume
• Creates real tension during illegal activities

📞 Placement Animation

• Player places the scout through an immersive phone-call style setup
• Styled progress bar included
• Clean feedback for successful deployment

⚙️ Balanced System Logic

• Configurable black money cost
• Lookout expires automatically after configured duration
• Maximum of 1 active scout per player
• Maximum of 5 scouts on the server per 24-hour period
• Automatic cleanup after expiration

📊 Administration & Logs

• Detailed Discord logs
• Scout placement tracking
• Alert trigger tracking with detected vehicle info
• Expiration and removal logs
• Admin command: /guetteur_stats

🎨 Interface & UX

• Glassmorphism-style progress bar
• Integrated ESX notifications
• Optional map blip support
• Built to remain simple and effective in action

🎯 Ideal Use Cases

• Drug dealing protection
• Robbery perimeter monitoring
• Illegal property surveillance
• Criminal stash and lab protection
• Tactical roleplay for gangs and organizations

⚙️ Configuration

Everything can be configured through config.lua:

• Cost and duration
• Detection radius
• Alert sound and volume
• Police vehicle list
• NPC and chair models
• Notification messages
• Discord webhooks

🔧 Compatibility

• ESX
• ox_lib compatible (optional)
• Recent FiveM artifacts
• French and international RP servers

⚡ Performance

• Optimized for very low idle usage
• Asynchronous entity handling
• Automatic memory cleanup
• Built for live multiplayer environments

📦 Included

• client/main.lua
• server/main.lua
• config.lua
• html/ modern UI files
• sounds/ alert sound included
• Complete installation documentation

🚀 Installation

1. Place spex_guetteur inside your resources folder
2. Configure your Discord webhook and settings in config.lua
3. Add ensure spex_guetteur to your server.cfg
4. Restart your server

🔐 Security

• Server-side checks included
• Anti-spam protections
• Strict usage limits to reduce abuse
• Full Discord traceability

🧑‍💻 Development

Developed by speXtrum Development
From code to roleplay.

🌐 Discord: discord.gg/spex