Modul Hot Routes

he contraband run your criminals actually remember. Modul Hot Routes is a complete illegal-delivery system — timed multi-pickup routes for drugs, weapons and mixed cargo, wrapped in a polished Modul dashboard with progression, leaderboards, ambushes and hardened server-side validation — built to drop into any Qbox, QBCore, ESX or standalone server.

Qbox QBCore ESX Standalone ox_inventory qb-inventory qs-inventory ox_target qb-target TextUI (no target)

Routes that play differently every time

• Three route types — narcotics, weapons and mixed contraband, each with its own difficulty tier, timer, cooldown, payout range, XP reward and police pressure
• Randomized pickup chains — every run draws a random, non-repeating subset from a configurable location pool, then a random final dropoff (multiple dropoffs per route supported)
• Ped or zone dropoffs — hand off to a buyer NPC or stash the goods in a plain interaction zone
• Fully data-driven: add, remove or rebalance routes and pickup pools in one file — no code changes
• Optional vehicle requirement, required carry items, minimum police online, grace windows and hard timeouts per route

The Modul dashboard

No input dialogs, no bland context menus. Players open a dark graphite Modul tablet with route cards showing risk and difficulty badges, estimated payouts and live cooldown timers, an active-route panel that counts down the clean-delivery window, a per-character run history and an all-time / weekly leaderboard. The accent gradient, corner radius and density are set from the config, so the UI matches your server's brand in seconds. An ox_lib menu fallback keeps players moving even if the NUI is unavailable.

Progression & trust

• XP levels gate the higher route tiers — thresholds fully configurable
• Trust — a hidden reliability score that silently scales payouts: clean deliveries raise it and earn bonuses, while late runs, failures, cancellations and opened packages lower it and bite into pay
• Leaderboards — all-time and rolling weekly scopes, with earnings, per-type route counts, fastest run and best payout (weekly buckets roll over automatically)
• Run history per player, pruned to a configurable limit

Risk that keeps the street honest

• Hostile ambushes — per-route chance, count and weapon; armed NPCs jump the runner mid-route
• Bonus packages — surprise extra product rolled server-side on random pickups
• Sealed packages are real items — the delivery box lives in the player's inventory and can be opened for item rewards instead of delivered… at the cost of a trust hit, a police alert chance and a forfeited run
• Clean-delivery bonus and configurable late penalty reward punctuality

Police pressure built in

Chance-based "suspicious package" alerts fire per route and per context — pickup, final drop, failed run, opened package, or a "weapons courier spotted" ping at the very start of a gun run. Ships with bridges for lb-tablet, ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch and core_dispatch, a dependency-free built-in fallback that notifies on-duty police with a temporary blip, and one normalized event for your own dispatch. A built-in admin test command fires an alert on demand so you can verify the integration before you go live.

Leave a trail (optional)

An optional evidence bridge drops investigable traces — drug residue, torn packaging, partial glove prints, gun-oil residue — at pickups, dropoffs, failed runs and opened packages, with chances tuned per route type and context. Wire it to snipe-evidence or your own evidence resource, or leave it off entirely.

Pay how your city pays

• Payouts to cash or bank, ESX black_money, or a custom economy hook for standalone
• Global payout and XP multipliers tune the whole economy without touching a single route
• Sealed packages and open-box rewards work with ox_inventory, qb-inventory and qs-inventory — or run item-less in standalone

Requirements: ox_lib and oxmysql. Framework, inventory, target, notify and dispatch resources are all auto-detected — nothing else is mandatory. No target resource? A built-in TextUI fallback works out of the box.

Installation: Import the included install.sql, add the sealed-package items to your inventory, drop into resources and ensure modul-hotroutes. Full README, install guide and a complete config reference are included.