Installation

Overview

ml_vehiclecraft turns a chassis item into a drivable owned vehicle. A player places a bare shell in the world, installs its parts one at a time with a full carry and mount sequence, and finishes the project into a registered vehicle. It ships with a placement ghost, a holographic progress board over the shell, crew collaboration, an admin panel with a map view, wreck salvaging and an optional paid layer. Runs on ESX, QBCore, Qbox and standalone through ml_bridge.

Quick Start

1. Download from CFX Portal
2. Extract to your resources folder as ml_vehiclecraft
3. Add to server.cfg:

1ensure oxmysql
2ensure ox_lib
3ensure ml_bridge
4ensure ml_vehiclecraft

Database

The schema installs automatically on first start. _INSTALL/ml_vehiclecraft.sql is provided for servers whose database user cannot run DDL at runtime.

Table - Purpose

ml_vehiclecraft_builds - Every project in the world: vehicle, owner, crew, coordinates, slot state, plate, shell colour

ml_vehiclecraft_unlocks - Permanent per-vehicle unlocks, only used by the paid layer

ml_vehiclecraft_credits - Per-player balance of paid uses, only used by the paid layer

All three use CREATE TABLE IF NOT EXISTS, so restarts never touch existing rows.

Item Registration

Copy the entries in _INSTALL/items.lua into your inventory definition, and every file in _INSTALL/images into ox_inventory/web/images.

With the shipped defaults only these are needed:

• vc_chassis: the bare shell, stamped with the vehicle it builds
• vc_engine, vc_transmission, vc_brakes, vc_wheel, vc_door, vc_seat, vc_bonnet, vc_boot, vc_exhaust: the parts
• vc_bp_rebel, vc_bp_bison, vc_bp_youga, vc_bp_dinghy, vc_bp_elegy2, vc_bp_sultan, vc_bp_futo: blueprints for tier 2 and tier 3 vehicles

The per-vehicle vc_chassis_<model> entries in the same file belong to Config.ChassisMode = 'items' and can be skipped otherwise. toolkit is only needed if Config.Tools.enabled is turned on.

Where parts come from

The script builds vehicles. It deliberately does not sell, spawn or loot the parts, so it never fights with the shop, loot or crafting system already running on the server. Pick one source before going live, otherwise players have no way to start a project.

The admin panel covers testing on its own: open /vehiclecraft, pick a vehicle under Spawn for testing and press Chassis and Parts. The full loop is playable in under a minute without wiring anything.

For production, the Developer page has copy-paste snippets for a shop entry, a crafting recipe, a loot table reward and a generic give call.

Verify

After starting, the server console prints the resource banner and the number of restored projects. Give yourself a chassis and use it:

1/vc_givechassis <playerId> emperor
2/vc_giveparts <playerId> emperor

Using the chassis opens placement. Set the shell down, walk up to it, and the build panel opens on the target option.