Como instalar um inventário no FiveM (passo a passo)

O inventário é um dos primeiros sistemas pagos que a maioria dos donos instala — e uma das fontes mais comuns de erros de “não inicia”. Este tutorial mostra uma instalação limpa que funciona de primeira, seja você ESX, QBCore ou Qbox.

Passo 1 — Confira os requisitos

Todo inventário lista dependências. As praticamente universais hoje são:

• oxmysql — a camada de banco de dados.
• ox_lib — biblioteca compartilhada de UI/utilidades usada pela maioria dos recursos modernos.
• Seu framework (es_extended, qb-core, ou qbx_core).

Instale e confirme que iniciam limpos antes de adicionar o inventário. Dá para ver o quanto são comuns na nossa página de métricas de recursos: oxmysql e ox_lib estão no topo do ecossistema.

Passo 2 — Adicione os arquivos do recurso

1. Jogue a pasta do inventário no seu diretório resources/ (mantenha o nome exato da pasta que o desenvolvedor entregou).
2. Se veio numa pasta com colchetes [inventory], mantenha essa estrutura — os colchetes agrupam recursos e podem afetar a ordem de carga.

Passo 3 — Importe o banco de dados

A maioria dos inventários traz um arquivo .sql que adiciona tabelas de itens, baús ou colunas de metadados.

1. Faça backup do banco primeiro. Inegociável.
2. Importe o .sql fornecido via HeidiSQL, phpMyAdmin ou pela linha de comando.
3. Se o script usa uma tabela de itens, garanta que seus itens estejam populados (muitos inventários pagos incluem uma lista inicial).

Passo 4 — Defina a ordem de carga no server.cfg

A ordem é onde a maioria das instalações quebra. As dependências precisam iniciar antes do inventário:

# Núcleo primeiro
ensure oxmysql
ensure ox_lib
ensure es_extended      # ou qb-core / qbx_core

# Depois o inventário
ensure meu-inventario

Se o inventário substitui o padrão do seu framework, desative o antigo (comente a linha ensure dele) para não brigarem pelos mesmos eventos.

Passo 5 — Configure

Abra o config.lua do recurso (ou a pasta config/) e ajuste o essencial:

• Framework — alguns produtos detectam sozinhos; outros precisam de uma linha Config.Framework = 'esx'.
• Slots / peso — escolha um sistema e mantenha em todo o servidor.
• Tecla para abrir o inventário.
• Baús, lojas, porta-malas — ative os recursos que você realmente usa; desative o resto para economizar desempenho.

Passo 6 — Teste antes de anunciar

Suba o servidor e acompanhe o console do txAdmin no primeiro carregamento. Depois, no jogo, verifique o ciclo principal:

• Abrir/fechar o inventário.
• Pegar e largar um item.
• Mover itens entre a hotbar e a mochila.
• Abrir um baú / porta-malas / loja.
• Reconectar e confirmar que os itens persistem (o banco está salvando).

Qual inventário instalar?

Se você quer uma base gratuita e confiável, o ox_inventory é a referência da comunidade. Se o inventário é central na identidade do seu servidor — crafting, progressão, armazenamento profundo e uma interface polida — um sistema pago vale a pena. Nos nossos testes, o polivalente que se destaca é o Quasar Inventory, que suporta ESX, QB, QBCore e Qbox a partir de um único produto e é projetado para manter o custo por frame baixo mesmo com a cidade cheia. Você pode vê-lo na página do inventário na Quasar Store, e o comparamos com os concorrentes no nosso guia dos melhores inventários de FiveM.

Erros comuns de instalação (e correções)

Com o inventário estável, junte a ele um HUD limpo — veja nosso guia de personalização de HUD — e garanta que tudo continue rápido com nosso guia de otimização.