Skip to main content

Funções e Validações em Client do Trunkin

Nesta seção, vamos detalhar as principais funções que compõem a lógica do Trunkin. Essas funções são responsáveis por validar as condições para que o jogador possa acessar ou sair do porta-malas, bloquear controles durante o uso e gerenciar permissões com base no estado do veículo e do jogador.
📁 dk_trunkin > config > client > functions.lua

1. Verificação do Estado do Veículo

isUnlocked

Verifica se o veículo está destrancado. Retorno: true se o veículo estiver destrancado, false caso contrário.
dk_trunkin/config/client/functions.lua

isVehicleAllowed

Filtra o veículo com base no modelo e na classe.
  • Se o modelo estiver na lista de disabledModelTrunk, o acesso é negado.
  • Se a classe do veículo estiver bloqueada em blockedClasses, o acesso também é negado.
dk_trunkin/config/client/functions.lua

2. Bloqueio de Controles

A função blockControls desativa uma série de controles enquanto o jogador está dentro do porta-malas. Isso impede ações indesejadas que poderiam interferir na experiência ou causar conflitos com outras funcionalidades.
dk_trunkin/config/client/functions.lua

3. Gerenciamento de Permissões para Acesso

toggleTrunkPermission

Verifica se o jogador pode entrar ou sair do porta-malas, levando em consideração diversos fatores:
  • Estado do jogador (morto ou no modo sequestro).
  • Existência do porta-malas (verificando os ossos “boot” e “bonnet” ou a presença de um offset customizado).
  • Estado do veículo (motor, integridade e se está na água).
  • Se o veículo está destrancado e permitido pela filtragem.
Se alguma condição falhar, uma notificação é exibida, e a função retorna false.
dk_trunkin/config/client/functions.lua

4. Ações ao Entrar e Sair do Porta-malas

As funções a seguir são acionadas quando o jogador entra ou sai do porta-malas.
Você pode personalizar essas funções para adicionar estados ou executar ações adicionais (como invisibilidade ou alteração de comandos).

onEnterTrunk

Executada ao entrar no porta-malas.
Exemplo: Marcar o estado do jogador como “dentro do porta-malas”.
dk_trunkin/config/client/functions.lua

onLeaveTrunk

Executada ao sair do porta-malas.
Exemplo: Restaurar o estado do jogador para “fora do porta-malas”.
dk_trunkin/config/client/functions.lua

🔔 Resumo:
  • Validações: As funções isUnlocked e isVehicleAllowed garantem que o veículo esteja em condições de uso.
  • Controle de Ação: blockControls impede que o jogador realize ações indesejadas enquanto está no porta-malas.
  • Permissões: toggleTrunkPermission checa diversas condições para permitir o acesso seguro e adequado.
  • Estados do Jogador: onEnterTrunk e onLeaveTrunk permitem a customização dos estados do jogador ao interagir com o porta-malas.
Essas funções são fundamentais para o funcionamento do Trunkin e podem ser adaptadas conforme as necessidades do seu servidor. Personalize-as para aprimorar a experiência do jogador e garantir um controle mais refinado durante a interação com o porta-malas.