Configuração das Funções

O arquivo config/functions.lua contém o Adapter — a ponte entre o DS-Homes e o framework do seu servidor. Cada função deve ser adaptada para o seu vRP/framework.

Funções do Adapter

Jogador

Dinheiro

Coins (Moeda Alternativa)

Inventário

Veículos / Garagem

Os veículos dentro do interior da garagem são spawnados client-side como entidades locais (não-networked) para preview. O servidor apenas fornece a lista de veículos via getUserVehicles. O spawn do veículo no mundo (ao sair da garagem) é responsabilidade do spawnPlayerVehicle.

Fluxo da Garagem

1. Jogador se aproxima do marcador da garagem e aperta E
2. Jogador é teleportado para o interior da garagem em um routing bucket privado
3. Client busca a lista de veículos via Adapter:getUserVehicles()
4. Client spawna os veículos localmente (não-networked) nas posições definidas em garageSpots
5. Jogador entra em um veículo
6. Client deleta todos os veículos de preview
7. Jogador sai do routing bucket privado
8. Adapter:spawnPlayerVehicle() é chamada para spawnar o veículo selecionado no mundo

Eventos Server

O DS-Homes dispara eventos server que outros scripts podem ouvir:

ds-homes:storeVehicle

Disparado quando o jogador aperta E no blip da garagem dentro de um veículo.

RegisterNetEvent('ds-homes:storeVehicle', function(plate, model, netId, propertyName)
  -- plate: placa do veículo (string)
  -- model: hash do modelo (number)
  -- netId: network ID (number)
  -- propertyName: nome da propriedade (string)
end)

ds-homes:spawnVehicle

Disparado pelo Adapter:spawnPlayerVehicle quando o jogador seleciona um veículo na garagem.

AddEventHandler('ds-homes:spawnVehicle', function(source, user_id, vehicleData)
  -- source: source do jogador (number)
  -- user_id: ID do jogador (number)
  -- vehicleData: {model, mods} (table)
end)

Comando de Debug

Toggle de debug via console do servidor (sem reiniciar):

dshomes:debug

Limite de Propriedades

function getMaxProperties()
  return 5
end

Altere o retorno para definir o número máximo de propriedades por jogador.