Installation

Overview

ml_turret is a multi-caliber defence system for FiveM. It handles placeable turrets spawned from kit items, admin-defined fixed turrets, AI target acquisition, manual control with a first-person cabin view, group invites, destruction/rebuild flow and a tactical UI. 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_turret
3. Add to server.cfg:

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

Database

The schema installs automatically on first start. No SQL file to import.

ml_turrets: Stores every placed and fixed turret: type, coords, owner, health, fuel, loaded ammo, AI state, destruction flag

The query uses CREATE TABLE IF NOT EXISTS. This table creation step preserves an existing table. Normal turret loading and state updates still run on restart.

Item Registration

Copy the entries in _INSTALL/items.lua into your inventory definition.

Required items:

• bazq_heavy_kit: placement kit for the Bazq heavy turret
• cctv_sentry_kit: placement kit for the CCTV sentry
• ammo_9mm, ammo_556, ammo_762, ammo_50, ammo_minigun_belt: calibres used by the default turrets
• repair_kit, welding_torch: repair items for damaged turrets
• turret_rebuild_kit: item consumed to rebuild a destroyed turret from rubble
• diesel, jerrycan_large: fuel items

All item names are configurable in Config.Turrets[type] and Config.Ammo. Icons resolve automatically through ml_bridge, no manual icon paths required.

Props

The bazq_heavy turret type uses custom props sold separately by the prop author. You must purchase and install the Bazq Turret Prop Pack to render the heavy turret.

• Models required: bazq-turret1b_base, bazq-turret1b_gunner, bazq-turret1b_barrel
• The stream resource must load BEFORE ml_turret in your server.cfg
• The CCTV sentry type uses a single vanilla GTA prop and does NOT require the Bazq pack

Audio

Drop the turret sound files (.ogg/.wav/.mp3) into the sounds/ folder. If xsound is not installed, set Config.Sounds.enabled = false in shared/config.lua.

Verify

After starting, the server console prints:

1[ml_turret] Database ready (schema checked/installed)
2[ml_turret] Loaded N placeable turret(s) from DB
3[ml_turret] Loaded M fixed turret(s) from config
4[ml_turret] ml_turret ready - K total turret(s) active

Give yourself a kit item and use it in-game:

1/giveitem <playerId> bazq_heavy_kit 1
2/giveitem <playerId> ammo_762 10