Inventário Trygon

Trygon Inventory – Sistema de inventário moderno com recurso de arrastar e soltar

Transforme a experiência de inventário do seu servidor com o Trygon Inventory, um sistema de inventário moderno e totalmente de código aberto que traz mecânicas intuitivas de arrastar e soltar e um design visual impressionante. ESX e QBCore Ao contrário de sistemas de inventário obsoletos e complicados, o Trygon Inventory oferece a interface fluida e responsiva que os jogadores de hoje esperam – comparável a jogos AAA, em vez de scripts improvisados para FiveM. Seja para lançar um novo servidor ou atualizar um sistema de inventário básico, o Trygon oferece gerenciamento de itens de nível profissional que aprimora todos os aspectos da sua economia e jogabilidade.

https://www.youtube.com/watch?v=FyMuByCy0xg

Construído com foco em desempenho e personalização, o Trygon Inventory oferece recursos avançados pelos quais a maioria dos scripts de inventário cobra preços exorbitantes – e é totalmente de código aberto, sem custos adicionais de licenciamento. Você terá acesso completo a mais de 2.400 linhas de código Lua otimizado e mais de 2.500 linhas de JavaScript limpo, permitindo personalização completa para atender às necessidades específicas do seu servidor. O sistema gerencia tudo, desde o armazenamento básico de itens até a criação complexa, a distribuição de itens com animações personalizadas, a personalização de cores RGB para uma estética de inventário personalizada e o gerenciamento inteligente de peso/espaços que previne exploits, mantendo uma jogabilidade fluida.

O que está incluído

O Trygon Inventory chega como uma substituição completa para o seu sistema de inventário atual, com tudo o que você precisa para implantação imediata. O pacote inclui o script principal de inventário com funcionalidade de arrastar e soltar, uma interface de usuário moderna construída com princípios de design responsivo, arquivos de configuração de itens abrangentes com dezenas de itens pré-configurados e módulos de integração para os frameworks ESX e QBCore. O sistema suporta tipos de itens ilimitados com propriedades configuráveis – itens empilháveis, armas com acessórios, consumíveis com efeitos, materiais de fabricação e itens únicos com metadados personalizados.

O design da interface do usuário apresenta animações fluidas, opções de classificação inteligentes, teclas de atalho de uso rápido e feedback visual para cada ação. Os jogadores podem arrastar itens entre os espaços do inventário, soltar itens no chão para que outros os peguem, entregar itens diretamente a jogadores próximos com sequências de entrega animadas e dividir pilhas de itens com uma interface intuitiva. O sistema de personalização de cores permite que os jogadores personalizem o fundo do inventário usando controles deslizantes RGB, criando estilos visuais únicos que combinam com a personalidade do personagem ou com as cores da gangue.

Ferramentas administrativas estão integradas diretamente ao sistema, permitindo que a equipe do servidor gere itens, verifique os inventários dos jogadores remotamente, remova itens problemáticos e monitore as transações de inventário para o equilíbrio da economia. O script registra todas as ações significativas do inventário — geração de itens, trocas, descartes e exclusões — fornecendo trilhas de auditoria que ajudam a identificar bugs de duplicação ou tentativas de trapaça. Os limites de peso e espaço são aplicados no servidor, impedindo a manipulação por parte do cliente e fornecendo feedback claro quando os jogadores excedem a capacidade.

Principais características

• Interface de arrastar e soltar – Movimentação intuitiva de itens arrastando-os entre espaços, soltando-os no chão ou entregando-os a jogadores próximos.
• Personalização de cores RGB – Os jogadores personalizam as cores de fundo do inventário usando controles deslizantes RGB para estilos visuais únicos.
• Código aberto – Acesso total ao código-fonte com mais de 2.400 linhas de Lua e mais de 2.500 linhas de JavaScript, sem restrições de garantia.
• Suporte a estrutura dupla – Funciona perfeitamente com servidores ESX e QBCore, com otimizações específicas para cada framework.
• Seleção de estilo do item – Configure itens com visuais, ícones e propriedades de exibição personalizados para uma apresentação única.
• Adicionar animações aos itens – Sequências animadas em que os jogadores entregam itens uns aos outros criam interações imersivas.
• Gerenciamento de Peso e Slots – Sistema inteligente de capacidade com feedback em tempo real e validação no servidor.
• Notificações de slots máximos – Alertas claros quando o estoque estiver cheio, evitando confusão sobre o motivo pelo qual os itens não podem ser coletados.
• Divisão de itens – Divida itens empilháveis entre espaços ou jogadores com um menu simples acessado com o botão direito do mouse.
• Atalhos de uso rápido – Atribua itens usados com frequência aos espaços da barra de acesso rápido para acesso instantâneo durante o jogo.
• Sistema de itens terrestres – Deixe itens no mundo para que outros os encontrem ou recuperem, com temporizadores de desaparecimento personalizáveis.
• Detecção de jogadores próximos – Mostra os jogadores dentro do alcance para interações de troca e entrega de itens.
• Suporte a metadados de itens – Anexar dados personalizados aos itens (durabilidade, qualidade, números de série, nomes dos proprietários)
• Integração de criação – Ganchos integrados para sistemas de criação, permitindo verificar ingredientes e adicionar itens criados.
• Compatível com o sistema de loja – Funciona com scripts populares de lojas para compra/venda de itens de estoque.
• Sistema de fixação de armas – Armazene modificações e acessórios de armas como metadados de itens para uma personalização realista de armas.
• Suporte de contêiner – Configure itens especiais como contêineres (mochilas, bolsas) que expandem a capacidade de estoque.
• Funcionalidade de pesquisa – Filtre o inventário por nome do item para localização rápida em grandes estoques.
• Desempenho otimizado – Tempo ocioso de 0,00 ms, impacto mínimo na renderização da interface do usuário, consultas de banco de dados eficientes

