Gameplay
How does a round work?
How does a round work?
Clock in at the depot, pick a district (districts on cooldown are shown but greyed out), and a bike spawns with a duffle bag on your back. The round’s papers land in your inventory, one per house plus spares. Throw at the houses in any order, each marker clears as it lands, then ride back to the depot to hand the round in and get paid.
Can I change how and when players get paid?
Can I change how and when players get paid?
Yes.
Config.Pay.perRoute sets the base pay for a full round, split across the houses. Config.Pay.payPerHouse pays each house on the spot instead of at the end, and Config.Route.handInAtDepot controls whether pay lands the instant the last paper is thrown or only after riding back to the depot.Do cooldowns survive a restart?
Do cooldowns survive a restart?
Yes. Cooldowns are stored against the character in MySQL, so relogs and server restarts do not clear them.
Config.Cooldowns.enabled is the master switch, off by default.Setup and configuration
Which frameworks are supported?
Which frameworks are supported?
QBox, QBCore, and ESX, via vrs_bridge. The bridge auto-detects the running framework, inventory, target script, and vehicle-key system, so no per-framework configuration is required.
Do I need to import an SQL file?
Do I need to import an SQL file?
No. Database tables are created automatically on first run.
sql/install.sql is there if you prefer to provision by hand.Can I add my own districts or delivery points?
Can I add my own districts or delivery points?
Yes, either by editing
routes.lua directly or by recording points live in-game with /npbuilder, see Integrations for the commands and export flow. Street names are optional, leave label out and it is read from the world at runtime.Can I lock the job behind a framework job?
Can I lock the job behind a framework job?
Yes. Set
Config.Job.require = true in config.lua, then add a newspaper job to your framework (QBox/QBCore shared/jobs.lua, or the jobs/job_grades tables for ESX). See Installation.Troubleshooting
Why does the depot say it has no papers to give out?
Why does the depot say it has no papers to give out?
WEAPON_NEWSPAPER is not registered with your inventory. Add it to data/weapons.lua (not items.lua) and restart the inventory resource, new items are usually cached at boot.Why does every throw cost two papers?
Why does every throw cost two papers?
Config.Papers.inventoryConsumes is set to false on an inventory that already consumes throwables itself, causing a double deduction. Set it back to true.Markers are floating or sitting underground, how do I fix that?
Markers are floating or sitting underground, how do I fix that?
Set
groundSnap = true on that district in routes.lua. Points recorded with the builder on the ground already default to this.The resource won't start, what now?
The resource won't start, what now?
Check the server console for the specific message. The most common causes are:
vrs_bridgeis not started, or is older than v1.3.0 (needed for the cooldown system).oxmysqlis not started or cannot connect.ox_libis missing.
server.cfg: