Oxide Roadside Assistance

Oxide Roadside Assistance is a gig job system for FiveM servers. Players clock in at a tow yard, receive dispatch calls for stranded vehicles, and complete roadside services: fuel help, wheel changes, battery replacements, and towing.

Key Features

• Bridge Integration via o-link - Uses o-link for framework identity, targeting, phone messaging, money deposits, vehicle keys, notifications, and menu integration.
• Shift System - Dispatcher-driven flow with clear states (IDLE, WAITING, ON_CALL, WORKING) and slot limits per tow yard.
• Two Menu Modes - Rich Vue NUI mode ('nui') and lightweight olink.menu mode ('menu').
• Dispatch Loop - Randomized incoming calls with accept/decline window, missed-call cap, and event anti-repeat behavior.
• Four Job Types - Fuel help, wheel change, battery change, and towing with distinct interaction steps.
• Distance-Based Timers - Mission time uses Config.Timer.baseTime + math.floor(distance * Config.Timer.timePerDistanceUnit).
• Progression + Complaints - Unified progression row in job_progression with level rewards, streaks, complaints, and timeout logic.
• Crew Support - Two-player crew flow with invite rules and co-op payout bonus.
• Safety Cones + Props - Cones create traffic speed zones; tow truck props support each repair type.
• Admin Builder Tools - In-game builder plus tutorial control commands.

Requirements

Resource	Purpose
ox_lib	Locale, callbacks, timers, and UI helpers
oxmysql	Database driver
o-link	Framework and system abstraction used by this resource

Data Model

Progression is stored in the unified job_progression table with:

• char_id
• job (uses 'roadside')
• level
• total_count
• daily_streak
• last_activity_date
• complaints
• timeout_until

Documentation

• Installation Guide - Setup and startup order
• Configuration - Full config reference and behavior notes
• Features - Gameplay systems and payout mechanics
• Admin Tools - Builder commands and progression SQL
• Troubleshooting - Current checks for common failures