Oxide Newspaper

BMX paper-route delivery job for FiveM servers.

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 prompts
  • 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

DependencyRequiredPurpose
o-linkYesFramework and system abstraction layer used by the resource
ox_libYesLocale, callbacks, timers, context/input UI, and utility functions
oxmysqlYesDatabase access for progression data
  • 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'.

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
  • 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, the resource sends service emails for shift events and the detailed clock-out breakdown through o-link.phone.

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, and Troubleshooting.

Documentation