Perfeito para

• Servidores novos que desejam um sistema de inventário moderno e profissional desde o primeiro dia.
• Servidores existentes sendo atualizados a partir de scripts de inventário desatualizados ou limitados.
• Desenvolvedores que precisam de acesso total ao código para integrações e modificações personalizadas.
• Servidores focados na economia que exigem rastreamento detalhado de itens e monitoramento de comércio.
• Comunidades de RPG que desejam interações imersivas com itens e animações.
• Servidores com sistemas de criação complexos que necessitam de metadados de itens flexíveis
• Comunidades que valorizam opções de personalização do jogador, como a seleção de cores RGB.

Detalhes técnicos

• Compatibilidade da estrutura: ESX (todas as versões) e QBCore (todas as versões)
• Acesso ao código: Totalmente de código aberto – sem garantia, total liberdade de personalização.
• Linhas de código: Aproximadamente 2.400 linhas de Lua (lógica cliente/servidor), aproximadamente 2.500 linhas de JavaScript (interface do usuário).
• Desempenho: 0,00 ms em repouso, ~0,01-0,02 ms com a interface de inventário aberta.
• Banco de dados: Integra-se com as tabelas de armazenamento de itens existentes da estrutura.
• Dependências: Framework ESX ou QBCore, sem necessidade de recursos adicionais.
• Integrações opcionais: Funciona com ox_lib, qb-target, scripts de criação e sistemas de loja.

Instalação

1. Faça backup do seu sistema de inventário e banco de dados atuais (importante para reversão, se necessário).
2. Extraia o arquivo trygon_inventory para a sua pasta de recursos.
3. Configure o arquivo config.lua para que corresponda ao seu framework (ESX ou QBCore).
4. Configure as definições de itens no arquivo items.lua com pesos, rótulos e propriedades.
5. Configure os limites de peso/espaço por jogador ou com base nos itens (mochilas, etc.).
6. Adicione 'ensure trygon_inventory' ao arquivo server.cfg.
7. Reinicie o servidor e teste a funcionalidade de inventário com alguns jogadores.
8. Personalize as opções de cores RGB e os estilos dos itens para combinar com a estética do seu servidor.

Mecânica de arrastar e soltar

A essência do Trygon Inventory reside em seu sistema intuitivo e fluido de arrastar e soltar, que funciona exatamente como os jogadores esperam de jogos modernos. Clique e segure qualquer item do inventário e arraste-o para um novo espaço para reorganizá-lo. Arraste um item para fora da janela do inventário para soltá-lo no chão, criando um objeto no mundo com o qual outros jogadores podem interagir. Arraste um item sobre o nome de outro jogador na lista de jogadores próximos para iniciar uma animação de entrega de item e transferir o item diretamente para o inventário dele.

O sistema fornece feedback visual instantâneo durante o arrastar: o item que está sendo movido segue o cursor com uma pré-visualização semitransparente, as zonas de soltura válidas são destacadas em verde, as zonas inválidas são exibidas em vermelho e uma dica de ferramenta mostra os detalhes do item durante a operação de arrastar. Se você tentar soltar um item em um local inválido (como tentar colocar uma arma em um espaço reservado para comida em servidores com inventários categorizados), o item retorna à sua posição original com uma animação sutil e um som de erro.

A mecânica de empilhamento é gerenciada de forma inteligente. Arraste um item empilhável (como comida, munição ou materiais) para outra pilha do mesmo tipo, e o sistema os combinará automaticamente até o tamanho máximo da pilha. Se a pilha de destino já estiver no máximo, os itens trocam de posição. Clicar com o botão direito em uma pilha abre um seletor de quantidade, permitindo que você divida a pilha em quantidades específicas — perfeito para vender quantidades exatas para lojas ou dar quantidades precisas para outros jogadores.

