Come installare un inventario su FiveM (passo passo)
Script e risorse

Come installare un inventario su FiveM (passo passo)

Tutorial adatto ai principianti per installare uno script di inventario sul tuo server FiveM — dipendenze, database, ordine nel server.cfg e test — per ESX, QBCore e Qbox.

L’inventario è uno dei primi sistemi a pagamento che quasi tutti i gestori installano — e una delle fonti più comuni di errori “non parte”. Questo tutorial mostra un’installazione pulita che funziona al primo colpo, che tu usi ESX, QBCore o Qbox.

Prima di iniziare: serve un server funzionante con un framework installato. Sei nuovo? Segui prima la nostra guida per creare un server FiveM.

Passo 1 — Controlla i requisiti

Ogni inventario elenca le sue dipendenze. Quelle quasi universali oggi sono:

  • oxmysql — lo strato del database.
  • ox_lib — libreria condivisa di UI/utility usata dalla maggior parte delle risorse moderne.
  • Il tuo framework (es_extended, qb-core, o qbx_core).

Installali e verifica che partano puliti prima di aggiungere l’inventario. Quanto siano diffusi lo vedi sulla nostra pagina delle metriche delle risorse: oxmysql e ox_lib stanno in cima all’ecosistema.

Passo 2 — Aggiungi i file della risorsa

  1. Metti la cartella dell’inventario nella tua directory resources/ (mantieni il nome esatto della cartella consegnata dallo sviluppatore).
  2. Se è arrivata dentro una cartella con parentesi [inventory], mantieni quella struttura — le parentesi raggruppano le risorse e possono influire sull’ordine di caricamento.

Passo 3 — Importa il database

Quasi tutti gli inventari includono un file .sql che aggiunge tabelle di oggetti, stash o colonne di metadati.

  1. Fai prima il backup del database. Non negoziabile.
  2. Importa il .sql fornito con HeidiSQL, phpMyAdmin o da riga di comando.
  3. Se lo script usa una tabella di oggetti, assicurati che i tuoi oggetti siano popolati (molti inventari a pagamento includono una lista iniziale).

Passo 4 — Imposta l’ordine di caricamento nel server.cfg

L’ordine è dove si rompono quasi tutte le installazioni. Le dipendenze devono partire prima dell’inventario:

# Prima il nucleo
ensure oxmysql
ensure ox_lib
ensure es_extended      # oppure qb-core / qbx_core

# Poi l'inventario
ensure mio-inventario

Se l’inventario sostituisce quello predefinito del framework, disattiva il vecchio (commenta la sua riga ensure) così non si contendono gli stessi eventi.

Passo 5 — Configuralo

Apri il config.lua della risorsa (o la cartella config/) e imposta l’essenziale:

  • Framework — alcuni prodotti lo rilevano da soli; altri richiedono una riga Config.Framework = 'esx'.
  • Slot / peso — scegli un sistema e tienilo su tutto il server.
  • Tasto per aprire l’inventario.
  • Stash, negozi, bagagliai — attiva le funzioni che usi davvero; disattiva il resto per risparmiare prestazioni.

Passo 6 — Prova prima di annunciare

Avvia il server e guarda la console di txAdmin al primo caricamento. Poi in gioco verifica il ciclo principale:

  • Aprire/chiudere l’inventario.
  • Raccogliere e lasciare un oggetto.
  • Spostare oggetti tra hotbar e zaino.
  • Aprire uno stash / bagagliaio / negozio.
  • Riconnettersi e confermare che gli oggetti persistono (il database sta salvando).
Regola d'oro: leggi la console dall'alto in basso e correggi il primo errore. Gli altri di solito sono effetti a catena che spariscono una volta risolta la causa.

Quale inventario installare?

Se vuoi una base gratuita e affidabile, ox_inventory è il riferimento della community. Se l’inventario è centrale nell’identità del tuo server — crafting, progressione, stoccaggio profondo e un’interfaccia curata — un sistema a pagamento ne vale la pena. Nei nostri test il tuttofare che spicca è Quasar Inventory, che supporta ESX, QB, QBCore e Qbox da un unico prodotto ed è progettato per tenere basso il costo per frame anche a città piena. Lo trovi sulla pagina dell’inventario su Quasar Store, e lo confrontiamo con il resto nella nostra guida ai migliori inventari FiveM.

Errori di installazione comuni (e soluzioni)

SintomoCausa probabileSoluzione
”attempt to index nil” all’avvioDipendenza non partitaSposta oxmysql/ox_lib sopra l’inventario
Gli oggetti non si salvanoSQL non importatoImporta il .sql e riavvia
Si aprono due inventariIl predefinito non è disattivatoCommenta l’ensure del vecchio inventario
Interfaccia vuotaVersione di ox_lib non compatibileAggiorna ox_lib alla versione richiesta

Quando l’inventario è stabile, abbinalo a un HUD pulito — vedi la nostra guida alla personalizzazione dell’HUD — e assicurati che il tutto resti veloce con la nostra guida all’ottimizzazione.