Voltar ao blog
Scripts6 min de leitura

Agency-Vehiclekeys: Como um pequeno atrito faz os carros parecerem reais

O Agency-Vehiclekeys substitui o acesso instantâneo aos veículos por um gerenciamento realista de chaves. Veja como esse pequeno atrito melhora a jogabilidade.

Agency Scripts

Fundador e programador principal na Agency Scripts

O recurso que não é um antirrecurso

Exigir uma chave para ligar um veículo parece um antirrecurso. Quem quer passar por mais etapas antes de dirigir? Mas o RP imersivo costuma ser construído exatamente com esse tipo de atrito significativo. Roubar um veículo passa a ter consequências. Trancar o carro se torna uma ação de verdade. Fazer ligação direta se torna uma habilidade que pode ser aprendida.

Estados de chave que importam

Agency-Vehiclekeys modela três estados de chave por veículo: própria (você tem uma chave física), compartilhada (alguém lhe deu uma cópia), ligação direta (acesso temporário com risco de rastreamento pela polícia). Cada estado tem efeitos sonoros, animações de partida e comportamento do motor diferentes. A experiência de quem pega emprestado o carro de um amigo é diferente da de um ladrão, como deve ser.

Minijogo de arrombamento

Incluímos um minijogo simples de arrombamento com 3 níveis, que varia conforme a classe do veículo. Um Sultan RS leva mais tempo e tem mais chances de falha do que um Faggio. O minijogo depende de habilidade, mas não é punitivo, falhar custa tempo e ferramentas, não o progresso do personagem. Essa é a curva de dificuldade ideal para uma mecânica que deve criar tensão, não servir de barreira.

Integrações com frameworks

A propriedade de veículos no QBCore, as garagens do ESX e os registros personalizados em standalone se integram por meio de um único conjunto de hooks. As chaves são armazenadas como itens de inventário, então interagem naturalmente com itens descartados, trocas e buscas no inventário. Nada recebe tratamento especial.

Impacto econômico

O acesso a veículos por meio de chaves cria papéis econômicos realistas. O trabalho de chaveiro se torna viável. Ladrões de carros passam a ser uma ameaça real. As seguradoras se tornam úteis. O roleplay emergente surge de sistemas que interagem entre si, Agency-Vehiclekeys é uma peça desse quebra-cabeça.

Instalação e configuração

Agency-Vehiclekeys requer oxmysql para persistir a propriedade das chaves entre reinicializações do servidor. Importe vehiclekeys.sql , coloque a pasta do recurso no servidor e adicione ensure agency-vehiclekeys a server.cfg . O recurso lê os dados de propriedade dos veículos na garagem ou no registro de veículos do seu framework. Os adaptadores para QBCore e ESX vêm incluídos no pacote e são detectados automaticamente na inicialização.

Os itens de chave precisam ser registrados no sistema de itens do seu framework. A configuração inclui nomes de itens e definições de metadados para QBCore e ESX. Em configurações standalone, o tratamento dos itens é definido por meio de hooks de configuração.

Opções de configuração

O config.lua permite controlar detalhadamente cada mecânica de chaves:

  • Níveis de lockpick, defina a probabilidade de sucesso e o comportamento em caso de falha para cada classe de veículo. É mais difícil fazer ligação direta em supercarros do que em veículos econômicos.
  • Chance de detecção de ligação direta, probabilidade de uma ligação direta bem-sucedida enviar um alerta à polícia por minuto de uso ativo.
  • Custo da duplicação de chaves, custo em dinheiro e itens para criar uma cópia da chave na bancada do chaveiro.
  • Requisito de emprego de chaveiro, opcionalmente, restrinja a cópia de chaves a jogadores que trabalham como chaveiros.
  • Trancamento automático ao sair, define se os veículos trancam automaticamente quando o motorista sai. Padrão: desativado (mais realista).
  • Expiração de chaves compartilhadas, as chaves temporárias podem ter um limite de tempo real, após o qual são desativadas automaticamente.

Compatibilidade com frameworks

Os adaptadores completos para QBCore e ESX vêm incluídos no pacote. Em configurações standalone, implemente quatro funções de configuração: consulta do proprietário do veículo, adição e remoção de itens, acionamento de alerta à polícia e verificação opcional do emprego de chaveiro. A máquina de estados das chaves, as animações, o minijogo e a lógica de ligação direta não exigem conhecimento de nenhum framework.

