Sistema de inventário QBCore

Sistema de Inventário QBCore – Gerenciamento de Itens Moderno para Servidores FiveM

Atualize seu servidor QBCore com um sistema de inventário completo que traz gerenciamento de itens intuitivo por arrastar e soltar para FiveM. Esta solução abrangente de inventário substitui listas básicas de itens por uma interface de grade visual onde os jogadores podem organizar seus pertences, transferir itens entre contêineres e interagir com sistemas de armazenamento de forma natural. É a base para economias de interpretação de papéis imersivas, sistemas de crafting e interações de jogadores que parecem modernas e polidas.

O Sistema de Inventário QBCore lida com tudo, desde os bolsos dos jogadores até os porta-malas de veículos, casas de depósito até vitrines de lojas. Os itens têm peso, ocupam espaço no inventário e podem ser organizados visualmente da forma que os jogadores preferirem. O sistema se integra perfeitamente com os empregos, lojas e uso de itens do QBCore, criando uma experiência coesa onde o gerenciamento de inventário parece uma parte natural do jogo em vez de uma tarefa de mergulho em menus.

Pré-visualização do vídeo não está carregando? Clique aqui

O que está incluído

Você está recebendo um framework de inventário completo com inventário de jogador, slots de hotbar, dicas de ferramentas de itens, gerenciamento de peso e sistemas de contêineres. A interface visual mostra ícones de itens, quantidades e metadados de um só olhar. Os jogadores podem arrastar itens entre slots, dividir pilhas e transferir rapidamente com atalhos de teclado. O sistema inclui acesso a inventário para veículos (porta-malas, luvas), propriedades (esconderijos, geladeiras), itens caídos (saque no chão) e lojas.

O backend lida com toda a complexidade – durabilidade de itens, armazenamento de metadados (acessórios de armas, qualidade do item, informações do proprietário), cálculos de peso, gerenciamento de slots e verificações de permissão. Tudo sincroniza corretamente em multiplayer, previne explorações de duplicação e se integra com o sistema de itens existente do QBCore sem quebrar a compatibilidade com seus scripts atuais.

Principais características

• Interface de arrastar e soltar – Grade de inventário visual com arrastar, soltar e troca de itens entre slots suaves
• Gerenciamento de Peso e Slots – Cada item tem peso, o inventário tem limites de capacidade, com indicadores visuais claros quando está cheio
• Sistema Hotbar – Slots de acesso rápido para itens frequentemente usados, vinculados a teclas numéricas para uso instantâneo
• Metadados de Itens – Armazenar dados personalizados por item (números de série de armas, qualidade de alimentos, informações de crafting, durabilidade)
• Suporte de contêiner – Acessar porta-malas de veículos, esconderijos de propriedades, bolsas caídas e armazenamento compartilhado com a mesma interface
• Divisão de Pilhas – Clique com o botão direito para dividir pilhas de itens em quantidades personalizadas, perfeito para troca ou distribuição
• Dicas de itens – Passe o mouse sobre os itens para ver informações detalhadas, estatísticas e usabilidade
• Sistema de Drop e Coleta – Deixe itens no chão como objetos físicos, veja bolsas de saque caídas em cenas de crime
• Integração da loja – Interfaces visuais de lojas onde você arrasta itens para comprar/vender, com exibição de preços e confirmações de transação
• Exibição de Acessórios de Armas – Veja os acessórios de armas equipados diretamente no inventário, gerencie cargas visualmente
• Atalhos de Inventário – Controles de teclado para uso rápido de itens, transferir tudo, organizar inventário e saque rápido
• Sistema de Durabilidade de Itens – Itens se degradam com o uso, exigindo reparo ou substituição ao longo do tempo
• Funcionalidade de pesquisa – Filtrar inventários grandes por nome de item para acesso rápido
• Controles de Permissão – Defina quem pode acessar contêineres específicos, útil para esconderijos de gangues ou armários de evidências da polícia
• Proteção contra exploração – Validação no servidor previne duplicação de itens, manipulação de peso e hacking de inventário

Perfeito para

