VNS Newspaper Job
A newspaper delivery job for FiveM. Players talk to a start ped, rent a delivery vehicle, get a stack of newspapers and a randomly picked route, then throw papers at the marked drop points around the city. Returning the vehicle finishes the job and settles the payment.
Framework, inventory, target and notification compatibility comes from vns-core, a separate free download:
- Frameworks: QBCore, QBox, ESX
- Inventories: ox_inventory, qb-inventory, qs-inventory, origen_inventory, codem-inventory, tgiann-inventory, core_inventory, ESX's built-in inventory
- Targeting: ox_target, qb-target, qtarget
- Requires vns-core and ox_lib
Feature overview
- Start peds - one or more configurable job peds with map blips. Players use the target system on the ped to start and finish working.
- Vehicle rental - each start location spawns its own configured vehicle (a BMX by default). With pay-on-return enabled, a rental fee is taken from the player's bank as a deposit and refunded when they finish the job.
- Routes - every start ped has its own pool of routes; the script picks one at random when the player starts. Each route is a list of drop coordinates with its own min/max payment per drop.
- Throw deliveries - players receive newspaper items (two per drop point) and physically throw them at the drop markers. A drop counts as delivered when a thrown paper lands within 3m of the drop point.
- Two payment modes - pay in cash after every single delivery, or pay the whole sum in cash when the vehicle is returned (
Config.PayOnReturn). - Bonus item - finishing the job with every drop on the route delivered gives a configurable chance (out of 1000) to receive a bonus item.
- Job restriction - optionally lock the job to a specific framework job (
Config.RequireJob). - Route resume - if a player disconnects mid-route and comes back within 150m of where the vehicle was, the vehicle is respawned and the route continues with the deliveries they already made.
- Vehicle hook -
Bridge.OnJobVehicleSpawnedinclient/client_open.luaruns whenever the work vehicle is created, for vehicle keys or fuel scripts.
How a shift works
- The player targets the start ped and picks Start Newspaper Job.
- The rental fee is charged (pay-on-return mode only), the newspapers are added to their inventory and the vehicle spawns with a full tank.
- Every drop point of the chosen route gets a map blip; a green marker is drawn when the player is within 25m.
- The player throws a newspaper at the marker. The drop is ticked off and, in per-delivery mode, paid out immediately.
- Back at the start ped, with the assigned vehicle (driving it or parked within 10m), Finish Newspaper Job deletes the vehicle, pays out (pay-on-return mode), refunds the rental fee, removes leftover newspapers and rolls the bonus item if all drops were delivered.
Players do not have to complete every drop. Finishing early pays only the completed deliveries; the bonus item roll requires a full route.
Open vs Encrypted
config.lua and the open bridge files (client/client_open.lua, server/server_open.lua) stay editable in the encrypted version. Routes, payments and language live in config.lua; the bridge files contain the calls to vns-core and the vehicle hook. The open version is fully editable. See Open Source & Encrypted Versions.