Skip to content

jimathy/jim-jobgarage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jim-jobgarage

Job garage for grabbing job related vehicles


What is this?

  • This is a dynamic system for pulling out job and grade locked vehicles
  • It's not for parking and saving your vehicles, that is done in your garage scripts

If you need support I have a discord server available, it helps me keep track of issues and give better support.

https://discord.gg/xKgQZ6wZvS

If you think I did a good job here, consider donating as it keeps by lights on and my cat fat/floofy:

https://ko-fi.com/jixelpatterns


Installation

  • I always recommend starting my scripts AFTER [qb] not inside it as it can mess with any dependancies on server load
  • I have a separate folder called [jimextras] (that is also in the resources folder) that starts before any scripts would use it.
  • This ensure's it has everything it requires before trying to load
  • Example of my load order:
# QBCore & Extra stuff
ensure qb-core
ensure [qb]
ensure [standalone]
ensure [voice]
ensure [defaultmaps]
ensure [vehicles]

# Extra Jim Stuff
ensure [jimextras]
ensure [jim]

Location Setup

  • Vehicle Modifiers - These can be used for making sure the vehicles comes out exactly how you want it to

    • CustomName = "Police Car", this will show a custom override name for your vehicles so you don't need to add them to your vehicles.lua
    • rank = { 2, 4 }, This specifes which grades can see it, and only these grades
    • grade = 4, This specifies the lowest grade and above that can see the vehicle
    • colors = { 136, 137 }, This is the colour index id of the vehicle, Primary and Secondary in that order
    • bulletproof = true, This determines if the tyres are bullet proof (don't ask me why, I was asked to add this)
    • livery = 1, This sets the livery id of the vehicle, (most mod menus would number them or have them in number order) 0 = stock
    • extras = { 1, 5 }, -- This enables the selected extras on the vehicle
    • performance = "max", -- This sets the car upgrades all to MAX levels
    • performance = { 2, 3, 3, 2, 4, true }, -- This allows more specific settings for each upgrade level, in order: engine, brakes, suspension, transmission, armour, turbo
    • trunkItems = { }, -- Use this to add items to the trunk of the vehicle when it is spawned
  • Example:

Locations = {
	{	zoneEnable = true, -- disable if you want to hide this temporarily
		job = "mechanic", -- set this to required job grade
		garage = {
			spawn = vec4(-179.34, -1285.27, 30.83, 89.24),  -- Where the vehicle will spawn
			out = vec4(-177.1, -1282.25, 31.3, 179.01),  -- Where you select the vehicles from
			ped = { -- Add a "ped" table to make a ped spawn instead of the parking meter
				model = `G_M_M_ChemWork_01`, -- set ped model here
				scenario = "WORLD_HUMAN_CLIPBOARD" -- set scenario here
			},
			list = {  -- The list of cars that will spawn
				["cheburek"] = {
					CustomName = "Police Car",
					colors = { 136, 137 }, -- Color index numbers { primary, secondary },
					grade = 4, -- Job Grade Required to access this vehicle
					performance = { 2, 3, 3, 2, 4, true },
					trunkItems = {
						{ name = "heavyarmor", amount = 2, info = {}, type = "item", slot = 1, },
						{ name = "empty_evidence_bag", amount = 10, info = {}, type = "item", slot = 2, },
						{ name = "police_stormram", amount = 1, info = {}, type = "item", slot = 3, },
					},
				},
				["burrito3"] = { },  -- Don't need to add any modifiers/restrictions
			},
		},
	},
},
  • This can also be used to add new locations
TriggerEvent("jim-jobgarage:server:syncAddLocations", {
job = "mechanic",
garage = {
		spawn = vec4(-179.34, -1285.27, 30.83, 89.24),
		out = vec4(-177.1, -1282.25, 31.3, 179.01),
		ped = {
			model = `G_M_M_ChemWork_01`,
			scenario = "WORLD_HUMAN_CLIPBOARD"
		},
		list = {
			["cheburek"] = {
				CustomName = "Police Car",
				colors = { 136, 137 },
				grade = 4,
				performance = { 2, 3, 3, 2, 4, true },
				trunkItems = {
					{ name = "heavyarmor", amount = 2, info = {}, type = "item", slot = 1, },
					{ name = "empty_evidence_bag", amount = 10, info = {}, type = "item", slot = 2, },
					{ name = "police_stormram", amount = 1, info = {}, type = "item", slot = 3, },
				},
			},
			["burrito3"] = { },
		},
	},
})

Changelog

v2.0:

- Ported to use jim_bridge
	- now supports qb, qbox, esx and ox_core
- Fixes trunk items

v1.4.3:

- Fix possible crash when restarting a script that uses jobgarage
- Add workaround for people who don't update their garage config in external scripts

v1.4.2:

- Now with less errors and real setup info

v1.4.1:

- Fix script not retrieving external locations on playerload

v1.4:

- Locale support
- Support for OX_Lib context menu
- Trunk items fix
- Add ability to add garages from other scripts on the fly

About

Job garage for grabbing job related vehicles

Resources

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Languages