Docs Bike Item System

🚲 Bike Item System

A deployable bike script compatible with ESX, QBCore, and Standalone. Players can use a bike item from their inventory to spawn and ride a bicycle.

Free ESX QBCore Standalone
View on GitHub

Features

Multi-framework support (ESX, QBCore, Standalone)
7 different bike types
Deployment and pickup animations
3D text for pickup interaction
Highly detailed configuration
Advanced options (locking, invincibility, auto-delete)

Installation

1. Framework Configuration

Open config.lua and set your framework:

config.lua
Config.Framework = 'esx'  -- Options: 'esx', 'qbcore', 'standalone'

2. ESX Installation

1
Execute the items.sql file in your database
2
Add ensure bmx_item to your server.cfg
3
Restart the server

3. QBCore Installation

1
Add the items from items_qbcore.lua into qb-core/shared/items.lua
2
Add ensure bmx_item to your server.cfg
3
Restart the server

4. Standalone Installation

1
Add ensure bmx_item to your server.cfg
2
Use the command /givebike [type] to receive a bike
Console
/givebike bmx

Configuration

All options are located in config.lua. You can customize:

  • Display and pickup distances
  • Pickup key
  • 3D text style
  • Customizable animations
  • Per-bike options (spawn distance, weight, enabled state)
  • Advanced options (auto-delete, locking, invincibility)

Adding a Custom Bike

config.lua
['bike_name'] = {
    label = 'Bike Name',
    model = 'gta_model',
    spawnDistance = 2.0,
    weight = 5,
    enabled = true
}
Don't forget to add the item to your database or items file after adding a new bike.

Available Bike Types

Item KeyNameType
bmxBMXStreet
cruiserCruiserBeach bike
fixterFixterFixie bike
scorcherScorcherMTB
tribikeTriBikeRace
tribike2TriBike SportSport
tribike3TriBike ProPro

Usage

1
Use the bike item from your inventory
2
The bike will deploy in front of you with an animation
3
Use the bike normally
4
Get off and press E to pick it up — the bike returns to your inventory