Skip to content
This repository has been archived by the owner on Jul 19, 2024. It is now read-only.

Latest commit

 

History

History
190 lines (163 loc) · 7.49 KB

README.md

File metadata and controls

190 lines (163 loc) · 7.49 KB

qbx_garages

ATTENTION: THIS SCRIPT USES THE LATEST VERSION OF THE RADIALMENU AND QBX-CORE

This is a qb-garages script that uses the radialmenu to retrieve and park vehicles. Almost everything is fully customizable to the last bit!

For screenshots scroll down

Dependencies

Optional Dependencies

Installation

Drag 'n Drop replace for qbx_garages.

  • Delete qbx_garages.
  • Drag the downloaded qbx_garages folder into the [qbx] folder.
  • If you want to use the latest features, apply patch1.sql to your DB

IMPORTANT CHANGE!!!

  • Remove @qbx_garages/config.lua and add the respective local Garages = require '@qbx_garages.config.shared'.Garages and local HouseGarages = require '@qbx_garages.config.shared'.HouseGarages to whichever client or server script you are needing.

OR

  • Change @qbx_garages/config.lua to @qbx_garages/compat/shared.lua in the fxmanifest.lua

Features

  • Public Garages
  • House Garages
  • Gang Garages
  • Job Garages
  • Depot Garages
  • Blips and names
  • Custom DrawText
  • Water Garages
  • Aircraft Garages
  • Added Fake Plate Check

Screenshots

( Note: Add New Images )

Config Example

Everything that says optional can be omitted.
 -- GARAGE CONFIGURATION EXAMPLE :
    ['somegarage'] = {
        ['Zone'] = {
            ['Shape'] = { -- Create a polyzone by using '/pzcreate poly', '/pzadd' and '/pzfinish' or '/pzcancel' to cancel it. the newly created polyzone will be in txData/QBCoreFramework_******.base/polyzone_created_zones.txt
            vector2(-1030.4713134766, -3016.3388671875),
            vector2(-970.09686279296, -2914.7397460938),
            vector2(-948.322265625, -2927.9030761718),
            vector2(-950.47174072266, -2941.6584472656),
            vector2(-949.04180908204, -2953.9467773438),
            vector2(-940.78369140625, -2957.2941894532),
            vector2(-943.88732910156, -2964.5512695312),
            vector2(-897.61529541016, -2990.0505371094),
            vector2(-930.01025390625, -3046.0695800782),
            vector2(-942.36407470704, -3044.7858886718),
            vector2(-952.97467041016, -3056.5122070312),
            vector2(-957.11712646484, -3057.0900878906)
            },
            ['minZ'] = 12.5,  -- min height of the parking zone, cannot be the same as maxZ, and must be smaller than maxZ
            ['maxZ'] = 20.0,  -- max height of the parking zone
            -- VERY IMPORTANT: Make sure the parking zone is high enough - higher than the tallest vehicle and LOW ENOUGH / touches the ground (turn on debug to see)
        },
        label = 'Hangar', -- label displayed on phone
        type = 'public', -- 'public', 'job', 'depot' or 'gang'
        showBlip = true, -- optional, when not defined, defaults to false
        blipName = 'Police', -- otional
        blipNumber = 90, -- optional, numbers can be found here: https://docs.fivem.net/docs/game-references/blips/
        blipColor = 69, -- optional, defaults to 3 (Blue), numbers can be found here: https://docs.fivem.net/docs/game-references/blips/
        blipcoords = vector3(-972.66, -3005.4, 13.32), -- blip coordinates
        job = 'police', -- optional, everyone can use it when not defined
        vehicleCategories = {'helicopter', 'plane'}, -- categories defined in VehicleCategories
        drawText = 'Hangar', -- the drawtext text, shown when entering the polyzone of that garage
        ParkingDistance = 10.0 -- Optional ParkingDistance, to override the global ParkingDistance
        SpawnDistance = 5.0 -- Optional SpawnDistance, to override the global SpawnDistance
        debug = false -- Optional, will show the polyzone and the parking spots, helpful when creating new garages. If too many garages are set to debug, it will not show all parking lots
        ExitWarpLocations: { -- Optional, Used for e.g. Boat parking, to teleport the player out of the boat to the closest location defined in the list. 
            vector3(-807.15, -1496.86, 1.6),
            vector3(-800.17, -1494.87, 1.6),
            vector3(-792.92, -1492.18, 1.6),
            vector3(-787.58, -1508.59, 1.6),
            vector3(-794.89, -1511.16, 1.6),
            vector3(-800.21, -1513.05, 1.6),
        } 
    },

parking vehicle using target

local garageName = 'pdgarage'
    exports.ox_target:addBoxZone({
        name = garageName
        coords = vector3(469.51, -992.35, 26.27),
        size = vec3(0.2, 0.2, 1.5),
        rotation = 0,
        debug = true,
        options = {
            {
                icon = 'parking',
                label = 'Park Vehicle',
                onSelect = function()
                    TriggerEvent('qb-garages:client:ParkLastVehicle', garageName)
                end,
                canInteract = function(_, distance)
                    return distance <= 2.5
                end
            },
        },
    })

New Phone Tracking Using Export

Replace:

RegisterNUICallback('track-vehicle', function(data, cb)
    local veh = data.veh
    if findVehFromPlateAndLocate(veh.plate) then
        QBCore.Functions.Notify("Your vehicle has been marked", "success")
    else
        QBCore.Functions.Notify("This vehicle cannot be located", "error")
    end
    cb("ok")
end)

With:

RegisterNUICallback('track-vehicle', function(data, cb)
    local veh = data.veh
    if veh.state == 'In' then
        exports['qb-garages']:TrackVehicleByPlate(veh.plate)
        TriggerEvent('qb-phone:client:CustomNotification',
            "GARAGE",
            "GPS Marker Set!",
            "fas fa-car",
            "#e84118",
            5000
        )
        cb("ok")
    elseif veh.state == 'Out' then
        exports['qb-garages']:TrackVehicleByPlate(veh.plate)
        TriggerEvent('qb-phone:client:CustomNotification',
            "GARAGE",
            "GPS Marker Set!",
            "fas fa-car",
            "#e84118",
            5000
        )
        cb("ok")
    else
        TriggerEvent('qb-phone:client:CustomNotification',
            "GARAGE",
            "This vehicle cannot be located",
            "fas fa-car",
            "#e84118",
            5000
        )
        cb("ok")
    end
end)

Credits

  • ARSSANTO - For making code style suggestions and helping me improve the performance.
  • JustLazzy - I used part of his qb-garages script.
  • bamablood94 - I used part of his qb-garages script.
  • QBCore Devs - For making an awesome framework and enabling me to do this.
  • QBCore Community - Thank you so much for everyone who's been testing this!
  • JDev - Maintaining the resource and handing the reigns to me

Issues, Suggestions & Support

  • This resource is still in development. All help with improving the resource is encouraged and appreciated
  • Please use the GitHub issues system to report issues or make suggestions
  • When making suggestions, please keep [Suggestion] in the title to make it clear that it is a suggestion, or join the Discord
  • Discord: https://discord.gg/3CXrkvQVds