Defina os limites do inventário em torno das atividades que os jogadores precisam concluir: suprimentos comuns, equipamento de trabalho e uma escolha significativa sobre carga extra. Peso, slots e metadados de itens resolvem problemas diferentes, então inspecione seu recurso de inventário real antes de alterar os valores.
Identifique a implementação do inventário
Registre o recurso/versão do inventário, sua integração com a estrutura e onde ele define itens, capacidade do jogador, armazenamento de veículos e esconderijos. ESX, QBCore e Qbox não implicam um formato de inventário universal. Use a fonte instalada ou a documentação do autor do inventário.
Faça backup da configuração e dos inventários armazenados. Teste as alterações em uma instância separada; a redução da capacidade pode deixar os contêineres existentes acima do novo limite.
Entenda os três limites
O limite de peso restringe a massa total transportada nas unidades usadas pelo recurso. Os slots limitam o número de pilhas distintas. As regras de empilhamento determinam se itens de mesmo nome com metadados diferentes podem compartilhar um slot. Um contêiner pode ficar sem slots mesmo com capacidade de peso disponível.
Use a mesma unidade consistentemente. Se o seu inventário usa gramas, um item pesando 500 e uma capacidade de 20.000 representam 0,5 kg e 20 kg. Esses números são uma ilustração, não uma predefinição de servidor recomendada.
Monte um conjunto representativo de equipamentos
Liste o que um novo jogador precisa para uma sessão normal e repita para cada profissão. Calcule quantidade × peso do item e os slots necessários para as pilhas. Inclua munição, ferramentas e consumíveis. Teste esse conjunto de equipamentos no jogo em vez de depender apenas de uma planilha.
Escolha as capacidades do veículo e do esconderijo de acordo com seu propósito. Um veículo utilitário pode suportar a logística sem forçar cada jogador a carregar um armazém inteiro. A população do servidor por si só não determina uma capacidade de carga sensata.
Edite o recurso que possui a configuração
Em configurações QBCore, as definições de itens compartilhados e os limites de contêineres do inventário podem estar em recursos diferentes. Em ox_inventory, as definições de itens comuns e as definições de armas são preocupações separadas. Siga a estrutura de arquivos real para sua versão instalada.
Não copie uma configuração genérica de PlayerMaxWeight, useWeight ou uma função de armazenamento para um arquivo, a menos que o recurso a utilize. Procure a chave e seu uso no código-fonte. Preserve os nomes e o comportamento dos itens existentes ao alterar o limite desejado.
Preserve os metadados
Números de série, durabilidade, munição e anexos são específicos da implementação. Verifique os intervalos e nomes de campo antes de qualquer conversão; uma escala de durabilidade de 0 a 1 não é intercambiável com 0 a 100. Preserve itens exclusivos separadamente e relate campos desconhecidos em vez de descartá-los.
Uma migração de inventário precisa de um conversor versionado para o esquema de origem e destino exato, com contagens e metadados comparados antes e depois. Não execute SQL genérico em tabelas de itens de jogador adivinhadas.
Teste a capacidade e a persistência
- Adicione e remova uma quantidade conhecida; confirme que o peso exibido corresponde ao peso usado pelo sistema para aplicar os limites.
- Preencha os slots com pilhas distintas e, em seguida, teste uma pilha correspondente e um item com metadados diferentes.
- Teste transferências entre jogador, veículo e esconderijo quando qualquer destino estiver cheio. Confirme que a falha não perde nem duplica itens.
- Reconecte e reinicie o servidor de teste. Verifique quantidades, propriedade e metadados.
- Teste um contêiner existente acima da nova capacidade proposta e decida como os jogadores podem se recuperar sem exclusão de itens.
Implemente mudanças compreensíveis
Explique os limites alterados e dê aos jogadores uma rota para reorganizar o armazenamento existente. Observe as transferências rejeitadas, os itens frequentemente transportados e o feedback do jogador. Ajuste o gargalo específico em vez de aumentar repetidamente cada capacidade.
Documentação de referência
Fonte: qbcore-fivem/qb-inventory · Fonte: overextended/ox_inventory