Denver Studio - Docs

Configuração das Funções

Configuração das funções customizáveis do sistema DS-Homes

Configuração das Funções

É necessário configurar todas as funções presentes no arquivo:

/config/functions.lua

Criação de Veículos

A função de criação de veículos deve ser executada no lado do servidor (server-side), pois o script lida diretamente com a entidade do veículo para controlar o gerenciamento em dimensões, spawn e persistência.

Objeto do Veículo

A função de criação de veículos recebe, como primeiro parâmetro, o objeto do veículo retornado pela função:

Adapter:getUserVehicles()

Você pode adicionar mais informações a esse objeto para reutilizá-las dentro da função de criação, quando o veículo for spawnado. Dessa forma, o desenvolvedor pode incluir dados personalizados (como placa, cor, tuning, posição, etc.) antes de instanciar o veículo.

Evento de Criação no Servidor

Após o jogador escolher um veículo dentro da garagem, é disparado um evento server-to-server:

ds-homes:createVehicle

Você deve ouvir esse evento em outro script para recriar o veículo do jogador fora da garagem, permitindo que ele o utilize normalmente no mundo do jogo.

Esse sistema foi projetado para garantir um melhor gerenciamento dos veículos pelo desenvolvedor, permitindo:

  • Armazenar a entidade do veículo em outros scripts
  • Controlar seu estado e variáveis personalizadas
  • Manter uma organização mais clara no fluxo de criação e manipulação dos veículos

Exemplo de Implementação

Abaixo, um exemplo simples de como escutar o evento e criar o veículo:

AddEventHandler("ds-homes:createVehicle", function(source, vehicleData)
    local playerCoords = GetEntityCoords(GetPlayerPed(source))
    local veh = CreateVehicle(
        vehicleData.model,
        playerCoords.x,
        playerCoords.y,
        playerCoords.z,
        vehicleData.heading,
        true,
        false
    )

    vehicleData.entity = veh
    SetPedIntoVehicle(GetPlayerPed(source), veh, -1)
    print(("Veículo %s criado para o jogador %s!"):format(vehicleData.model, source))
end)

Resumo da Configuração

Configure as funções

Edite o arquivo /config/functions.lua com as funções do seu framework

Implemente a criação de veículos

Certifique-se de que a criação do veículo seja feita no servidor (somente na função de criação de veículos)

Configure o evento

O evento ds-homes:createVehicle deve ser ouvido e tratado para recriar o veículo fora da garagem

Personalize conforme necessário

Personalize o objeto vehicleData conforme a sua necessidade