Race Essentials
This is a step-by-step installation guide, configuration preview, and full explanation of all settings for legends_raceessentials.
If you lack programming experience, ensure you read each step thoroughly without skipping, as all documentation is essential!
Before submitting a support ticket or following the guides in this documentation, please make sure that you are running the latest version of the resource.
What is legends_raceessentials?
legends_raceessentials is an advanced vehicle behavior enhancement system designed for racing servers and realistic driving experiences. It includes anti-exploit features to prevent common speed exploits, a configurable speed limiter, and a slipstream system for competitive racing.
Key Features
- Anti-Air Control - Advanced wheel-tracking system that prevents exploiting aerial vehicle control while preserving natural turning physics
- Disable Double Clutching - Prevents the speed boost exploit from rapid gear shifting in manual transmission
- Disable Curb Boosting - Reduces unintended speed gains when driving over curbs and bumps
- Speed Limiter - Configurable maximum speeds with per-vehicle-class categorization (KMH/MPH support)
- Slipstream System - Realistic drafting mechanics with configurable power boost and visual effects
- Fallen Entities Cleanup - Automatic cleanup of props with extensive whitelist protection
- Standalone - No dependencies required, works with any framework
Need help? Join our Discord (opens in a new tab) for support!
FAQ
How do I disable one anti-exploit feature (e.g. curb boost) without turning off all checks?
Every feature in config.lua has its own enabled flag under Config.Features (curbBoost, airControl, spin, suspensionSwap, roll, etc.). Set only the ones you need to true. Leaving the rest disabled keeps the resource lightweight for servers that only care about a subset of exploits.
How do I set different top speeds per vehicle class (Super vs. Sport vs. Muscle)?
Open Config.TopSpeed in config.lua. Keys are vehicle class ids (see FiveM GetVehicleClass docs, 0 = Compact ... 7 = Super) and values are the m/s cap. Leave a class out to exempt it. Native SetEntityMaxSpeed is used so the cap feels smooth, not like a sudden wall.
Can I whitelist specific vehicles (e.g. pursuit vehicles) from the anti-exploit checks?
Yes. Config.VehicleWhitelist takes spawn names or hashes. Whitelisted vehicles bypass all checks including speed caps and suspension/air-control detection. Useful for emergency services or a dedicated pursuit script that expects stock handling.
How do I toggle race mode (disable checks mid-race) from my lap timer or race system?
Call exports.legends_raceessentials:SetRaceMode(true) from the client when the race starts and SetRaceMode(false) at the end. Race mode disables curb boost + air control checks server-side so legitimate racing lines are not flagged, and re-enables them automatically on disconnect as a safety net.
How do exploit violations get logged and can I pipe them to Discord?
Every violation calls LogViolation in editable/server.lua with { playerId, feature, details }. The default implementation is a no-op; fill it with your Discord webhook or Umami event. The payload already includes enough context (vehicle model, speed, timestamp) to drop into an embed without extra processing.