Overview

Advanced Turnout Gear is a FiveM turnout gear resource built around stations, turnout sets, rank access, duty checks, personal gear variations, fire/smoke contamination, and gear wear tracking.

Requirements

Required

• ox_lib
• oxmysql
• MariaDB or MySQL database

Optional

• QBCore, QBox, ESX, custom framework, or standalone mode
• SmartFires or z_fire for fire/smoke detection

Installation

1. Place the resource folder in your server resources directory. Recommended folder name: advanced_turnout_gear.
2. Import the SQL file if using gear wear. See SQL Setup.
3. Review config.lua and rank_config.lua.
4. Add the resource and dependencies to server.cfg.
5. Grant admin ACE permission.
6. Restart the server.

server.cfg

ensure ox_lib
ensure oxmysql
ensure advanced_turnout_gear

Admin Permission

add_ace group.admin atg.stationmanager allow

The default ACE permission is controlled by Config.AdminAce = "atg.stationmanager".

SQL Setup

Gear wear is stored in SQL when Config.WearAndTear.enabled = true and Config.WearAndTear.useSql = true.

Included SQL file:

sql/atg_gear_wear.sql

Default Table Name

Config.WearAndTear.tableName = "atg_gear_wear"

Table Schema

CREATE TABLE IF NOT EXISTS `atg_gear_wear` (
    `owner_identifier` VARCHAR(120) NOT NULL,
    `outfit_id` VARCHAR(80) NOT NULL,
    `durability` INT NOT NULL DEFAULT 100,
    `uses` INT NOT NULL DEFAULT 0,
    `minutes_worn` INT NOT NULL DEFAULT 0,
    `used_seconds` BIGINT NOT NULL DEFAULT 0,
    `seconds_since_wash` BIGINT NOT NULL DEFAULT 0,
    `wash_required` TINYINT(1) NOT NULL DEFAULT 0,
    `state_version` TINYINT NOT NULL DEFAULT 1,
    `last_used` BIGINT NULL,
    `updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (`owner_identifier`, `outfit_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

On startup, server_wear.lua also attempts to create the table and add missing columns if needed.

Configuration

Main config files:

General Settings

Data File Settings

Config.StationDataFile = "station_data/stations.json"
Config.OutfitDataFile = "outfit_data/outfits.json"
Config.RankSystem.dataFile = "rank_data/ranks.json"

Vehicle Gear Access Defaults

Example Vehicle Entry From 1.0.0

vehicles = {
    ["engine113"] = {
        station = "Station 113",
        label = "Engine 113",
        seatAccess = true,
        trunkAccess = true,
        customOffset = false,
        rearOffset = vector3(0.0, -4.6, 0.35)
    },
    ["medic113"] = {
        station = "Station 113",
        label = "Medic 113",
        seatAccess = true,
        trunkAccess = true,
        customOffset = false,
        rearOffset = vector3(0.0, -3.4, 0.25)
    }
}

The station value can match either the station id or the visible stationName.

Player Gear Variations

Player variations are enabled by default and saved in outfit_data/player_outfits.json. Allowed override IDs are configured in Config.PlayerVariations.allowedComponents and allowedProps.

Framework Setup

Framework settings are in Config.Framework and duty settings are in Config.Duty.

Framework Types

Default Framework Config

Config.Framework = {
    type = "standalone",
    restrictAccess = false,
    allowedJobs = { "fire", "ambulance" },
    gradeOffset = 1,
    rankSource = "hybrid",
    characterIdentifierSource = "character",
    showCharacterName = true,
    showJob = true,
    showCallsign = true
}

Rank Source

Duty Settings

Config.Duty = {
    enabled = true,
    source = "standalone",
    requireOnDutyForGearAccess = true,
    esxJobMeansOnDuty = true
}

Duty source can be standalone, framework, or hybrid. Station clock-in/out points can be configured per station through the Station Manager.

Standalone Ranks

Standalone rank behavior is configured in rank_config.lua.

Config.RankSystem = {
    enabled = true,
    defaultRank = 1,
    dataFile = "rank_data/ranks.json",
    setRankCommand = "setrank"
}

Config.Ranks = {
    [1] = "Probationary",
    [2] = "Firefighter",
    [3] = "Lieutenant",
    [4] = "Captain",
    [5] = "Battalion Chief",
    [6] = "Chief"
}

Stations

Stations are stored in station_data/stations.json and can be managed in-game with /stationmanager.

Actual Station Schema

{
  "id": "station_113",
  "departmentName": "San Andreas Fire Rescue",
  "stationName": "Station 113",
  "departmentLogo": "department_placeholder.png",
  "coords": { "x": 2239.96, "y": 4932.91, "z": 41.45 },
  "markerEnabled": true,
  "washer": {
    "name": "Station 113 Gear Extractor",
    "coords": { "x": 2234.44, "y": 4942.43, "z": 41.45 }
  },
  "clock": {
    "name": "Station 113 Clock In / Out",
    "coords": { "x": 0.0, "y": 0.0, "z": 0.0 }
  }
}

The uploaded 1.0.0 package ships with Station 113 as the default sample station. The clock block is optional and is only present if configured through the manager.

Station Manager Fields

• Department Name
• Department Logo file name
• Station Name
• Suit-up / locker coordinates
• Decon / washer coordinates
• Clock-in/out coordinates
• Marker enabled toggle

Department Logos

Station logos are loaded from station_images/. The default fallback is department_placeholder.png.

Outfits

Outfits are stored in outfit_data/outfits.json and managed in-game with /turnoutmanager.

Actual Outfit Fields

Example Outfit From 1.0.0

{
  "id": 1001,
  "name": "Firefighter Turnout",
  "image": "images/firefighter.png",
  "contaminationEnabled": true,
  "allowedRanks": [1, 2, 3, 4, 5, 6],
  "assignedStations": [],
  "male": {
    "components": {
      "3": { "drawable": 17, "texture": 0 },
      "4": { "drawable": 120, "texture": 0 },
      "6": { "drawable": 25, "texture": 0 },
      "8": { "drawable": 15, "texture": 0 },
      "9": { "drawable": 0, "texture": 0 },
      "10": { "drawable": 0, "texture": 0 },
      "11": { "drawable": 250, "texture": 0 }
    },
    "props": {
      "0": { "drawable": 45, "texture": 0 },
      "1": { "drawable": -1, "texture": 0 },
      "2": { "drawable": -1, "texture": 0 },
      "6": { "drawable": -1, "texture": 0 },
      "7": { "drawable": -1, "texture": 0 }
    }
  }
}

Default Outfits In Package

Outfit Assignment Behavior

If assignedStations is empty, the outfit is treated as available at every station. If it contains station IDs, the outfit only appears at matching stations.

Gear Wear

Gear wear is enabled by default in the uploaded 1.0.0 config.

Actual Wear Settings

Status Logic

Washer Behavior

Using a configured station washer cleans all configured outfits and services their wear state. If replaceExpiredAtWasher is true, expired gear is reset to a fresh set when processed at the washer.

SmartFires / z_fire

Cleanliness and exposure detection is handled in client_cleanliness.lua.

Actual Cleanliness Config

Hardcoded Exposure Tuning In 1.0.0

Status Labels

Exports Checked

• SmartFires: IsFireNearby(5.0), IsSmokeNearby(25.0)
• z_fire: getFiresInRange(coords, 5.0), getClosestFire(coords), getSmokeInRange(coords, 25.0), getClosestSmoke(coords)

Commands

File Reference

Troubleshooting

Station or Turnout Manager says you do not have permission

• Add add_ace group.admin atg.stationmanager allow to server.cfg.
• Confirm your player is in the admin group.
• Confirm Config.AdminAce has not been changed to a different ACE string.

Players cannot open station lockers

• Check Config.Duty.requireOnDutyForGearAccess.
• If Config.Framework.restrictAccess = true, confirm the player's job is listed in allowedJobs.
• Confirm the player is close enough to station coords.
• Make sure the station exists in station_data/stations.json.

Vehicle lockers do not work

• Confirm Config.VehicleGearAccess.enabled = true.
• Check that the vehicle model/spawn name exactly matches the key in vehicles.
• Make sure the vehicle is stopped if requireStopped = true.
• Driver seat access is blocked when blockDriverSeat = true.
• Make sure the turnout has vehicleAccess = true in the Turnout Manager.

Gear never gets dirty

• Confirm Config.Cleanliness.enabled = true.
• Enable only the fire system you actually run.
• Confirm smartFiresResource or zFireResource matches the resource folder name.
• Confirm the outfit has contaminationEnabled = true.
• Enable Config.Cleanliness.debug = true while testing.

Gear wear does not save

• Make sure oxmysql starts before ATG.
• Import sql/atg_gear_wear.sql.
• Confirm Config.WearAndTear.enabled = true and useSql = true.
• Check the SQL console for table or permission errors.

Outfit images are missing

• Place image files in html/images/.
• Use PNG, JPG, or WEBP.
• Update the image field in the Turnout Manager.
• The sample package references images/firefighter.png and images/command.png, which are not included in the uploaded package.

Rank data contains test information

rank_data/ranks.json stores standalone rank assignments for players when you are not using framework-provided ranks.

{}