Oxide Newspaper

Overview

oxide-newspaperjob is a newspaper delivery gig job where players clock in at a depot, grab a route, spawn a company BMX, and throw newspapers at marked house targets across the neighborhood.

The default package ships with:

• 2 depots
• 80 delivery zones
• 5 progression levels
• 9 tutorial cards
• 1 in-game builder workflow

Players earn persistent progression, daily streak bonuses, route-completion speed bonuses, and random tips while a complaint system handles shift abuse such as bike loss, death on shift, and running out of newspapers mid-route.

Technical

o-link modules used

• character
• notify
• phone
• money
• clothing
• vehiclekey
• target
• menu
• progressbar
• inventory
• logger
• framework lifecycle events

Database

The resource uses the unified job_progression table and stores newspaper entries with job = 'newspaper'. Settings live in the shared oxide_settings table, and pay owed to a player who left mid-shift waits in the shared job_pending_payouts table until their next login. The resource creates both of those on its own the first time it starts.

Frontend

The packaged UI is Vue 3 + Vite + Tailwind CSS and powers:

• the shift menu
• the in-job route HUD
• ammo and progress display
• shift summary screens
• tutorial overlays
• waypoint overlays

Menu Modes

• Config.menuStyle = 'nui': full Vue menu with cinematic camera and progression card
• Config.menuStyle = 'menu': lightweight olink.menu flow

Summary Modes

• Config.shiftSummary = 'nui': popup summary on clock-out
• Config.shiftSummary = 'text': notification summary on clock-out

If Config.usePhone = true, players get phone messages for shift events and a detailed pay stub at clock-out: a text on phones that support texts, mail on the others. Texts need o-link 1.11.0 or newer; an older o-link sends mail. Supported phones: qb-phone, lb-phone, gksphone, okokPhone, qs-smartphone, qs-smartphone-pro, yseries, and Oxide Phone.

On Oxide Phone, the Gigs app shows the depots and whether each has room, the player's current route, and their level, and shift updates arrive there as Gigs notifications instead of texts. The pay stub always arrives as a text or mail.

Features

• Route-based delivery flow: Players receive a generated house route, ride a BMX to each stop, and throw newspapers at marked house targets in order.
• Throwable delivery mechanic: Each route gives a limited weapon_newspaper supply, plus spare papers that let players recover from misses.
• Progression and leveling: Five tiers increase route size, tip chance, pay multiplier, and spare paper supply while tightening the allowed hit radius.
• Route timer system: Completing the route under time awards a speed bonus, while late completion applies a route-wide penalty.
• Detailed pay breakdown: Base pay, distance bonus, streak bonus, tips, speed bonus, and taxes feed the final shift payout.
• Bike loss handling: Losing or abandoning the BMX triggers a cash fine, adds a complaint, clears the active route, and forces the player back to depot flow.
• Uniform support: The uniform flow exists and is wired through o-link.clothing, but it is disabled by default in config.
• Builder tooling: /newspaperbuilder opens a full menu-driven depot builder with export and config import support.
• Tutorials: Nine first-time prompts teach route pickup, throwing, misses, ammo management, late routes, and leveling.

---

Documentation for setup and operation lives in Installation, Configuration, Features, Admin, API Reference, and Troubleshooting.

Documentation