Por que isso importa para o roleplay

A propriedade de veículos sem um controle de acesso significativo é apenas cosmética. Agency-Vehiclekeys torna real a diferença entre ser dono de um veículo e ter acesso a ele. Um carro trancado estacionado em frente a um banco não é apenas parte do cenário, pode ser um alvo em potencial ou um bem seguro, dependendo de quem está olhando.

A economia dos chaveiros é o maior benefício emergente. Quando as chaves são itens físicos que podem ser duplicados, perdidos ou roubados, personagens chaveiros passam a ter um serviço legítimo a oferecer. Jogadores que perdem a chave precisam fazer ligação direta (arriscado) ou encontrar um chaveiro (o que exige confiança e negociação). Essa interação é puro RP, que não existia antes da instalação do script.

O rastreamento de detecção de ligação direta faz com que roubar um veículo seja um risco calculado, em vez de uma ação trivialmente fácil. Jogadores que fazem ligação direta e dirigem por uma hora estão assumindo um risco significativo. Ladrões experientes aprendem a trocar de veículo com frequência. A polícia aprende a ficar atenta aos alertas de ligação direta. O script gera roleplay criminal e policial espontâneo, sem nenhum evento roteirizado.

Perguntas frequentes

Os jogadores podem dar a chave a outro jogador?

Sim. As chaves são itens de inventário e podem ser trocadas, descartadas ou entregues por qualquer transferência padrão de inventário. Isso inclui dar uma chave pelo marketplace do Agency-Phone ou deixá-la em um local para alguém pegar, toda a economia de itens se aplica.

O que acontece quando um item de chave é perdido ou excluído?

O registro de chaves do servidor acompanha a propriedade independentemente do item. Um jogador que perde o item físico da chave pode obter uma substituta em uma loja de chaveiro (com custo de tempo e dinheiro) ou por meio de comandos administrativos. O veículo não fica permanentemente inacessível.

O minijogo pode ser desativado para funções específicas dos jogadores?

Sim. O minijogo de lockpick pode ser ignorado para jogadores com funções específicas (como chaveiro mestre) ou itens específicos (como um kit profissional de lockpick em vez de um básico). Configure as condições para ignorar o minijogo em Config.LockpickItems.

Isso entra em conflito com scripts de garagem existentes?

Agency-Vehiclekeys consulta os dados de propriedade da garagem, mas não modifica o sistema de garagem. Os veículos continuam aparecendo por meio do seu script de garagem atual. O sistema de chaves é integrado ao sistema existente: quando você retira um veículo da garagem, um item de chave é gerado automaticamente no seu inventário.

Requisitos

  • Servidor FiveM (QBCore, ESX ou standalone)
  • oxmysql
  • Conta cfx.re com licença válida do Agency-Vehiclekeys
  • Sistema compatível de garagem ou propriedade de veículos

Interpretando um chaveiro em um servidor com sistema de chaves

Agency-Vehiclekeys possibilita uma profissão legítima de chaveiro, que não existe em servidores sem sistema de chaves. Veja como é a jogabilidade desse personagem na prática:

Um chaveiro que oferece serviços de cópia de chaves precisa de uma forma para os clientes entrarem em contato com ele, e o Agency-Phone cuida disso. Ele precisa de um objeto de trabalho para a animação de corte de chaves. Combine com a equipe de MLO do seu servidor ou use um objeto de oficina padrão. Ele cobra pelo serviço, e o dinheiro passa pelo framework da sua economia. Talvez carregue ferramentas de arrombamento de nível superior, capazes de abrir veículos que as ferramentas de outros jogadores não conseguem, o que exige que clientes criminosos que precisam acessar um veículo específico confiem nele.

A questão da confiança é particularmente interessante. Um chaveiro que faz cópias não autorizadas de chaves, denuncia à polícia os clientes que pedem cópias ou danifica veículos deliberadamente enquanto "trabalha neles" é um personagem com verdadeira complexidade moral e consequências reais no jogo para suas decisões. Agency-Vehiclekeys cria as condições para esse personagem existir.

O script ideal

Pronto para o seu servidor, com atualizações incluídas.

Pronto para começar?

Obtém os scripts na nossa loja, ou junta-te ao Discord para suporte, novidades e uma antevisão do que vem aí.