Transfer Ownership

Shorthand to transfer vehicle ownerships easier.

Transfer vehicle ownership between players using a single export. Note that this is server-sided only.

For advanced use cases where you need to pass custom vehicle data, target a specific garage, or initialize an unowned vehicle, use the SetNewOwner export directly. See the Exports page for details.

#Quick Start

local success, reason = exports.zyke_garages:TransferOwnership(
    "ABC 1234",      -- plate
    "char1:abc123"   -- new owner's identifier (citizenid for QB, identifier for ESX)
)

The script resolves the plate to a VIN internally, validates that the vehicle isn't impounded, transfers ownership, rotates keys, and assigns a valid garage — all in one call.

#Parameters

Parameter	Type	Description
`plate`	`string`	The vehicle's license plate
`newOwner`	`string`	Target character identifier (citizenid for QB, identifier for ESX)

Returns: boolean, string? - success, failure reason

#Failure Reasons

Reason	Meaning
`"missingArguments"`	`plate` or `newOwner` was not provided
`"noVehicleFound"`	No vehicle found with that plate
`"vehicleIsImpounded2"`	Vehicle is currently impounded
`"noPlayer"`	Target identifier is invalid

#Example: Vehicle Dealership

RegisterNetEvent("myDealership:purchaseVehicle", function(plate)
    local source = source
    local identifier = Z.getIdentifier(source)

    local success, reason = exports.zyke_garages:TransferOwnership(plate, identifier)

    if success then
        TriggerClientEvent("myDealership:purchaseComplete", source)
    else
        print("Transfer failed: " .. (reason or "unknown"))
    end
end)

#Example: Admin Command

RegisterCommand("transferveh", function(source, args)
    local plate = args[1]
    local targetId = tonumber(args[2])
    if (not plate or not targetId) then return end

    local targetIdentifier = Z.getIdentifier(targetId)
    local success, reason = exports.zyke_garages:TransferOwnership(plate, targetIdentifier)

    print(success and "Transfer complete" or ("Failed: " .. (reason or "unknown")))
end, true)