Studios
Electrical Jobelec-2.jpg

Installation

Electrical JobQBCore · Qbox · ESX
PAGE 02 OF 07  ·  OVERVIEW → INSTALLATION → CONFIGURATIONdocs.glitchstudios.dev
Browse docs
cfgQuick start · server.cfg order
# start your framework after its own dependencies
ensure ox_lib
ensure ox_target
ensure glitch-abstraction
ensure glitch-minigames
ensure glitch-electricalJob

Requirements#

Framework qbx_core (Qbox) is the tested framework. ESX and QBCore go through glitch-abstraction too, but are not tested.
Server OneSync enabled.
Resources ox_lib, ox_target
Glitch Studios glitch-abstraction (GitHub) for framework, inventory, notifications, progress bars and XP. glitch-minigames (GitHub) for the repair minigames. Both are free and both are required.
Database None. Open deposits are kept in the resource KVP store.
Optional glitch-xpSystem (levels, XP and perks), sd-phone (crews), glitch-uiElements (task list), qbx_vehiclekeys or qb-vehiclekeys (van keys), rpemotes (shock emote), glitch-admin (job log), glitch-pauseMenu (map legend names), bob74_ipl (DLC interior calls), glitch-poolcleaning (net event guard)

Tested with qbx_core 1.24.0, ox_lib 3.40.0, ox_target 1.17.2, ox_inventory 2.48.0, glitch-abstraction 1.1.0, glitch-minigames 2.5.0, glitch-xpSystem 2.1.0, sd-phone 1.0.10 and bob74_ipl, on game build 3751.

Each optional resource is checked at run time, and its feature is skipped when the resource is not running.

Installation steps#

  1. Put the glitch-electricalJob folder in your resources folder. The folder name is case-sensitive.

  2. Add the bonus items to your inventory if you want them. Items the inventory does not know are skipped, and the server console names them at start. For ox_inventory, in data/items.lua:

    ['copper'] = {
        label = 'Copper',
        weight = 100,
        stack = true,
    },
    ['metalscrap'] = {
        label = 'Metal Scrap',
        weight = 100,
        stack = true,
    },
    ['atmmotherboard'] = {
        label = 'ATM Motherboard',
        weight = 500,
        stack = true,
    },
    

    The package has no item images. Use your own PNGs named after the items.

  3. With glitch-xpSystem, add an electrical category (levels 1 to 20) to its config.lua, and make sure the perk ids in config.Perks.keys match the effect ids in your skill tree. Set config.useXpSystem = false to run without XP.

  4. Add to server.cfg, after ox_lib, ox_target and your framework:

    ensure glitch-abstraction
    ensure glitch-minigames
    ensure bob74_ipl
    ensure glitch-electricalJob
    

    Leave out bob74_ipl if you do not use it. Optional resources such as glitch-xpSystem and sd-phone can start before or after the job.

  5. Edit shared/config-main.lua (depot, deposit, pay), shared/config-locations.lua (call sites) and shared/locale.lua (player text). The bank titles in the package are Sydney place names, so rename them to suit your city.

  6. Restart the server, walk up to the depot NPC (the Electrical blip) and pick Start Working Solo or Start Working In A Group.

No ACE permissions are needed. /resetelectricaljob is open to every player and only resets their own call.

[!NOTE] The stream/ladder folder replaces the GTA model prop_byard_ladder01 and the map drawables dt1_15_ladder_003 and dt1_15_ladder_009 with this job's ladder. Every resource on the server that uses those models gets the new look. Delete the folder if that clashes with another resource; the job still works with the stock ladder.

Updating#

Replace everything except shared/config-main.lua, shared/config-locations.lua and shared/locale.lua, then compare your copies with the new ones and copy over any new settings. Open deposits stay in the KVP store across updates.

Coming from a version before 2.0.0, several settings changed:

Before 2.0.0 Now
config.usingPickleXP config.useXpSystem
config.HesitCompleteUI config.HeistCompleteUI
config.lightpoleLocations Removed. Light pole calls work on any pole of a model in config.Posts.
config.mloSpecialEvent, mloSpecialEventTwo, mloSpecialEventThree Removed

The shipped defaults for config.payLevels, bonusRatio (13) and stolenToolsFine (50) are lower than in older packages, so check the values you carried over.