Personalização de cores RGB

O Trygon Inventory inclui um seletor de cores RGB exclusivo que permite aos jogadores personalizar a interface do inventário. Acesse o menu de personalização de cores através do ícone de configurações do inventário e use os controles deslizantes para ajustar os valores de vermelho, verde e azul de 0 a 255. O plano de fundo do inventário é atualizado em tempo real conforme você ajusta os controles, mostrando exatamente como suas escolhas ficarão. Os jogadores podem criar temas escuros sutis, cores vibrantes de gangue ou qualquer combinação de cores que preferirem.

Os administradores de servidores podem configurar se a personalização de cores estará disponível para todos os jogadores, restrita a jogadores VIP/doadores ou totalmente desativada, caso desejem manter uma identidade visual consistente na interface. As cores escolhidas são salvas individualmente no banco de dados, persistindo entre sessões e reinicializações do servidor. Alguns servidores utilizam as cores do inventário como identificação de gangues — os Bloods usam fundo vermelho, os Crips usam azul e os jogadores neutros mantêm as cores padrão. Essa flexibilidade permite tanto a expressão pessoal quanto a funcionalidade do servidor.

Doação e troca de itens

Quando os jogadores entregam itens uns aos outros usando o Inventário Trygon, o sistema cria sequências animadas imersivas em vez de teletransporte instantâneo. Ambos os jogadores realizam uma animação de entrega, onde quem entrega estende o item e quem recebe o aceita. Essa animação impede transferências de itens rápidas durante situações em andamento e cria trocas de itens visíveis e adequadas à interpretação de personagens. Polícia Os agentes podem observar a entrega de itens, tornando as transações de drogas e as transferências ilegais de itens visíveis para as autoridades.

A lista de jogadores próximos mostra todos os jogadores dentro de um alcance configurável (padrão de 3 a 5 metros), com indicadores de distância e nomes dos jogadores. Esse requisito de alcance impede transferências de itens entre mapas e garante que as trocas ocorram presencialmente. O sistema verifica se ambos os jogadores têm espaço suficiente no inventário antes de concluir as transferências, evitando explorações em que itens poderiam ser perdidos caso o inventário do receptor esteja cheio. Se uma transferência falhar (receptor desconectado, fora do alcance, inventário cheio), o item retorna ao remetente com uma notificação explicando o motivo.

O que faz o inventário de Trygon se destacar?

O mercado do FiveM está repleto de scripts de inventário, mas o Trygon se destaca pela combinação de design moderno, acessibilidade de código aberto e otimização de desempenho. Muitos inventários premium escondem código medíocre atrás de proteção de garantia, impedindo que os proprietários de servidores corrijam bugs ou adicionem recursos. O Trygon oferece acesso completo ao código, permitindo integrações personalizadas, correções de bugs e adições de recursos sem precisar esperar pelo desenvolvedor original. A comunidade criou dezenas de complementos e extensões que funcionam perfeitamente com a arquitetura do Trygon.

O desempenho é excepcional para um sistema de inventário com tantos recursos. Os desenvolvedores otimizaram as consultas ao banco de dados para minimizar o impacto no servidor, implementaram um cache eficiente para reduzir buscas repetidas e projetaram a renderização da interface do usuário para manter mais de 60 FPS mesmo com centenas de itens. Proprietários de servidores relatam que o Trygon usa menos recursos do que scripts de inventário mais simples, ao mesmo tempo que oferece muito mais funcionalidades. A natureza de código aberto permite que a comunidade contribua com otimizações e melhorias, criando uma base de código em constante evolução que se aprimora com o tempo.

A comunidade de desenvolvimento ativa em torno do Trygon garante sua viabilidade a longo prazo. Quando atualizações do framework quebram a compatibilidade, os desenvolvedores da comunidade rapidamente corrigem e atualizam o script. Quando os jogadores solicitam recursos, programadores experientes contribuem com implementações que beneficiam a todos. Esse ecossistema colaborativo significa que o Trygon não depende de um único desenvolvedor – ele é mantido por dezenas de colaboradores que têm interesse em mantê-lo funcionando perfeitamente.

Opções de configuração avançadas

Os proprietários de servidores podem configurar praticamente todos os aspectos do comportamento do inventário através do arquivo de configuração abrangente. Defina limites de peso globais que se aplicam a todos os jogadores ou implemente limites dinâmicos com base no nível do jogador, status VIP ou itens equipados, como mochilas. Configure a quantidade de espaços por tipo de inventário — inventário principal, porta-malas de veículos, armazenamento de propriedades, esconderijos de gangues — com limites diferentes para cada tipo de armazenamento. Alguns servidores utilizam inventários principais com 50 espaços para jogos casuais, enquanto servidores de sobrevivência hardcore usam 20 espaços para criar desafios de gerenciamento de inventário.

