Installation

Welcome to the bablo-racing installation guide. Follow each step carefully to ensure a smooth setup.

1. Download the asset

To find the asset in the portal you must have purchased it using your own CFX account. If the purchase was made on a different account, use the transfer system first.

After purchasing from our official website (opens in a new tab), the asset is delivered directly to your CFX Portal (opens in a new tab). Download it from there and extract it into your resources folder.

2. Install dependencies

bablo-racing requires the following resources to be present and started before bablo-racing:

3. Configure your server.cfg

🚫

Your framework core (es_extended, qb-core, qbx_core) must be started before bablo-racing. Incorrect start order is the most common cause of issues.

Add the following to your server.cfg:

# Start your framework first
ensure es_extended   # or qb-core / qbx_core
 
# Dependencies
ensure oxmysql
ensure ox_lib
 
# bablo-racing
ensure bablo-racing

4. Set up the item

The resource uses a single item — racing_tablet — which players use to open the racing app. Add it to your inventory using the tab that matches your inventory system.

⚠️

The item name must be racing_tablet exactly. Item images are found in the installation/inventoryImages/ folder inside the resource. Copy racing_tablet.png to your inventory's image directory.

Navigate to your ox_inventory items file (usually ox_inventory/data/items.lua) and add:

['racing_tablet'] = {
    label = 'Racing Tablet',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        image = 'racing_tablet.png',
        export = 'bablo-racing.openApp'
    },
},

The client.export field makes ox_inventory call the resource's export directly when the item is used, so no additional useable item registration is needed.

5. Configure the resource

Open bablo-racing/config.lua and set at minimum:

Config.Env.Framework = "auto"   -- or "esx" / "qb" / "qbox" / "standalone"
Config.Env.Inventory = "auto"   -- or your specific inventory name

See the Configuration page for a full breakdown of every option.

6. First start

Start the resource and check your server console. On first boot the resource will automatically create the required database tables (if Config.Env.AutoRepairDB = true).

Players can now receive the racing_tablet item and use it to open the racing app.

General Information Configuration