- 77 downloads
- Version 1.1.0
Los Santos Freight Co. TruckingResource: ls_trucking Version: 1.1.0 Author: DrSnyder Game: FiveM / GTA V Main command: /trucking Receiver command: /truckreceiver Dock command: /truckui Default receiver key: F2 Default dispatch key: F3 Los Santos Freight Co. Trucking is a full freight career resource for FiveM. It includes company freight contracts, private contractor progression, garage vehicles, cargo handling, trailer hauling, dispatch radio chatter, receiver and dock UIs, route history, job summaries, random delivery events, and admin trailer cargo prop tools. The script is built around a dispatch tablet for selecting work and a handheld receiver for active route operations. Players can run company freight, unlock private contractor work, buy their own approved vehicles, save vehicle fuel and condition, choose an optional dedicated daily route, and build a trucking career through rank, XP, reputation, payouts, and route history. HighlightsDispatch tablet with contract, current job, garage, contractor, company, and route history views. Handheld receiver UI with app-style pages for current route, manifest, load, vehicle, dispatch log, and settings. Compact route dock UI for quick route status during active work. Company contracts for van, box truck, and trailer hauling jobs. Private contractor system with license purchase, vehicle ownership, optional dedicated daily route assignments, contractor reputation, and higher-risk payouts. Company garage and private fleet support with saved vehicle props, fuel, engine health, and body health. Cargo collection, trunk loading, delivery handoff, cargo condition, and route completion tracking. Trailer hookup, trailer load checklist, secure/load verification, receiver signoff, and trailer drop validation. Configurable flatbed trailer cargo props with an in-game admin editor and test spawner. Dispatch radio chatter, TX/RX light behavior, GPS lock status, signal bars, route progress, and status sounds. Random delivery events such as rush orders, audits, reroutes, dock delays, customer call-aheads, and other route modifiers. Rank progression with 10 ranks, ending at 500,000 XP. Framework adapters for QB-Core, Qbox, ESX, ND_Core, and standalone fallback. Inventory, fuel, key, and target compatibility bridges. Vehicles.config includes popular add-on vehicle tables. Uncomment desired vehicle tables. Vanilla vehicle tables included by default. Pier 400 Port area cleanup ymaps included. Removes Trailers from pump and weigh station area. Also includes ytd's with custom LSF Liveries and vehicle.metas for trailer compatibility for gta vanilla vehicles. Pasted content Dispatch TabletThe dispatch tablet is the main job hub. ContractsSelect van, box truck, or trailer contract types. Select company vehicle and load priority. View route preview, stops, payout, cargo, distance, and estimated time. Start company contracts from the right-side context panel. Current JobShows the current route state, route details, cargo progress, stops, vehicle, trailer status, manifest, and current objectives. GarageView company fleet vehicles. Select a vehicle card to preview vehicle data in the right panel. Spawn vehicles from the selected vehicle panel. Return the current company vehicle to save modifications. Spawn checks prevent vehicles from spawning into occupied spots. ContractorPurchase a contractor license once the required rank is reached. Buy approved vans, box trucks, and tractors. Store and spawn owned contractor vehicles. Save fuel, engine health, body health, and vehicle props when garaged. Only one contractor vehicle can be out at a time. Choose an optional dedicated daily route assignment by delivery type from a compact route list. Dedicated daily routes stay assigned after selection and can be changed after the configured weekly cooldown. Complete the dedicated daily route once per server day for bonus payout and contractor rep. Available private contracts are separate from the dedicated daily route and only show route choices for the private vehicle type currently spawned. Contractor routes require minimum fuel and condition. Contractor jobs pay more but have higher penalties and cancellation costs. CompanyView player career stats, rank progress, reputation, earnings, completed jobs, and rank information. Route HistoryView completed route summaries. Expand recent job tiles to review route, payout, XP, reputation, vehicle, contract type, and completion data. Receiver UIThe receiver is a handheld device-style UI. It can be opened during or outside an active route. Receiver pages: Current Route - active objective, notice, destination, ETA, alerts, cargo, payout, route progress, cancel route. Manifest - contract data and stop/package data. Load - cargo state and load priority/request tools. Vehicle - assigned vehicle data, fuel, condition, GPS, locks, engine, lights, doors, hood, trunk, hazards, locate. Dispatch Log - radio traffic and route completion summary history. Settings - player info, rank, XP, reputation, receiver assignment, model/firmware, dock model, movement toggle, dock toggle. Receiver details: Model label: BDG-LSFC-R-1.1. Dock model label: BDG-LSFC-D-1.1. TX/RX indicators react to updates and route messages. GPS lock and signal bars update based on route/dispatch state. Receiver movement can be toggled from settings. The player uses a phone-style prop and animation while the receiver is open. The receiver allows walking and driving while open. Compact Dock UIThe compact dock is designed as a smaller route receiver fixed near the screen edge. It shows: Channel. Freight logo. RX/TX/GPS/signal block. Current radio chatter. Destination name and street area. Route name. Cargo and stop icon progress. Last update time. Thin route progress bar. Dock model watermark. The dock can be toggled with /truckui and can be moved when movement mode is enabled. Route FlowVan RoutesTalk to pickup worker. Collect package. Open trunk/cargo area. Load package into vehicle. Verify load attached. Drive to delivery stop. Grab package from vehicle. Deliver package. Continue through all stops. The script accounts for missing trunk/cargo doors so players are not blocked if a door is damaged or detached. Box Truck RoutesCollect crates. Load crates into the assigned box truck. Verify cargo. Deliver crates to stores or warehouses. Complete all assigned stops. Trailer RoutesSpawn or use assigned tractor. Travel to trailer depot. Hook assigned trailer. Secure trailer/load. Complete checklist. Drive to receiving yard. Detach trailer in drop zone. Confirm trailer dropped. Complete receiver signoff. Trailer depots can have multiple spawn spots, and the script tries available spots when one is occupied. RequirementsRequired: ox_lib oxmysql ox_target or qb-target A supported framework or standalone mode A supported inventory system Recommended: A supported fuel script A supported vehicle key script SQL database access Admin permissions configured through your framework or ACE permissions Supported FrameworksSet this in config/config.lua: Config.Framework = 'auto' -- auto, qb, qbox, esx, nd, standaloneSupported modes: auto - detects the running framework. qb - QB-Core. qbox - Qbox / qbx_core. esx - ESX / es_extended. nd - ND_Core. standalone - no framework economy integration. Useful for testing or custom integrations. Notes: QB-Core and Qbox are the most complete drop-in targets. ESX and ND_Core support is handled through the framework adapter. ESX and ND_Core installs are best paired with ox_inventory. Standalone mode can run the job flow, but money, jobs, and permissions may need custom integration if used on a live economy server. Supported ScriptsTargetConfig.TargetSystem = 'auto' -- auto, ox, qbSupported: ox_target qb-target InventoryConfig.Inventory = {
System = 'auto',
Debug = false,
UseInternalTrunkFallback = true,
TrunkPrefix = 'trunk'
}Supported: ox_inventory qb-inventory lj-inventory ps-inventory qs-inventory custom Notes: ox_inventory has the best metadata and trunk support. Other inventories use player item handling plus the internal route trunk fallback when needed. Item templates are included in the install folder. FuelConfig.Fuel = {
System = 'auto',
DefaultFuel = 100.0
}Supported: ox_fuel LegacyFuel ps-fuel cdn-fuel lj-fuel qb-fuel BigDaddy-Fuel none Vehicle KeysConfig.Keys = {
System = 'auto',
GiveOnSpawn = true,
RemoveOnReturn = false,
OwnerOnly = true
}OwnerOnly tells LSFC to keep vehicle keys assigned to the driver who checked out the vehicle. When a company or contractor vehicle is assigned, other online clients are asked to remove keys for that plate through the configured key script. Supported: qb-vehiclekeys qbx_vehiclekeys Renewed-Vehiclekeys MrNewbVehicleKeys wasabi_carlock cd_garage none InstallationPlace the resource folder in your server resources. Import sql/ls_trucking.sql into your database. Add inventory items from the matching file in the install folder. Configure config/config.lua. Configure routes, vehicles, items, contracts, and random events if desired. Ensure dependencies before ls_trucking. Start the server and check the startup summary in console. Example ensure order: ensure ox_lib
ensure oxmysql
ensure ox_target
ensure qb-core
ensure ox_inventory
ensure ls_truckingUse your actual framework, inventory, target, fuel, and key resources. Main Config Filesconfig/config.lua - main framework, commands, UI, ranks, economy, security, depots, timing, penalties, contractor settings. config/contracts.lua - route pools, contract data, stops, businesses, route layouts. config/vehicles.lua - company vehicles and contractor vehicles. config/route_trailers.lua - route trailer definitions, trailer cargo prop layouts, liveries, extras, and trailer instructions. config/items.lua - cargo item definitions. config/random_events.lua - random delivery events. Trailer pickup/drop area circles are controlled from Config.AreaBlips in config/config.lua. Set Enabled = false to disable the extra minimap circles, or adjust radius/color/alpha per trailer pickup and drop stage. Install helper files: install/ox_inventory_items.lua install/qb_inventory_items.lua install/qs_inventory_items.lua install/qb_radial_items.lua install/qbx_radial_items.lua install/ADD-ON-Trailers.meta Player Commands/trucking - opens the Los Santos Freight Co. dispatch tablet. /truckreceiver - toggles the full handheld receiver. /truckui - toggles the compact route dock. /canceltrucking - cancels the active route with confirmation. Default keybind: F2 - toggles the full receiver. This can be changed with Config.FullReceiverKey. If Config.RequireJob is enabled, receiver access respects the configured job requirement. Admin CommandsAdmin commands are available to admins even when debug mode is disabled. Debug mode still controls extra debug visuals and logs. Permission checks use framework admin/god permissions first, then common admin ACE checks, then the optional ACE entries in: Config.Security.AdminAces = { 'ls_trucking.admin', 'ls_trucking.debug' }Commands: /lstruck_resetjob - force reset your active trucking job. /lstruck_clearpeds - clear active contract worker peds. /lstruck_giveitems - give cargo items for the current active route. /lstruck_summary - open an admin route state summary. /lstruck_rank <playerId> <rank> - set a player's trucking rank XP. /lstruck_rep <playerId> <amount> - adjust a player's trucking reputation. /lstruck_resetstats <playerId> - reset trucking stats. /lstraileredit <trailerKey> - open the trailer cargo prop editor. /lstrailertest <trailerKey> - spawn a configured trailer and cargo props without starting a contract. /lstrailerclear - remove the current trailer test unit. Random Delivery EventsRandom delivery events live in: config/random_events.lua
Events can affect: Route time. Payout. XP. Reputation. Alert text. Radio chatter. Route urgency. Examples include: Rush order bonus. Dock delay. Traffic reroute. Receiver audit. Customer call-ahead. Dispatch schedule changes. ProgressionRanks are configured in config/config.lua. Current default rank list: Rank 1 - Probationary Driver Rank 2 - City Courier Rank 3 - Route Driver Rank 4 - Trailer Certified Driver Rank 5 - Freight Operator Rank 6 - Long Haul Driver Rank 7 - Heavy Freight Specialist Rank 8 - Fleet Lead Rank 9 - Logistics Supervisor Rank 10 - LSFC Master Hauler Rank 10 requires 500,000 XP. Trailer Cargo Prop SystemFlatbed-style route trailers can spawn with configured cargo props already attached. This is useful for flatbeds, military trailers, freight trailers, and custom cargo variations. Configured trailers live in: config/route_trailers.lua
Look for: Config.RouteTrailers = {
flatbed = {
label = 'Flatbed Trailer',
model = 'trflat',
cargoProps = {
-- props here
}
}
}Each trailer variation can use the same trailer model with different cargo props. For example, one trflat entry can be empty, another can carry crates, and another can carry containers. Trailer Prop EditorUse: /lstraileredit <trailerKey>
The editor lets admins: Select a configured trailer by Config.RouteTrailers key. Add, duplicate, delete, and edit cargo props. Adjust model names. Nudge offset and rotation by axis. Print ready-to-paste cargoProps data to console. Camera keys while editing: A / D or arrow left/right - rotate camera. W / S or arrow up/down - adjust camera height. Q / E - zoom. R - reset camera. Trailer Test SpawnerUse: /lstrailertest <trailerKey>
/lstrailerclear
This lets admins spawn and inspect a configured trailer without starting a contract. Recommended workflow: Copy or create a trailer entry in Config.RouteTrailers. Run /lstraileredit trailer_key. Tune the props in-game. Print the config. Paste the printed cargoProps into config/route_trailers.lua. Run /lstrailertest trailer_key. Assign the trailer key to routes once it looks right. Customization NotesGood places to start: Add routes in config/contracts.lua. Add company or contractor vehicles in config/vehicles.lua. Add route trailers and trailer prop layouts in config/route_trailers.lua. Add new cargo items in config/items.lua. Add route events in config/random_events.lua. Replace receiver/dock logos in the images folder. Replace sounds in html/sounds. Adjust ranks, payouts, penalties, route timing, and contractor rules in config/config.lua. TroubleshootingDispatch tablet opens but jobs do not startCheck server console for startup validation messages. Confirm oxmysql is running and the SQL was imported. Confirm your framework adapter is detecting the expected framework. Confirm target and inventory resources are started before ls_trucking. Vehicle will not spawnMake sure the spawn area is not occupied. Confirm you are within the configured depot request range. Check Config.SpawnOccupancy. Check company/contractor vehicle stored state in the database if needed. Cargo cannot be loaded or deliveredConfirm the cargo item exists in your inventory resource. Confirm the matching install item file was added. If not using ox_inventory, keep UseInternalTrunkFallback = true. Contractor route says active after restartConfirm the latest SQL columns exist. Confirm the resource has write access to update contractor route state. Check trucking_contractor_profiles and trucking_contractor_vehicles. Receiver or dock access with job requirementIf Config.RequireJob = true, confirm the player's framework job matches Config.JobName. Admin commands are separate from player receiver access. Trailer props do not appearConfirm the prop model name exists and can be loaded. Test with /lstrailertest <trailerKey>. Make sure the trailer entry has cargoProps. Check console for model loading errors. Development NotesThe script has been split into focused client and server modules where possible: Framework and compatibility bridges. Route state and route helpers. Cargo handling. Depot vehicle handling. Dispatch data. Route summaries/history. Trailer cargo props, editor, and tester. client/main.lua and server/main.lua still coordinate the larger flow, but most heavy feature areas now live in separate modules. Github (Always up-to-date)https://github.com/DrSnyder86/ls_trucking/tree/main
