O problema da reparação no terreno
O teu veículo apanha estragos a meio de uma missão. A oficina fica a 10 minutos. Aturar essa viagem mata o ritmo de qualquer sequência de ação em que estavas metido. Mas uma auto-reparação instantânea parece injusta. O Agency-Repairkit encontra o meio-termo com ferramentas de reparação no terreno utilizáveis mas limitadas.
Três níveis de kits
Os kits básicos reparam depressa pequenos danos. Os kits avançados reparam danos médios de forma mais lenta. Os kits profissionais dão conta de danos graves, mas demoram bem mais tempo a aplicar. Esta hierarquia dá aos jogadores escolhas a sério consoante o inventário e a situação em que estão.
Integridade da animação
Cada reparação usa uma animação visível na zona danificada do veículo. Os jogadores não podem reparar a correr a partir do banco do condutor — têm de sair, caminhar até ao dano e comprometer-se com a animação de reparação. Isto evita abusos de reparação em pleno combate e faz com que a ação pareça merecida.
A interrupção conta
Levar dano ou ser atingido durante uma reparação interrompe-a e consome o kit. As reparações acontecem fora do combate, não no meio dele. Isto protege as perseguições para que não se transformem num jogo do gato-e-do-rato em que nada pega.
Integração com a economia
Os kits de reparação são produzíveis por NPCs mecânicos ou por mecânicos jogadores através da cadeia de abastecimento de metais do Agency-Minerjob. Toda a economia automotiva — mineração, crafting, reparações de terreno, reparações de oficina — torna-se uma teia ligada. Os kits não são um artigo isolado; são um nó num sistema maior.
Instalação e Configuração
Agency-Repairkit se instala como qualquer recurso padrão do FiveM. Após a instalação, execute o script SQL incluído para adicionar o item de kit de reparo ao seu banco de dados. O recurso detecta automaticamente seu framework durante o início.
Opções de Configuração
- Porcentagem de reparo por tipo de kit — kit básico repara 30%, premium 70%, completo 100%
- Tempo de animação — quantos segundos dura a animação de reparo
- Cooldown de uso — evita spam para reparar danos instantaneamente
- Restrições de veículo — excluir certos modelos ou categorias de veículos do sistema de kit
Compatibilidade com Frameworks
Os kits de reparo são itens de inventário no ESX e QBCore. O recurso se conecta diretamente ao sistema de itens do seu framework, então os kits aparecem nos inventários dos jogadores como qualquer outro item.
Equilibrando Kits de Reparo na Economia do Servidor
Um dos desafios no design de servidores RP é decidir quão acessíveis devem ser os reparos de veículos. Agency-Repairkit dá as ferramentas para encontrar esse equilíbrio. Configure preços de compra para refletir escassez e demanda, e defina a disponibilidade em lojas normais ou apenas em locais especiais.
Animações e Feedback Visual
Usar um kit desencadeia uma animação de reparo realista. Seu personagem pega ferramentas e trabalha no veículo enquanto a barra de progresso aumenta. Esse atraso é intencional: previne uso de kits no meio de uma batalha e dá a outros jogadores a oportunidade de ver o que você está fazendo.
Integração com Mecânicos
Agency-Repairkit funciona bem ao lado das garagens RP tradicionais. Os jogadores podem usar kits em campo para reparos de emergência, mas reparos maiores ainda requerem um mecânico ou garagem. Isso cria um ciclo de gameplay natural: os kits são para sobreviver até a próxima garagem, não para substituir mecânicos.
Perguntas Frequentes
- O servidor pode limitar quantos kits um jogador pode carregar? Sim, através dos limites de peso ou slots do inventário do seu framework.
- Posso ter kits diferentes para diferentes tipos de veículos? Sim, kits de veículos específicos podem ser configurados separadamente.
- Os kits funcionam em veículos que não são do jogador? Configurável — você pode restringi-los apenas ao veículo próprio ou permitir usar kits em qualquer veículo próximo.
Sobre o Agency Scripts
Agency Scripts é uma coleção de recursos premium do FiveM projetados para servidores de roleplay que levam a imersão a sério. Cada recurso é construído com os mesmos princípios: compatibilidade multi-framework, desempenho otimizado e configuração flexível para se adaptar a qualquer conceito de servidor.
Todos os recursos do Agency estão disponíveis através do sistema de licenças da cfx.re Keymaster. Uma vez comprado, você pode implantar o recurso em qualquer servidor que possua, com suporte ativo disponível através do Discord do Agency Scripts.
Suporte e Comunidade
A comunidade do Agency Scripts inclui milhares de servidores FiveM que usam esses recursos. O Discord oficial é onde os desenvolvedores compartilham suas configurações, fazem perguntas e sugerem novos recursos. As atualizações são regulares e incluem tanto correções de bugs quanto novos recursos baseados no feedback da comunidade.
Para dúvidas de instalação, problemas de compatibilidade ou solicitações de recursos, o Discord é o melhor canal. A documentação é mantida atualizada e cobre todas as configurações com exemplos práticos.
Requisitos do Sistema
Para usar os recursos do Agency Scripts, seu servidor FiveM precisa atender aos seguintes requisitos mínimos:
- Versão do servidor FiveM — artifact 4752 ou superior recomendado
- Framework — ESX 1.2+, QBCore (qualquer versão principal) ou configuração standalone
- Banco de dados — MariaDB ou MySQL 5.7+ com oxmysql como camada de banco de dados
- ox_lib — recomendado para elementos de UI aprimorados, nem sempre obrigatório
Os recursos do Agency Scripts são testados nos artifacts de servidor mais recentes e atualizados regularmente para acompanhar as mudanças do FiveM. As licenças são por servidor mas não têm data de expiração uma vez compradas através do Keymaster.
Por Que os Servidores Escolhem Agency Scripts
A principal razão pela qual os servidores FiveM escolhem Agency Scripts é a consistência. Quando todas as suas ferramentas vêm do mesmo fornecedor, elas têm o mesmo estilo de configuração, o mesmo suporte e o mesmo padrão de qualidade. Não há surpresas ao atualizar um recurso porque você sabe o que esperar.
Para administradores de servidor que querem passar mais tempo no roleplay e menos tempo solucionando problemas de scripts, essa consistência tem valor real. Em vez de ter dez recursos diferentes de dez desenvolvedores diferentes, todos com filosofias de design diferentes e documentação inconsistente, você tem um ecossistema coeso.
Integração Entre Recursos
Os recursos Agency são projetados para funcionar juntos. Agency-Notify é usado por Agency-Reports para alertar admins. Agency-HUD complementa Agency-Phone para uma experiência de interface unificada. Agency-Admin pode suspender jogadores que abusaram do sistema Agency-Blackmarket. Essas integrações não são acidentais — são recursos planejados que fazem o ecossistema funcionar melhor como um todo do que como partes separadas.
Quando você adiciona um novo recurso Agency a um servidor que já usa outros recursos Agency, a compatibilidade está garantida. Não é preciso testar se os eventos colidem, se as configurações do banco de dados conflitam ou se os estilos de UI são inconsistentes. Tudo se encaixa.