EvonexEvonex
🏎️ Racing System

📥 Installation

Step-by-step instructions to install and verify Evonex Racing on your FiveM server

Installation Guide

Follow this guide to install Evonex Racing on your FiveM server. Each step keeps the process deterministic so you can quickly track down any issues.

Prerequisites

  • Discord access for updates and support.
  • Basic familiarity with editing server.cfg and running SQL migrations.
  • Active FiveM server with resource upload access.

Supported Frameworks

  • QBX (QBOX) — Fully supported
  • QB-Core — Supported (use with caution; report bugs)
  • ESX — Supported (use with caution; report bugs)
  • Standalone — Works without a framework
  • Custom — Add your own bridge in server/custom/frameworks/

Set framework = "auto" in configs/general.lua for automatic detection, or specify "qbx", "qb", "esx", "standalone" manually.

Dependencies

Install and configure these before Evonex Racing:

ResourcePurpose
ox_libCore utilities; minimum v3.30.6
oxmysqlDatabase; minimum v2.12.0
evonex_racing_propsCheckpoint (download from https://portal.cfx.re/assets/granted-assets)

Resource Name

The resource must be named evonex_racing. Renaming will cause the script to abort loading.

Installation Steps

Retrieve the asset

Get the script from the Evonex store or your purchase confirmation. Extract the archive.

Upload the resources

Upload both folders into your FiveM resources directory (e.g. inside [racing] or a custom folder):

  • evonex_racing — The main racing script (from your Evonex/CFX purchase)
  • evonex_racing_props — Checkpoint and race start props (from the same purchase)

Append to server.cfg

Add these to server.cfg before evonex_racing:

ensure oxmysql
ensure ox_lib
ensure evonex_racing_props
ensure evonex_racing

Run SQL

Locate the SQL files inside evonex_racing and run them with your database client (e.g. HeidiSQL, phpMyAdmin):

evonex_racing.sql
evonex_racing_tracks.sql
  • evonex_racing.sql — Creates tables for races, accounts, MMR, and related data. Auto-imported when no tables exist on first start.
  • evonex_racing_tracks.sql — Import manually if you want predefined tracks. Not auto-imported.

Configure

  • Edit configs/general.lua — Set framework and basic options.
  • Edit configs/server.lua — MMR, item rewards, Discord logs.
  • Optional: configs/race.lua, configs/raceGeneration.lua, configs/checkpoints.lua, etc.

Restart and test

Restart your server, watch the console for errors, and join the game. Open the racing tablet to confirm the UI loads correctly. If you don't have an inventory item to open it, set command = true in configs/general.lua to use a chat command.

Troubleshooting

If something fails, see the troubleshooting guide or reach out in Discord.