Byte Labs - Hands-On

A hands-on, server-validated motorcycle wheel change simulator for your FiveM server.

Website: Byte Labs Discord: Byte Labs Full preview video: Releases

Walk up to a parked motorcycle with a tool kit and a replacement wheel, target the front or rear wheel and do the job yourself: lift the bike on a paddock stand, crack the caliper bolts, break the axle nut loose, set the chain slack, torque it to spec and pump the brake. 22 steps for a rear wheel, 18 for the front.

Features

• Fully hands-on: every step is done with the mouse (drag, turn, adjust, pick, pump), no progress bars
• Server-validated: every step is checked in order, with minimum step times, and rushing or doing it wrong costs a strike
• Real tools and parts: paddock stands, ratchet, breaker bar, torque wrench, axle, spacers, chain adjusters and caliper (15 original streamed props with PBR textures in one shared texture dictionary)
• Real mechanics: breaker-bar breakaway, chain slack and adjuster alignment, torque spec with over/under torque, wrong-spacer checks
• The old wheel actually comes off the bike and the new one goes back on
• The wheel item is only taken when the last step is accepted, so a failed, cancelled or interrupted job costs nothing
• Jobs end cleanly on disconnect, character logout (qb-core, Qbox, ESX) and resource restart, and the bike gets its wheel back
• Camera views per step and a Byte Labs styled overlay with step progress, live gauges and strike counter
• Auto-detects inventory and target resources, or runs fully standalone with an ox_lib prompt
• Developer exports and a completion event to hook in tyre condition, XP, payouts and more

Dependencies

• ox_lib
• OneSync
• Optional inventory: ox_inventory (Qbox, ox_core and others), qb-core (qb / ps / lj inventory), qs-inventory or es_extended
• Optional target: ox_target or qb-target

Installation

1. Download bl_handson-x.x.x.zip from Releases
2. Extract the bl_handson folder to your resources directory
3. Add the items from install/ to your inventory (see Items), or skip this for Standalone
4. Add ensure bl_handson to your server.cfg after ox_lib, your inventory and your target
5. Configure the config.lua to your liking

Config

return {
    items = {
        toolkit = 'moto_toolkit',
        frontWheel = 'moto_wheel_front',
        rearWheel = 'moto_wheel_rear',
    },

    inventory = 'auto', -- 'auto' | 'none' | 'ox_inventory' | 'qs-inventory' | 'qb-core' | 'es_extended'
    requireItems = true, -- forced off when inventory = 'none' or 'auto' finds no supported inventory

    target = 'auto', -- 'auto' | 'none' | 'ox_target' | 'qb-target'

    prompt = {           -- used when no target resource is running
        key = 'E',
        distance = 1.8,
    },

    command = false,     -- or { name = 'changewheel', restricted = 'group.mechanic' }

    interactDistance = 1.8,
    maxStrikes = 3,
}

Standalone

No framework, inventory or target needed, only ox_lib and OneSync. No items are checked or taken. The job still runs fully server-validated, the tyre is still fixed and bl_handson:bikewheel:completed still fires.

return {
    items = {
        toolkit = 'moto_toolkit',
        frontWheel = 'moto_wheel_front',
        rearWheel = 'moto_wheel_rear',
    },

    inventory = 'none',
    requireItems = false,

    target = 'none',

    prompt = {
        key = 'E',
        distance = 1.8,
    },

    command = false,

    interactDistance = 1.8,
    maxStrikes = 3,
}

Walk up to a parked motorcycle with nobody on it. When you are close to the front or rear wheel an ox_lib text UI shows [E] Change front wheel or [E] Change rear wheel. Press the key to start. Players can rebind it under Settings > Key Bindings > FiveM.

The prompt is used whenever target = 'none', or target = 'auto' and no target resource is running.

Optional command

command = {
    name = 'changewheel',
    restricted = 'group.mechanic', -- false for everyone
},

Registered with lib.addCommand on the server. The server picks the closest motorcycle within 3 m.

/changewheel        -- rear wheel
/changewheel front

With restricted set, grant access in your server.cfg:

add_principal identifier.license:xxxxxxxx group.mechanic

Items

The tool kit is kept. The replacement wheel is checked when the job starts and used up when the last step is done.

Item	Default name
Tool kit	moto_toolkit
Front wheel	moto_wheel_front
Rear wheel	moto_wheel_rear

• OX Inventory: paste install/ox_inventory.lua into ox_inventory/data/items.lua
• QB / PS / LJ Inventory: paste install/qb-core.lua into qb-core/shared/items.lua
• ESX: run install/es_extended.sql

Item images are not included, see install/images.

Controls

Key	Action
LMB	Grab / drag / turn
E	Confirm
X	Stop the job

Developers

Exports (server)

-- Starts a game for a player and yields until it ends.
-- Items are not checked or taken here unless you pass charge = true, do that yourself.
local ok, reason = exports.bl_handson:start(source, 'bikewheel', { netId = netId, wheel = 'rear' })

-- true while the player is in a game
local busy = exports.bl_handson:isBusy(source)

Events (server)

Fired after a wheel change started from the built-in target option, prompt or command has been completed.

AddEventHandler('bl_handson:bikewheel:completed', function(source, netId, wheel)
    -- wheel: 'front' | 'rear'
    local vehicle = NetworkGetEntityFromNetworkId(netId)
end)

Use AddEventHandler, not RegisterNetEvent, so clients cannot fake it.

Known limitations

• Motorcycles only (vehicle class 8), parked, with nobody on them.
• On bikes the CFX wheel array is front = 1, rear = 0 (tyre indexes front = 0, rear = 4).
• The real wheel is removed with BreakOffVehicleWheel(vehicle, index, false, true, true, false) (deleteWheel = true) and restored when the job ends.
• qb-target only checks for the tool kit before showing the option; the wheel item is still checked by the server.

License

GPL-3.0