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.luaCriaçã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:createVehicleVocê 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