Skip to content

Configuring the Menu

Agent BUB edited this page Oct 11, 2023 · 5 revisions

This menu has several configurable settings that are easily changed within the config.lua.
You can find a blank/original config.lua in the Resource section of this page.

When editing the config be careful not to delete or rename variables. Also do not remove {}, "", or anything of that nature.

Config File Variables

Config.MenuKey

This defines the key that opens the menu.
Default = 244 M
Controls Documentation

Config.requirePerms

When enabled (true), a user must have the ace permissions to open the menu.
Allow anyone to use = false [Default]
If using, add this to server.cfg:

  • add_ace identifier.steam:steamidhere use.ExtraMenu allow

You can get your steam id here: https://www.steamidfinder.com/
You can also use to grant perms:

  • add_ace group.groupName use.ExtraMenu allow

Config.locationOpen

When this is true you will need to input information in Config.locationMarker, as the menu will only work when a player walks over a marker on the map.
Allow from Anywhere = false [Default]
Use points defined in Config.positions

Config.commandOpen

When this is true you will be able to open the menu via the command defined on the next line.
Doesn't work with "locationOpen".
On = true
Off = false [Default]

Config.command

This defines the command used to open the extra menu when Config.commandOpen = true.
Default = extramenu

Config.commandOnly

When enabled the menu can only be opened with the command.
Default = false

Config.MenuOrientation

This defines which side of the screen the menu appears on.
Left = 0
Right = 1 [Default]

Config.MenuTitle

This defines what shows at the top of the menu.
Default = 0 [Default] | Player Name = 1 | Custom = 2
Default = The default title of the menu is 'Extras Menu'
Player Name = This is the name of the player
Custom = This is a custom title set by you at Config.MenuTitleCustom

Config.MenuTitleCustom

This defines a custom title for the menu.
For it to work the menu title config must be set to:
Config.MenuTitle = 2

Config.EnableCredits

This defines whether the credits tab appears in the menu.
On = 'true'
Off = 'false'
We would love it if you could leave them on, but we know sometimes it looks better to turn them off. :)

Config.DamageStopper

Enabling this means that vehicles will not be abled to change their extras when over the damage limit.
Note: Recommended to have this disabled when using "locationOpen", as you should have the locations at repair shops anyway.
Default = true

Config.DamageLimit

The max damage value a vehicle can have. Anything over this will result in the vehicle not being allow to change extras.
Default = 980

Config.CustomNames

This is where you define custom extras for certain vehicles.
Format:

{vehicle = 'spawncode', extra = {
    ['extra_number'] = 'custom name', ['extra_number'] = 'custom name'
}},

Example:

{vehicle = '19Charger', extra = {
    ['1'] = 'Ram Bar', ['2'] = 'Light Bar', ['3'] = 'Visor Lights'
}},

Config.enableLivery

Turns on (true)/off (false) the livery changer

Config.CustomLiveryNames

If you want livery names to display as something custom for certain vehicles.
Liveries start at 0, not 1
Format:

 {vehicle = 'spawncode', livery = {
    [livery_number] = 'custom name', [livery_number] = 'custom name'
}},

Example:

{vehicle = '19Charger', livery = {
    [0] = 'Sheriff', [1] = 'Police', [2] = 'Unmarked'
}},

Config.positions

Where markers (highlighted circles) will appear on the map if Config.locationOpen = true so that the menu can be opened when a player is within and vehicle and the marker.
Format:

{{Marker X, Marker Y, Marker Z, Marker Heading}, {Red, Green, Blue}, "Text for Marker"}

Note: Do not put the key to press in the text, it auto is added.
Example (Outside the Sheriff's Station):

{{1867.42, 3666.11, 32.80, 0},{36,237,157}, "Test"}