Vehicle Mods

Guide & instructions on vehicle mods (cosmetics/performance), pricing and so on.

Config.ModCategories

Defines the categories for sorting all mods from Config.Mods.

Config.ModCategories = {
    ['respray'] = {id = 'mod_respray', title = 'Respray', position = 'top-left', icon = 'https://i.ibb.co/T0q9bgj/mod-respray.png'},
    ['bodyworks'] = {id = 'mod_bodyworks', title = 'Body Works', position = 'top-left', icon = 'https://i.ibb.co/YZkqQRj/mod-bodyworks.png'},
    ['chassis'] = {id = 'mod_chassis', title = 'Chassis', position = 'top-left', icon = 'https://i.ibb.co/1XGXthM/mod-chassis.png'},
    ['enginebay'] = {id = 'mod_enginebay', title = 'Engine Bay', position = 'top-left', icon = 'https://i.ibb.co/ngv65rV/mod-enginebay.png'},
    ['exterior'] = {id = 'mod_exterior', title = 'Exterior', position = 'top-left', icon = 'https://i.ibb.co/wz2s9mG/mod-exterior.png'},
    ['interior'] = {id = 'mod_interior', title = 'Interior', position = 'top-left', icon = 'https://i.ibb.co/ZKZS3mP/mod-interior.png'},
    ['lights'] = {id = 'mod_lights', title = 'Lights', position = 'top-left', icon = 'https://i.ibb.co/P56HBBg/mod-lights.png'},
    ['wheels'] = {id = 'mod_wheels', title = 'Wheels', position = 'top-left', icon = 'https://i.ibb.co/8BbyF7y/mod-wheels.png'},
    ['performance'] = {id = 'mod_performance', title = 'Performance', position = 'top-left', icon = 'https://i.ibb.co/MgPCg06/mod-engine.png'}
}
-- Type: Table

Usage: Each category contains the following properties:

  • id: (String) The unique identifier for the category. Do not edit this!

  • title: (String) The displayed title of the category in the menu.

  • position: (String) The position of the category in-game. ('top-left' or 'top-right' or 'bottom-left' or 'bottom-right').

  • icon: (String) FontAwesome icon or URL to the icon image displayed in the menu.

Config.DisableMods

Specifies mods that are disabled by default. This array can be customized to include specific mods you want to disable. By default, common weapon mods are disabled, but you can add or remove mods as needed.

Usage:

  • Each entry: (String) Represents the name of a mod that will be disabled. You can add specific mods to this array if you prefer to disable them. For example, ['Primary Weapons'] disables primary weapon mods.

Config.Mods

Defines all available mods for vehicles. Each mod is controlled by several properties that determine its behavior, appearance and installation process in the game. Customize these mods as needed.

Config.Mods (Click to expand)

Usage: Each mod entry contains:

  • label: (String) Display name for the mod. Used as a fallback if the game label cannot be retrieved.

  • modType: (String or Integer) Identifier the mod. Do not edit this value!

  • price: (Integer) Base price for the mod before escalation price and other price modifiers. If the price attribute is absent, it is defined in the variants attribute for each variant option.

  • category: (String) The category to which the mod option belongs. Refer to Config.ModCategories for available categories. Some categories are set to '', do not touch these!

  • point: (String) Specifies the 3rd-eye target position on the vehicle for item-based installations:

    • 'rear': Rear end of the vehicle.

    • 'front': Front end of the vehicle.

    • 'engine': Engine of the vehicle.

    • 'wheels': Any closest wheel.

    • 'vehicle': The whole vehicle.

  • prop: (Table) Properties for the prop/object created during item-based installations:

    • model: (String) Model name of the prop.

    • pos: (Table) Position of the prop relative to the player (offset).

    • rot: (Table) Rotation offsets for the prop.

  • anim: (Table) Animation details for idle and installation:

    • idle: (Table) the idle animation when carrying the spawned prop.

    • install: (Table) the install animation when installing the selected mod variant.

    Each contains the following properties:

    • dict: (String) Animation dictionary.

    • name: (String) Animation name.

    • blendIn: (Float) Blend-in time.

    • blendOut: (Float) Blend-out time.

    • duration: (Integer) Duration of the animation.

    • flags: (Integer) Animation flags.

  • variants: (Table) Contains different variations of a mod, each with its label, index, and price. Each variant contains:

    • label: (String) Display name of the variant.

    • index: (Integer) Identifier for the variant. Do not edit this value!

    • price: (Integer) Price for the variant.

Config.ColorCategories

Defines color categories used with Config.Colors. Each category specifies properties such as name, label, paintType, and price. Customize these categories to fit your application needs.

Usage: Each color category contains the following properties:

  • name: (String) Name of the category. Do not change this value as it identifies the category in the system.

  • label: (String) User-defined label for the category, used for display purposes.

  • paintType: (Integer) GTA paint type for the category. Do not change this value!

  • price: (Integer) Additional price for using colors in this category. This price is added on top of the base price defined in Config.Mods.

Config.Colors

Defines the available color options for each Config.ColorCategories category. Each color includes properties such as label and index. Customize these colors as needed.

Config.Colors (click to expandd)

Usage: Each color category is defined in Config.ColorCategories, and the corresponding colors are specified here:

  • label: (String) The display name of the color.

  • index: (Integer) The GTA index for the color.

Last updated