Installation

Overview

vrs_newspaper is a newspaper delivery job. Players clock in at the depot, pick a district, ride a bike out, and throw papers at ten houses. Pays on completion, with tips, bonuses, and cooldowns.

Framework support

Fully supports QBox, QBCore, and ESX via vrs_bridge.

Auto-detected systems

Inventory, target script, and vehicle keys are all detected automatically by vrs_bridge.

Persistent cooldowns

Cooldowns are stored against the character in MySQL, so relogs and restarts do not clear them.

Open configuration

Every file in config/ ships open, no escrow, so routes, pay, and throwing feel are yours to edit.

Prerequisites

Requirement	Details
Game build	2802 or newer (for `WEAPON_ACIDPACKAGE`)
`vrs_bridge`	v1.3.0 or newer. Must start before this resource.
`ox_lib`	Points, keybinds, dialogs
`oxmysql`	Stats and cooldown persistence
A target script	Optional. `ox_target` or `qb-target` if present

Framework, inventory, target, and vehicle-key system are all detected automatically by vrs_bridge, see its config.lua to pin anything by hand.

Installation steps

Resource deployment

Drop vrs_bridge and vrs_newspaper into your resources folder.

GTA has no newspaper weapon, so this is an alias onto a real throwable. For ox_inventory it goes in data/weapons.lua, not items.lua:

data/weapons.lua

['WEAPON_NEWSPAPER'] = {
    label = 'Newspaper',
    weight = 50,
    throwable = true,
    model = 'WEAPON_ACIDPACKAGE',
    client = { image = 'WEAPON_NEWSPAPER.png' },
},

Drop a WEAPON_NEWSPAPER.png into ox_inventory/web/images/ for the icon.

Update server.cfg

Add each resource individually, bridge first:

server.cfg

ensure oxmysql
ensure ox_lib
ensure vrs_bridge
ensure vrs_newspaper

Critical load order: name resources individually, not ensure [folder], a folder-wide ensure starts in arbitrary order. vrs_bridge has to come after oxmysql and before vrs_newspaper.

Verify and boot

Boot the server. The database tables create themselves, sql/install.sql is there if you prefer to provision by hand.With Config.Debug = true in vrs_bridge, the console prints what it detected:

[vrs_bridge:SERVER] exports registered, framework = qbox

Optional: lock it behind a job

Set Config.Job.require = true in config.lua, then add the job to your framework:

QBox / QBCore
ESX

Add to shared/jobs.lua:

shared/jobs.lua

['newspaper'] = {
    label = 'Newspaper',
    defaultDuty = true,
    grades = {
        [0] = { name = 'Carrier', payment = 50 },
    },
},

Insert directly into the database:

INSERT INTO `jobs` (name, label) VALUES ('newspaper', 'Newspaper');
INSERT INTO `job_grades` (job_name, grade, name, label, salary, skin_male, skin_female)
VALUES ('newspaper', 0, 'carrier', 'Carrier', 50, '{}', '{}');

Reference

Configuration files

File	Contents
`config.lua`	Job gating, round size, pay, cooldowns, papers, HUD
`routes.lua`	The depot and the three districts’ house pools
`throwing.lua`	The bag, the paper item, hit radius, markers, aim prediction
`vehicles.lua`	The delivery bike and its paint
`interactions.lua`	Depot ped, target zone, blips

Key settings (`config.lua`)

Setting	Default	Effect
`Config.Pay.perRoute`	`150`	Base for a full round, split across the houses
`Config.Pay.payPerHouse`	`false`	`true` pays each house on the spot instead of at the end
`Config.Route.handInAtDepot`	`true`	`false` pays the instant the last paper lands
`Config.Cooldowns.enabled`	`false`	Master switch for every cooldown
`Config.Throw.hitRadius`	`5.0`	3.0 is a real skill test, 8.0 is forgiving
`Config.HUD.position`	`middle-right`	Nine anchors; text alignment follows

Admin commands

Command	Description
`/npbuilder [action] [district]`	Route builder
`/npreset <id>`	Clear a player’s cooldowns and active round
`/npstats <id>`	Show a player’s record

Gated behind Config.Misc.adminPermission, group.admin by default.

Troubleshooting

"The depot has no papers to give out"

WEAPON_NEWSPAPER is not registered. Add it to data/weapons.lua and restart ox_inventory. New items usually need a full server restart.

The weapon vanishes from your hands

Something else is stripping it. This job never force-equips; another resource is managing weapons.

Every throw costs two papers

Config.Papers.inventoryConsumes is false on an inventory that consumes throwables itself. Set it back to true.

Markers float or sit underground

groundSnap is off for that district. Set groundSnap = true on that district in routes.lua.

vrs_bridge errors on boot

It needs oxmysql started before it for the cooldown store. Check the ordering in server.cfg.

Cooldowns never expire, or never apply

vrs_bridge is older than v1.3.0. Earlier versions have no cooldown system at all, update it.

Permanent ID

Newspaper Job

Overview

Framework support

Auto-detected systems

Persistent cooldowns

Open configuration

Prerequisites

Installation steps

Optional: lock it behind a job

Reference

Configuration files

Key settings (`config.lua`)

Admin commands

Troubleshooting

​Overview

Framework support

Auto-detected systems

Persistent cooldowns

Open configuration

​Prerequisites

​Installation steps

​Optional: lock it behind a job

​Reference

​Configuration files

​Key settings (config.lua)

​Admin commands

​Troubleshooting

Overview

Prerequisites

Installation steps

Optional: lock it behind a job

Reference

Configuration files

Key settings (`config.lua`)

Admin commands

Troubleshooting