UZ Cargo Job Shipping

UZ Cargo Job Shipping - Commercial Freight & Logistics System for FiveM

The UZ Cargo Job Shipping script delivers a complete commercial freight and logistics career system for FiveM servers, allowing players to operate as truck drivers, cargo haulers, and shipping coordinators in a realistic logistics business framework. This comprehensive job system goes beyond simple delivery missions by incorporating freight contracts, cargo management, fleet operations, delivery scheduling, route planning, and shipping company management that mirror real-world commercial transportation. Whether you're adding blue-collar employment opportunities to your economy, creating immersive trucking roleplay for enthusiasts, or building a complete logistics industry ecosystem where players can progress from independent owner-operators to shipping company executives, UZ Cargo provides the depth and functionality to make freight transportation a rewarding, skill-based career path.

What's Included

This full-featured cargo system includes a contract dispatch interface presenting available freight jobs with cargo details, destinations, and payouts, comprehensive cargo types ranging from standard freight to hazardous materials requiring special handling, delivery validation systems checking cargo condition, route compliance, and timing for payment calculation, vehicle restrictions ensuring appropriate trucks are used for different cargo classes, company management features allowing players to create and operate shipping businesses with multiple employees, fleet ownership and maintenance tracking vehicle condition, fuel consumption, and repair needs, route planning tools showing optimal paths, distance estimates, and fuel calculations, shipment tracking systems allowing real-time monitoring of active deliveries, and progression mechanics unlocking access to higher-paying contracts, larger vehicles, and exclusive freight types. The system includes realistic truck spawning at designated freight depots, cargo loading/unloading animations and processes, and integration with economy frameworks for meaningful earnings and expenses.

Key Cargo System Features

• Contract Dispatch System - Browse available freight jobs showing cargo type, weight, destination, distance, time limits, and payout before accepting
• Diverse Cargo Types - Standard freight, perishables (time-sensitive), fragile goods (damage penalties), hazmat (special certification), oversized loads (route restrictions)
• Cargo Damage Mechanics - Realistic damage calculation based on driving behavior (collisions, sharp turns, excessive speed) reducing payment for damaged goods
• Delivery Validation - Multi-point verification ensuring proper cargo handling, route compliance, and timely delivery for full payment
• Vehicle Classification - Different truck classes (box trucks, semi-trailers, flatbeds, tankers) required for specific cargo types
• Company Creation & Management - Establish shipping companies, hire employee drivers, share contracts, pool earnings, and manage fleet
• Progression System - Experience and reputation unlocks access to better contracts, larger vehicles, exclusive routes, and special freight
• Route Planning Tools - Pre-delivery route preview showing distance, estimated time, fuel costs, and hazard warnings
• Fuel & Maintenance - Realistic operating costs with fuel consumption, vehicle wear, and repair expenses affecting profit margins
• Real-Time Tracking - GPS systems showing active deliveries, ETA, and progress for company managers and customers

Perfect For

• Economy-focused servers wanting skill-based legal employment with earnings scaling based on player ability and efficiency
• Trucking enthusiast communities who enjoy realistic logistics simulation and commercial driving roleplay
• Blue-collar RP servers providing working-class jobs beyond emergency services and retail positions
• Business management servers where players operate companies with employees, fleets, and profit/loss considerations
• Diverse career servers ensuring players have non-combat, non-criminal income opportunities for peaceful gameplay
• Progression-focused communities where job advancement creates long-term goals and achievement systems

Technical Details

• Performance Impact: Moderate during active jobs (~0.10ms for route tracking and cargo monitoring), minimal when inactive
• Framework Support: Native integration for ESX Legacy, QBCore, QBOX with job system and economy synchronization
• Database: Comprehensive tables tracking active contracts, delivery history, company data, vehicle fleet, and progression
• Vehicle System: Configurable truck spawning at freight depots with saved vehicles for company fleets
• Cargo Physics: Real-time monitoring of vehicle condition, speed, and impacts calculating cargo damage
• Route Calculation: Server-side path validation preventing exploits while allowing driver freedom
• Company Features: Multi-player company support with role systems (owner, manager, driver) and shared resources
• UI Technology: Modern dispatch interface with map integration, contract details, and real-time delivery tracking

Installation & Configuration

