Oxide GoPostal

Postal delivery job system for FiveM servers.

Oxide GoPostal documents the current oxide-postaljob GoPostal delivery resource for FiveM servers. Players clock in at depot supervisors, load packages or letters into a delivery van, complete timed routes across the map, and build long-term progression through a unified job system powered by o-link.

Key Features

  • o-link Integration - Uses o-link for targeting, menus, phone messaging, money, fuel, clothing, and vehicle keys
  • Dual Task Types - Run package routes from pallets or letter routes from post boxes to residential letterboxes
  • Route Intelligence - Uses spread-aware zone selection and route ordering to create level-appropriate delivery loops
  • Unified Progression - Stores postal progression in the shared job_progression table with job = 'postal'
  • Crew Co-op - Supports 2-player crews with shared tasks, shared van access, and co-op bonuses
  • Detailed Payouts - Applies delivery earnings, damage charges, early finish penalties, gas fees, and taxes
  • Tutorial System - Includes first-run tutorial prompts plus /postaltutorials and /postaltutorialreset
  • Bystander Pallets - Shows visual-only synchronized pallets to nearby non-shift players
  • Builder Tools - Includes /postalbuilder for depot setup, prop scanning, export, and editing
  • Flexible UI Modes - Supports a cinematic NUI flow or a lighter olink.menu mode

Requirements

ResourcePurpose
ox_libLocale, callbacks, timers, and shared UI helpers
oxmysqlDatabase connectivity for progression storage
o-linkFramework and gameplay abstraction used by the resource

Quick Start

  1. Place oxide-postaljob in your server's resources directory.
  2. Start ox_lib, oxmysql, o-link, and oxide-postaljob in that order.
  3. Run sql/install.sql against your database to create the unified progression table.
  4. Review shared/config.lua and the files in shared/config/.
  5. Restart the server, visit a GoPostal depot, and complete a test route.

See the Installation Guide for the full setup flow.