Oxide GoPostal

Oxide GoPostal is a comprehensive postal delivery gig job system for FiveM servers. Players clock in at GoPostal depot locations, pick up packages from pallets or collect mail bags from post boxes, and deliver them across the map — all with a full progression system, crew co-op, and detailed payment breakdowns.

Key Features

• Shift System — Clock in/out at depot supervisor NPCs with slot-based capacity and state machine flow
• Dual Task Types — Package delivery (pallet loading, doorstep handoff) and letter delivery (post box collection, letterbox drop-off)
• Route Intelligence — Spread-aware zone selection and nearest-neighbor route ordering for level-appropriate routes
• 5-Level Progression — Trainee to Head Postman with increasing pay, tip chance, batch sizes, and route clustering
• Crew Co-op — 2-player crews with shared vehicle, deliveries, and 15% bonus pay
• Payment System — Base pay, distance bonus, speed bonus, tier multipliers, streaks, tips, and itemized deductions
• Complaint System — Tracks unsafe behavior with automatic suspensions and complaint decay
• HUD Overlay — Delivery timer, progress counter, and context hints during active deliveries
• 3D Waypoints — Floating markers above delivery destinations with distance display
• Phone Integration — SMS shift updates via Community Bridge
• Postal Builder — Admin tool for creating and exporting depot locations with prop scanning
• NUI or Bridge Menu — Choose between a cinematic Vue menu or lightweight ox_lib context menu

Requirements

Resource	Purpose
community_bridge	Framework and resource abstraction layer
oxmysql	Database connectivity
ox_lib	Shared utilities, callbacks, UI

Quick Start

1. Place oxide-postaljob in your resources directory
2. Add ensure oxide-postaljob to server.cfg (after dependencies)
3. Import sql/install.sql into your database
4. Configure settings in shared/config.lua
5. Restart your server and visit a GoPostal depot on the map

See the Installation Guide for detailed setup instructions.