Configuration

Setting up config

Triggers

This triggers section is used for each of the supported frameworks. You can change these to suit for framework if you need too. You may also need to modify events and functions in the bridge folder if using custom frameworks.

Triggers screenshot

Admin Options

The admin options section is used to allow certain ace permissioned user access to use certain commands.

enable is used to enable or disable the admin commands. ranks are the ace perms given in the server.cfg so set these to whatever you wish so your staff have access to them or not 🤣 inputType is used for the type of input given for the commands. Currently the standard "command" format is supported but that maybe likely change in due course.

commands is used for the commands in the script with the correct string. If you know basic scripting you can add more to your commands list and add it to the command section of the script. Found in client > commands.lua

Admin Options screenshot

Debug

Debug is used to enable or disable debug prints. These help with allowing better support and querying any problems you may have. for instance with an edit you made to a branch in the config and making sure it's added correctly. When asking for support you will likely be asked to make this option true to help with fixing the problem at hand.

Debug screenshot

Default Levels

Default Levels are used as the "standard" level options if you don't want to use custom levels for each branch. You can increase the amount of levels used by default by adding more of the default level entries underneath. title is used for the label of the level that branch is currently on. You can replace the Lang[default option] with your own string or change it in the language.lua file minxp is minimum xp for that level to register. (keep set to 00 for level 1 as to not break the script) maxxp is the maximum xp for that level and when on the next whole number it will either go to the next level or max out the levels available to that branch.

Default Levels screenshot

Lose Branch Knowledge

Lose Branch Knowledge when enabled is used to have xp decrease over time. (basically degradation like food items can have in some inventories)

enable is to enable or disable the xp loss feature.

notification if true will give a notification when they lose some xp. The message given in the notification can be changed in language.lua file.

update is how often you want it to update the branches so they get deducted xp. Default is every 15 minutes. I wouldn't recommend going lower than 15 minutes per update cycle.

I believe every 30-60 minutes would be better in conjunction with low min and max xp values for removal so xp isn't heavily grinded and then taken back quickly. So it could actually have a chance to be used on tasks (like bank robbery checks for hacking) or spent through some other form like a shop/ ped "intel" for heists (item list maybe) as an example or maybe treasure spot locations on a notepad from gaining enough robbery and diving xp levels.

Lose Branch Knowledge screenshot

The knowledge system uses a menu of sorts to display the information for the branches. type is used to determine which type of menu is used (ox_lib/ qb_menu) sort is used for if you want it sorted by highest xp amount ('xp') or through alphabetic order ('alphabetic')

default icon is used for when the branches don't have a icon given to them in the config.

ox is used for all options related to ox_lib.

type is used for changing the styling of the list of branches to 'context' or 'menu' colour is used to define the look of the progress bar in either option.

position is to decide where the menu goes.

branch xp info if type is 'menu' and this is set to true you will get a little more data about the branch above the menu.

You can find more icons that are free and usable in the menus here

Menu screenshot

Knowledge Title

knowledge title is for the title used for the header of the list.

Knowledge Branch screenshot

Chat Command

enable is used to enable the command for people to check their branches levels/ xp amounts.

command name is the string used for the user to open their branches list.

Chat Command screenshot

Notification

enable is used to enable standard notifications when gaining, "spending" or loosing xp (this isn't affected by the lose branch knowledge option)

notify type is for choosing which notification system you wish to use.

Default options are : ox, okok, qb and esx

To add other options look into the notification triggers in the bridge folder. bridge > client > utilities.lua or bridge > server > framework.lua

email

enable is to enable sending emails for leveling up.

type is for what type of phone is used for ALL email options.

Branches

lockpicking is the name of the branch when using the exports for adding, removing or checking for the levels of that branch. enable to enable or disable the branch so it can be in used or not. (if being turned off after being enabled and updated your xp branches it will remove the branch from each users branch list reducing amount of data sent and making it slightly more efficient.)

title Is what is used in the list for the branches title. I.E. Lockpicking and Hotwiring.

icon is used to choose the branches own icon which is used in the list. IF is left as blank in the config it will use the default option.

You can find more icons that are free and usable in the menus here

custom levels if not marked/ commented out then it will use the custom levels as your level choice for that branch.

Custom Levels

title is used for the label of the level that branch is currently on. minxp is minimum xp for that level to register. (keep set to 00 for level 1 as to not break the script) maxxp is the maximum xp for that level and when on the next whole number it will either go to the next level or max out the levels available to that branch.

Messages

enable is used to enable custom notifications (standard or email based )

notify type is used to choose what type of notification you want to to use. ("notification" for standard or "email" for email)

positive is used for when you go higher than that xp amount. The player will get a message telling them the message.

negative is used for when you go lower than that xp amount. The player will get a message telling them the message.

If using notification then you won't need to worry about the sender. If your using a notification option that has a title then the subject will be used as the title.

Branches - Lockpicking screenshot - Custom Levels enabled
Branches - Lockpicking screenshot - Custom Levels marked out

Last updated