SW_IllegalCourier – Advanced Courier Job System

SW_IllegalCourier – Advanced Courier Job System

SW_IllegalCourier is a comprehensive and engaging courier job system designed for ESX-based FiveM servers. It provides a dynamic and immersive experience for players and staff alike, featuring deep progression mechanics, team-based missions, a custom police dispatch system, and a polished user interface. The script is optimized for performance and modularity, utilizing ox_lib, ox_target, and ox_inventory. It includes a well-organized configuration file, detailed documentation, and comprehensive support.

Features

• Package System: Offers three unique package types: Documents (low risk, low reward), Drugs (medium risk/reward), and Weapons (high risk/reward).
• Weighted Random Selection: Each package type has a configurable probability of being offered.
• Dynamic Pricing: Rewards adjust in real-time based on supply and demand (delivery frequency over the last 10 minutes).
• Interactive Selection Menu: Players can interact with an intuitive menu that displays real-time pricing and requires a confirmation step.
• Progression & Leveling: Players earn experience points (XP) for successful deliveries.
• Level-Up Rewards: Each level gained increases the payout multiplier (configurable).
• Persistent MySQL Storage: Player levels and XP are saved and restored across server restarts.
• Progression Menu: Players can view their current level, XP, and reward bonus directly via an in-game NPC.
• Team Missions: Supports team commands such as /createteam, /invite [ID], and /leaveteam.
• Team Deliveries: Teams of up to 4 players can collaborate to multiply total packages, with each member completing their deliveries. Rewards are distributed upon completion by all members.
• Custom Police Dispatch: An independent dispatch system integrated with ESX job/duty status.
• Automatic Police Detection: Automatically detects on-duty police officers, with manual fallback commands for duty status.
• Alert Notifications: Sends alert notifications with titles, messages, GPS waypoints, and temporary blips on the map.
• Dispatch Chance: The probability of police dispatch is influenced by package risk and location zone.
• Anti-Cheat & Security: Includes rate limiting, teleport detection, duplicate delivery prevention, distance checks, and time-based protection.
• Inventory Validation: Verifies that players possess the required package item.
• Immersive Experience: Features cinematic camera animations, sound effects, random NPC dialogues, and automatic GPS guidance.

Installation

1. Ensure you have ox_lib, ox_target, and ox_inventory installed and configured on your server.
2. Place the SW_IllegalCourier resource folder into your server's resources directory.
3. Configure the config.lua file according to your server's needs.
4. Add ensure SW_IllegalCourier to your server.cfg file.
5. Restart your FiveM server.