1. Extract the uz-cargo folder to your server's resources directory
2. Import all included SQL files to create cargo job database tables for contracts, companies, deliveries, and progression
3. Add ensure uz-cargo to your server.cfg after your framework resource
4. Configure freight depot locations in config.lua where players start jobs and spawn vehicles
5. Set up cargo types with payouts, vehicle requirements, time limits, and special handling rules
6. Define delivery destinations across the map creating varied routes of different lengths and difficulties
7. Configure vehicle fleet with truck models, cargo capacities, fuel consumption rates, and rental/purchase costs
8. Set progression thresholds determining when players unlock new cargo types, vehicles, and routes
9. Adjust economy settings including base pay rates, fuel costs, repair expenses, and damage penalties
10. Optionally configure company creation fees, employee limits, and profit-sharing mechanics

Framework Compatibility

• ✅ ESX Legacy - Full support for ESX 1.9.x and 2.x with job integration (create trucker job), society accounts for companies, and inventory for cargo items
• ✅ QBCore - Native QBCore integration including qb-banking for payments, qb-management for companies, and job system synchronization
• ✅ QBOX - Complete QBOX framework compatibility with modern job and economy systems
• ❌ Standalone - Framework required for job detection, economy transactions, and progression tracking

Cargo Job Workflow

The delivery process creates engaging, skill-based gameplay. Players begin at a freight depot, accessing the dispatch terminal to browse available contracts filtered by their progression level and certifications. After selecting a job, they review cargo details including weight, fragility, special requirements, and time constraints. They spawn or retrieve an appropriate truck from the depot, drive to the loading point where cargo loading animations play and cargo data attaches to their vehicle, plan their route considering distance, traffic, and cargo sensitivity, execute the delivery monitoring vehicle condition and cargo integrity during transit, arrive at the destination within the time window, complete unloading procedures, and receive payment based on delivery performance (on-time, undamaged cargo earns bonuses; late or damaged deliveries incur penalties). The entire loop creates tension between speed (earning more per hour) and caution (preventing cargo damage).

What Makes It Stand Out

UZ Cargo Job transforms trucking from drive point A to B, get money into a nuanced skill-based profession. The cargo damage system rewards careful driving - hauling fragile cargo on mountain roads during storms requires genuine skill and patience, creating satisfaction when deliveries succeed. The progression mechanics provide long-term goals - new players start with local box truck deliveries earning modest pay, while experienced drivers haul hazmat cross-country in massive semi-trailers for substantial payouts, creating aspirational targets and visible status differentiation. The company system enables social gameplay where friends collaborate running shipping businesses, sharing resources and coordinating multi-vehicle operations. The realistic economic model (fuel costs, maintenance, tolls, time investment) means players make genuine business decisions about which contracts offer the best profit margins, mirroring real logistics operations rather than simply grinding highest-paying missions.

Company Operations & Team Play

The company management layer adds business simulation depth. Company owners invest capital creating shipping businesses, purchase or rent trucks building a fleet, hire employee drivers who can accept company contracts, manage logistics coordinating multiple simultaneous deliveries, set employee payment structures (salary, commission, bonuses), and handle operating expenses (fuel, maintenance, depot fees). Employees benefit from company resources (access to better trucks without ownership costs, stable income, team support) while owners profit from scaling operations beyond individual driving capacity. This creates natural social structures - successful solo drivers might start companies, recruit friends or skilled players as employees, expand the fleet and contract access, and transition from driver to business owner focusing on management and logistics coordination rather than personally completing every delivery.

Progression & Specialization Path

Career advancement creates meaningful progression beyond simple level grinding. New drivers start with local deliveries using box trucks earning basic pay and building reputation. Intermediate drivers unlock regional routes with larger trucks, hazmat certifications, and time-critical cargo earning better money. Advanced drivers access cross-state contracts with specialized vehicles (tankers, oversized load haulers), exclusive high-value freight, and premium payouts. Masters establish companies, manage fleets, and coordinate logistics operations shifting from individual driver to business executive. The progression isn't purely time-based - careful drivers advance faster through low-damage bonuses, efficient drivers through quick deliveries, and social players through company management. This creates diverse paths to success rather than forcing all players down identical grinding routes.

Integration with Server Ecosystem

The cargo system creates interesting connections with other server mechanics. Businesses might place freight contracts needing deliveries of supplies (restaurant orders food, mechanics order parts), creating player-to-business logistics. Law enforcement can inspect cargo hauls checking for contraband or overweight violations, adding realism and tension. Mechanics profit from truck repairs after difficult routes. Gas stations become essential stops on long hauls. Criminal players might hijack valuable cargo creating risk/reward scenarios. The freight depot locations become social hubs where drivers gather, compare earnings, share route tips, and recruit for companies. These integrations transform cargo from isolated job system into interconnected server ecosystem element.

Related ESX Scripts

• Key System (T1GER)
• Brutal Report System
• Dream Miner (ESX/QB)
• ESX Apartment System