Início › Documentação › Exports · origen_garages

Exports · origen_garages

Todos os exports estão registados com o nome de recurso origen_garages. As secções abaixo separam-nos consoante o lado em que são executados.

Exports do servidor

impoundVehicle(plate) → boolean

Define o estado de um veículo como IMPOUNDED na tabela de veículos da framework.

lua
exports['origen_garages']:impoundVehicle(plate)
Parâmetro Tipo Descrição
plate string Matrícula do veículo

Exemplo:

lua
RegisterCommand('impound', function(source, args)
    local plate = args[1]
    if plate then
        exports['origen_garages']:impoundVehicle(plate)
    end
end, true)

Exports do cliente

openExternalGarage(id, coords)

Abre a interface da garagem com o ID indicado em coordenadas personalizadas. Se o jogador estiver num veículo, guarda-o na garagem em vez de abrir a interface de recolha.

lua
exports['origen_garages']:openExternalGarage(id, coords)
Parâmetro Tipo Descrição
id number ID na base de dados da garagem a abrir
coords vector3 | nil Coordenadas do mundo usadas como ponto de saída exterior

Exemplo — abrir uma garagem a partir de uma interação do ox_target:

lua
exports['ox_target']:addBoxZone({
    coords = vector3(100.0, 200.0, 30.0),
    size = vector3(1.5, 1.5, 2.0),
    options = {
        {
            label = 'Open Garage',
            onSelect = function()
                exports['origen_garages']:openExternalGarage(1, vector3(100.0, 200.0, 30.0))
            end,
        }
    }
})

impoundVehicle(plate) → boolean

Invólucro do lado do cliente: dispara um callback de servidor (origen_garages:cb:impoundVehicle) e aguarda o resultado.

lua
exports['origen_garages']:impoundVehicle(plate)
Parâmetro Tipo Descrição
plate string Matrícula do veículo

toggleFurnitureMenu(state)

Abre ou fecha o menu de colocação de mobiliário dentro de um interior de garagem.

lua
exports['origen_garages']:toggleFurnitureMenu(state)
Parâmetro Tipo Descrição
state boolean | nil true = abrir, false / nil = fechar

startDragCam(entity, radiusOptions)

Inicia a câmara de inspeção de veículos sobre a entidade indicada. O jogador pode rodar a câmara com o rato, fazer zoom com a roda e abrir ou fechar as portas com Espaço.

lua
exports['origen_garages']:startDragCam(entity, radiusOptions)
Parâmetro Tipo Descrição
entity integer Handle da entidade do veículo a inspecionar
radiusOptions table | nil Definições opcionais da câmara (ver abaixo)

Campos de radiusOptions:

Campo Por omissão Descrição
initial 5.0 Raio inicial da câmara em metros
min 2.5 Distância mínima de zoom
max 10.0 Distância máxima de zoom
scrollIncrements 0.5 Passo de zoom por cada tick da roda
firstPersonEnabled false Permite alternar para primeira pessoa com V

Exemplo:

lua
exports['origen_garages']:startDragCam(vehicle, {
    initial             = 6.0,
    min                 = 4.5,
    max                 = 8.0,
    scrollIncrements    = 0.3,
    firstPersonEnabled  = true,
})

stopDragCam()

Pára a câmara de inspeção, faz esbater o ecrã, destrói a câmara e a entidade do veículo gerado, e devolve o foco à NUI.

lua
exports['origen_garages']:stopDragCam()