• Servidores de RPG – Fornece interação imersiva de inventário para empregos, comércio e atividades diárias
• Servidores Econômicos – Fundamento essencial para comércio de jogadores, lojas, artesanato e economias baseadas em itens
• Servidores de Sobrevivência – Limites de peso e gerenciamento de inventário adicionam desafio de sobrevivência ao saque e coleta de recursos
• Interpretação de papéis criminais – Negociação visual de drogas, comércio de armas e transporte de contrabando com restrições realistas de inventário
• Sistemas de trabalho – Mecânicas de transporte de peças, chefs gerenciando ingredientes, policiais organizando evidências – todos usam o mesmo sistema intuitivo

Como funciona

Os jogadores abrem seu inventário com uma tecla configurável (padrão I ou Tab dependendo da configuração). A interface exibe os slots disponíveis em uma grade, com slots ocupados mostrando ícones de itens e quantidades. Passar o mouse sobre um item revela informações detalhadas – o que é, o que faz, quaisquer propriedades especiais ou metadados. Clicar e arrastar permite reorganizar, mover itens para diferentes inventários (porta-malas do veículo, outro jogador, loja) ou deixá-los no chão.

O sistema de peso fornece restrições realistas – você não pode carregar 500 armas e drogas ilimitadas. Cada item tem um peso configurado, e sua capacidade total de carregamento é limitada. Quando você está no peso máximo, precisará descartar itens ou armazená-los em um veículo antes de pegar mais. Isso cria decisões significativas sobre o que carregar e incentiva o uso de sistemas de armazenamento.

Os inventários de veículos funcionam de forma idêntica ao inventário do jogador. Abra o porta-malas e você verá tanto seu inventário pessoal quanto o armazenamento do veículo lado a lado. Arraste itens entre eles para carregar/descargar. Diferentes veículos têm diferentes capacidades de armazenamento – um carro esportivo tem espaço mínimo no porta-malas, enquanto uma van pode transportar carga séria. Os esconderijos de propriedade funcionam da mesma maneira, permitindo que você organize casas seguras com armas, drogas ou estoque de negócios legítimos armazenados.

Instalação

1. Extraia o recurso qb-inventory para a pasta de recursos do servidor
2. Substitua ou desative seu sistema de inventário existente (inventário básico do qb-core)
3. Adicione “ensure qb-inventory” ao server.cfg após o carregamento do qb-core
4. Importe o arquivo SQL para criar as tabelas de banco de dados necessárias para o armazenamento de itens
5. Configure as configurações do inventário em config.lua (peso máximo, contagem de slots, caminho das imagens dos itens)
6. Adicione imagens de itens à pasta html/images/ (PNGs para cada item em seu servidor)
7. Reinicie o servidor – os jogadores agora usarão o novo sistema de inventário
8. Atualize quaisquer scripts personalizados para usar as exportações do qb-inventory em vez das funções antigas do inventário

Compatibilidade de Framework

• ✅ qbNúcleo – Integração nativa, projetada especificamente para o framework QBCore
• ✅ QBOX – Compatível com QBOX (fork do QBCore), funciona com mudanças mínimas
• ❌ ESX – Construído para QBCore, exigiria reestruturação significativa para compatibilidade com ESX

Configuração & Personalização

O arquivo de configuração permite ajustar a capacidade do inventário (padrão 50 slots), limites máximos de peso (varia conforme a configuração, geralmente 120-150kg) e a contagem de slots da barra de atalho. Você pode definir diferentes capacidades para tipos de veículos – motocicletas têm menos armazenamento que caminhões. Configure se os itens descartados criam props físicos ou apenas zonas de interação. Defina permissões de acesso ao inventário para empregos, gangues ou propriedades específicas.

A configuração de itens é feita através da tabela de itens compartilhados do QBCore, onde você define o peso, a usabilidade e os campos de metadados de cada item. O sistema de inventário lê esses dados e os aplica automaticamente. Quer que as armas tenham durabilidade? Habilite-a na configuração e adicione rastreamento de durabilidade aos itens de armas. Precisa que os alimentos tenham classificações de qualidade? Adicione metadados de qualidade aos itens consumíveis. O sistema é flexível o suficiente para suportar quaisquer propriedades de itens que seu servidor precise.

