Overview

A fully-featured GoPostal delivery gig job where players clock in at a depot, load packages onto pallets or collect mail bags from post boxes, then drive a company van to deliver to customers or letterboxes across the city. The job features a 5-tier progression system that unlocks larger delivery batches, better pay multipliers, and higher tip chances as players level up. Two task types — package deliveries with customer handoff animations and letter rounds with letterbox drops — keep shifts varied and engaging. Players can team up in 2-person crews for shared deliveries with a co-op pay bonus, while a complaint system temporarily suspends players who repeatedly destroy vehicles or die on shift.

Features

• Dual Task Types — Each batch randomly assigns package deliveries (pallet loading, customer handoff with reaction animations) or letter rounds (post box collection and letterbox drops), keeping shifts fresh across sessions.
• Progression & Leveling — 5 tiers (Trainee to Head Postman) with increasing pay multipliers, tip chances, batch sizes, and tighter route clustering. Progress is persistent and earned through cumulative delivery completions.
• Route Intelligence — Spread-aware zone selection gives low-level players exploratory routes across the map, while high-level players receive tightly clustered routes for efficient grinding. Greedy nearest-neighbor sorting ensures logical driving loops with minimal backtracking.
• Crew Co-op — Two players can team up on the same shift with a shared van, synchronized loading and delivery, and a 15% co-op pay bonus. Crews can form mid-shift to add extra deliveries, and leadership transfers gracefully if one member drops out.
• Detailed Pay Breakdown — Base pay plus distance bonus, on-time speed bonus, level multiplier, daily streak bonus (up to 7 days), and random tips. Deductions for early clock-out, vehicle damage, and van destruction keep the economy grounded. A full end-of-shift summary displays the complete breakdown.
• Customer Reactions — NPCs spawn at delivery points and react to timeliness — accepting packages with a thank-you animation when on time, or showing frustration when deliveries are late.
• Bystander Immersion — Non-shift players see visual-only pallets at depots while others are loading, with real-time box count updates synchronized via statebags.
• Uniform System — Toggle a GoPostal uniform on or off through the supervisor menu, with separate male and female outfit configurations.
• Location Builder — Built-in admin tool (/postalbuilder) for creating new depots, delivery zones, letterbox scans, and post box placements — no code editing required.
• Anti-Abuse System — Complaint tracking with automatic 30-minute timeouts after 3 strikes (vehicle destruction or dying on shift). Complaints decay through successful deliveries, keeping the system fair without permanent punishment.

Technical

• Framework: Framework Agnostic
• Dependencies: community_bridge, ox_lib, oxmysql
• Database: Single progression table storing level, total deliveries, daily streaks, complaints, and timeout state
• Frontend: Vue 3 + Vite + Tailwind CSS (delivery HUD, shift menu, crew view, end-of-shift summary)
• Menu Style: Configurable between full NUI cinematic menu or lightweight Bridge.Menu context menu

Oxide Postal Job by Oxide Studios

~12,100 lines of code