As definições de itens permitem ampla personalização. Defina pesos individuais para cada item, tamanhos de pilha e se os itens podem ser descartados, dados ou vendidos. Atribua campos de metadados personalizados que rastreiam a condição do item, histórico de propriedade ou identificadores exclusivos para itens raros. Configure categorias de itens (armas, comida, materiais, ferramentas) com diferentes propriedades de exibição, ordens de classificação e restrições. Essa flexibilidade permite criar ecossistemas de itens únicos, onde as mecânicas do servidor são aplicadas por meio de regras de inventário.

A personalização visual vai além das cores RGB. Configure os estilos dos ícones dos itens — alguns servidores usam ícones fotográficos realistas, outros preferem ícones ilustrados no estilo de jogos, enquanto servidores minimalistas usam silhuetas simples. Ajuste os layouts da grade de inventário, de grades compactas de 10x5 a layouts verticais espaçosos de 5x10. Personalize as animações da interface do usuário, as velocidades de transição e os efeitos sonoros para combinar com a linguagem de design geral do seu servidor. Cada elemento visual pode ser ajustado por meio de CSS e arquivos de configuração sem alterar o código principal.

Integração com outros scripts

O Trygon Inventory integra-se perfeitamente com a maioria dos scripts populares do FiveM através de hooks de itens padrão do framework. Scripts de criação podem consultar o conteúdo do inventário para verificar os materiais necessários e, em seguida, adicionar itens criados através de funções padrão de adição de itens. Sistemas de loja leem os itens disponíveis e seus metadados para transações de compra/venda. Trabalho Os scripts podem verificar os itens necessários (licenças, ferramentas, ingredientes) antes de permitir a execução de tarefas. O código aberto facilita a integração personalizada para desenvolvedores.

O script inclui suporte integrado para sistemas de acessórios de armas. Quando os jogadores modificam armas em lojas de armas ou oficinas mecânicas, os dados dos acessórios são salvos nos metadados da arma. Quando a arma é equipada, esses acessórios são aplicados automaticamente. Ao descartar ou trocar a arma, os acessórios são transferidos com ela, criando uma economia realista de personalização de armas, onde armas modificadas têm maior valor do que armas padrão.

O armazenamento no porta-malas dos veículos funciona através do sistema de contêineres do Trygon. Cada veículo possui um inventário separado do inventário pessoal do jogador, com capacidade baseada no tipo de veículo. Motocicletas têm porta-malas pequenos (30-50 kg), sedãs têm porta-malas médios (100-150 kg), vans e caminhões têm porta-malas grandes (200-300 kg). Os jogadores podem arrastar itens do inventário pessoal para o porta-malas do veículo e vice-versa, com a mesma interface intuitiva de arrastar e soltar. Alguns servidores implementam porta-malas trancados que exigem chaves do carro, criando uma mecânica de armazenamento de veículos realista.

Prévia do vídeo

https://www.youtube.com/watch?v=FyMuByCy0xg

Apoio e recursos comunitários

A equipe de desenvolvimento do Trygon mantém uma presença ativa nas comunidades do FiveM, oferecendo suporte por meio de canais do Discord e fóruns. A documentação detalhada abrange instalação, configuração, integrações comuns e solução de problemas típicos. Tutoriais em vídeo explicam os processos de configuração, demonstram recursos avançados e mostram as possibilidades de personalização. A natureza de código aberto significa que os membros da comunidade frequentemente respondem a perguntas e compartilham exemplos de configuração de seus próprios servidores.

Os repositórios do GitHub contêm o código mais recente, sistemas de rastreamento de problemas para relatórios de bugs e sistemas de pull requests onde os colaboradores enviam melhorias. Esse processo de desenvolvimento transparente garante que os bugs sejam corrigidos rapidamente, que os recursos solicitados sejam acompanhados publicamente e que a evolução do script seja visível para todos os usuários. Os proprietários de servidores podem acompanhar o desenvolvimento, contribuir com código se puderem ou simplesmente se beneficiar das melhorias coletivas da comunidade.

Scripts ESX relacionados

• Trabalho de mergulho (para ESX)
• Roteiro FiveM K9
• Palestrante do YouTube
• Scripts de cassino

Pacote entregue

• Um uz_TrygonInventory recurso para GTA V.
• Arquivos NUI, scripts Lua, dados de itens, fontes e imagens de interface.
• Nenhuma migração SQL e nenhuma dependência de manifesto adicional declarada no arquivo.