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.
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, oqbx_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
- Metti la cartella dell’inventario nella tua directory
resources/(mantieni il nome esatto della cartella consegnata dallo sviluppatore). - 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.
- Fai prima il backup del database. Non negoziabile.
- Importa il
.sqlfornito con HeidiSQL, phpMyAdmin o da riga di comando. - 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).
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)
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| ”attempt to index nil” all’avvio | Dipendenza non partita | Sposta oxmysql/ox_lib sopra l’inventario |
| Gli oggetti non si salvano | SQL non importato | Importa il .sql e riavvia |
| Si aprono due inventari | Il predefinito non è disattivato | Commenta l’ensure del vecchio inventario |
| Interfaccia vuota | Versione di ox_lib non compatibile | Aggiorna 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.