A customização visual é simples – a interface HTML/CSS pode ser restilizada para combinar com o tema do seu servidor. As imagens dos itens são arquivos PNG simples que você pode substituir ou adicionar conforme necessário. O layout, cores, fontes e animações são todos personalizáveis se você quiser que o inventário tenha uma aparência única para a marca do seu servidor.

O que o torna especial

Isso não é apenas outro script de inventário – tornou-se o padrão da comunidade para servidores QBCore porque lida com a complexidade corretamente. Bugs de duplicação de itens são prevenidos através de validação no lado do servidor. Cálculos de peso funcionam corretamente com frações. Contêineres sincronizam corretamente em cenários multiplayer. O UI é responsivo e não trava ao gerenciar grandes inventários. Esses detalhes importam quando você está administrando um servidor populado onde bugs de inventário podem destruir sua economia.

O desenvolvedor claramente usou este sistema em servidores de produção, pois ele lida com casos extremos que outros sistemas de inventário ignoram. O que acontece quando dois jogadores tentam pegar o último item de um esconderijo ao mesmo tempo? E se alguém se desconectar enquanto arrasta um item? E se veículos desaparecerem enquanto há itens no porta-malas? Todos esses cenários são tratados com elegância sem perda ou duplicação de itens. Essa é a polidez que separa um script funcional de um sistema de produção confiável.

Detalhes técnicos

• Desempenho do cliente: Lightweight UI com renderização otimizada, impacto mínimo de FPS quando aberto
• Desempenho do servidor: Consultas de banco de dados eficientes, dados de inventário em cache reduzem a sobrecarga de busca
• Banco de dados: Usa tabelas MySQL para armazenamento persistente, devidamente indexadas para desempenho
• Otimização de rede: Sincroniza apenas os slots alterados, não todo o inventário em cada atualização
• Imagens de Itens: Suporta formato PNG, recomendado 150x150px para exibição ótima
• Multiplayer Seguro: Todas as ações validadas no lado do servidor, previne explorações de manipulação do cliente

Integração com outros sistemas

O sistema de inventário exporta funções que outros recursos podem chamar – AddItem, RemoveItem, GetInventory, CanCarryItem e mais. Isso significa que seus scripts de trabalho, sistemas de crafting e lojas podem todos interagir com o inventário do jogador programaticamente. Um trabalho de mecânico pode verificar se o jogador tem peças de reparo antes de permitir um conserto. Um script de drogas pode verificar o espaço no inventário antes de adicionar o produto. Tudo se conecta através de exports padronizados.

Para desenvolvedores que estão construindo scripts personalizados, o inventário fornece eventos e callbacks. Disparar um evento quando os itens são usados, removidos ou deixados cair. Conectar-se à abertura do inventário para adicionar validação personalizada. Ouça as alterações de metadados do item para atualizar sistemas externos. O framework é extensível sem a necessidade de modificar arquivos principais, mantendo sua configuração amigável para atualizações quando novas versões forem lançadas.

O inventário de veículos se integra com a maioria dos sistemas de chaves/propriedade de veículos. Apenas jogadores autorizados podem acessar o porta-malas de um veículo, impedindo que jogadores aleatórios saqueiem seu carro. Os esconderijos de propriedade estão vinculados aos sistemas de moradia/território de gangues, portanto apenas membros da gangue podem acessar o esconderijo da gangue. Os inventários de lojas podem ser reabastecidos por jogadores autorizados, criando oportunidades de negócios geridos por jogadores. O sistema de permissões é flexível o suficiente para suportar qualquer cenário de controle de acesso que seu servidor precise.

Suporte e atualizações

Como um dos recursos mais amplamente utilizados QBCore, o sistema de inventário se beneficia de testes e feedback da comunidade. Bugs são identificados e corrigidos rapidamente porque milhares de servidores estão executando esse código. As atualizações mantêm a compatibilidade com as alterações do framework QBCore, então você não ficará preso em versões antigas porque o inventário quebrou. A base de código também está bem documentada, facilitando a solução de problemas ou a adição de recursos personalizados específicos para o seu servidor.

Prévias em vídeo