Vehicle Configs

Build your fleet with group defaults, per-vehicle profiles, and a single index file.

Vehicle and group profiles live under the resource config/ folder. GTM Siren merges settings from default → group → vehicle, so shared values stay in one place and exceptions stay where they belong.

The index

config/index.json lists every group and vehicle file to load:

{
  "groups": ["groups/default.json"],
  "vehicles": [
    "vehicles/ambulan.json",
    "vehicles/firetruk.json",
    "vehicles/lguard.json",
    "vehicles/police.json"
  ]
}

Add a new path here whenever you introduce a profile. Files not listed will not load.

Groups and vehicles

PathRole
config/groups/default.jsonShared fallback values
config/groups/*.jsonOptional shared presets for a class of vehicles
config/vehicles/<model>.jsonSettings for a specific vehicle model

Name vehicle files after the spawn model (for example police.json).

What a profile defines

Each profile describes the experience for that vehicle — lighting stages and patterns, siren tones, and related options in the GTM Siren format.

You do not need to author these by hand:

  • Visual Editor — design profiles visually on grandtheftmods.com
  • ELS Converter — bring existing ELS setups into GTM Siren format

Workflow

  1. Create or convert a profile.
  2. Place it under config/groups/ or config/vehicles/.
  3. Register it in config/index.json.
  4. Restart gtm-siren.

Start from the included examples, then grow the fleet with intention.