Installi gli script FiveM inserendo la risorsa nella cartella resources/, avviandola nella server.cfg con ensure e caricando prima dipendenze come ESX, QBCore o i driver del database. Sono decisivi una struttura delle cartelle pulita, il giusto ordine di avvio, un import SQL verificato e un controllo della console del server dopo il riavvio.
Requisiti
Ti serve accesso ai file del server, alla server.cfg, alla console del server e, se lo script usa tabelle del database, al tuo database MySQL o MariaDB. Su un server FiveM noleggiato, di solito questo include un file manager, FTP/SFTP e uno strumento per database come phpMyAdmin o Adminer. Se stai ancora pianificando il server completo, la guida interna Noleggiare e configurare un server FiveM ti aiuta con la struttura di base.
FiveM chiama tecnicamente gli script risorse. Secondo la documentazione ufficiale di Cfx.re, la fxmanifest.lua descrive quali file, script e metadati appartengono a una risorsa. Controlla quindi sempre prima se la cartella estratta contiene un file manifest valido. Senza manifest, il server non può caricare correttamente la risorsa.
Controllare la struttura dello script
Una tipica risorsa FiveM ha questo aspetto:
mio_script/
├── fxmanifest.lua # File manifest
├── client.lua # Codice client
├── server.lua # Codice server
├── config.lua # Configurazione
└── html/ # NUI (interfaccia web)
È importante non caricare per errore una cartella di pacchetto aggiuntiva. Per esempio, resources/mio_script-main/mio_script/fxmanifest.lua sarebbe sbagliato se la risorsa deve trovarsi direttamente in resources/mio_script/fxmanifest.lua. Dopo l'estrazione, apri la cartella e controlla il livello in cui si trova fxmanifest.lua.
Installare lo script
- Scaricare lo script
- Estrarlo nella cartella
resources/ - Aggiungerlo in
server.cfg:
ensure mio_script
- Riavviare il server
Usa come nome della risorsa esattamente il nome della cartella o il nome indicato dal README. Molti errori nascono da grafie diverse, spazi nel nome della cartella o caratteri speciali. Sono consigliati nomi brevi con lettere minuscole, trattini o underscore.
Configurare gli script ESX
Gli script ESX dipendono dal fatto che la base ESX e le risorse aggiuntive necessarie vengano avviate prima. L'ordine preciso può variare in base alla versione di ESX e allo script, quindi vale la regola: controlla il README dello script e segui la documentazione del framework disponibile.
# Base ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# Jobs
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob
# Funzionalità
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property
Se uno script di lavoro richiede tabelle del database o item propri, importa il file SQL fornito prima del primo avvio produttivo. Prima fai un backup del database. Sui server roleplay esistenti, i file SQL possono sovrascrivere colonne, item o job se non sono adattati alla tua installazione.
Configurare gli script QBCore
Le risorse QBCore seguono un principio simile: prima il framework, poi le librerie condivise, quindi inventario, job, garage, telefono o HUD. Un esempio semplice:
ensure qb-core
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-garages
ensure qb-inventory
ensure qb-phone
Controlla con particolare attenzione file di configurazione come config.lua, shared/config.lua o file item specifici del framework. Alcuni script QBCore si aspettano voci in item, job, gang o permessi. Inserisci solo valori documentati dallo script. Se vuoi pianificare risorse, txAdmin e gestione del server in un contesto più ampio, leggi anche Noleggiare un server FiveM: configurare GTA RP, risorse e txAdmin 2025.
Rispettare l'ordine di avvio
L'ordine di avvio è importante:
- Framework per primo (ESX/QBCore)
- Dependencies (oxmysql, ecc.)
- Script di base (inventario, HUD)
- Script di lavoro
- Script cosmetici (emote, vestiti)
Metti le dependencies condivise il più possibile in un punto centrale e prima di tutte le risorse che ne dipendono. Se più script richiedono la stessa libreria, dovrebbe essere avviata una sola volta. Con una connessione al database, il driver del database deve essere in esecuzione prima che le risorse inviino query SQL.
Fonti gratuite per script
| Fonte | Descrizione |
|---|---|
| GitHub | Script open source |
| Forum cfx.re | Script della community |
| Overextended | Open source di alta qualità |
Scarica script solo da fonti che rendono verificabili codice, changelog o feedback della community. Con download sconosciuti dovresti prestare particolare attenzione a codice Lua offuscato, richieste HTTP inspiegabili, webhook esterni e token hardcoded. Installa nuove risorse prima su un'istanza di test o fuori dagli orari principali di gioco.
Controllare il risultato
Riavvia il server e osserva la console. Una risorsa caricata correttamente appare senza errori di manifest, dependency o SQL. In gioco controlla poi con precisione la funzione fornita dallo script: menu lavoro, interazione con l'inventario, marker, comando, finestra NUI o modifica del database. Testa con i ruoli e i permessi che useranno poi i giocatori reali.
Usa inoltre refresh e ensure mio_script nella console del server solo per test controllati. Per modifiche produttive, un riavvio pulito è spesso più significativo perché riproduce l'intero ordine di avvio.
Risoluzione dei problemi
SCRIPT ERROR
Controlla prima la riga nella console. Spesso manca una dependency, una variabile di config è impostata in modo errato oppure una funzione esportata viene chiamata prima dell'avvio della risorsa di destinazione. Confronta il messaggio di errore con il README dello script.
Errori SQL
Importa le tabelle o colonne fornite se lo script le richiede. Se le tabelle esistono già, non eseguire di nuovo SQL alla cieca. Crea un backup e adatta gli statement alla struttura del tuo database esistente.
Lo script non si carica
Controlla nome della cartella, voce ensure e fxmanifest.lua. Basta un refuso nel file manifest o una cartella annidata in modo errato perché la risorsa non si avvii.
La funzione non appare in gioco
Controlla permessi, job, item, coordinate e versione del framework. Molti script roleplay funzionano solo per determinati job o gruppi. Per questo non testare solo come admin, ma anche con un normale profilo giocatore.
Verifica, limiti e ritorno sicuro
La guida “Installare script per server FiveM – ESX e QBCore” vale per il tipo di server descritto nell'articolo e per lo stato delle versioni visibile al momento della verifica. Nomi dei menu, versioni disponibili, compatibilità di mod o plugin e risorse necessarie possono cambiare dopo gli aggiornamenti. Non trasferire quindi valori a un'altra versione di gioco, loader o server senza controllarli.
Prima di modificare mondo, salvataggio, configurazione o estensioni, crea un backup dei file interessati. Poi modifica solo un passaggio coerente alla volta e verificalo con la stessa versione client e server con cui vorrai giocare in seguito.
| Punto di controllo | Risultato atteso | Interruzione e ritorno |
|---|---|---|
| Avvio del server | Il server raggiunge lo stato operativo senza nuovi messaggi di errore. | In caso di errori di avvio, annulla la modifica e ripristina l'ultimo backup. |
| Test di connessione | Un account di test può connettersi tramite l'indirizzo mostrato nel pannello. | In caso di errori di versione o connessione, ricontrolla versione, porta e autorizzazioni. |
| Test funzionale | La funzione modificata lavora senza danneggiare dati esistenti del mondo o del gioco. | In caso di effetti collaterali, ferma il server e ripristina i file salvati. |
Un singolo test riuscito non è una garanzia di prestazioni o disponibilità. Dimensione del mondo, mod, plugin, numero di giocatori, percorso di rete e carico simultaneo possono cambiare il risultato. Documenta versione, modifica e risultato del test, così potrai ricostruire eventuali differenze successive.
FAQ
Devo riavviare il server dopo ogni script?
Per un test affidabile sì. Le singole risorse possono essere ricaricate dalla console, ma un riavvio completo mostra se l'ordine di avvio e tutte le dependencies sono davvero corretti.
Posso usare ESX e QBCore contemporaneamente?
Nella pratica dovresti scegliere un framework. Molti script sono costruiti chiaramente per ESX o QBCore e si aspettano eventi, tabelle e strutture di config diverse.
Cosa faccio se uno script non ha una fxmanifest.lua?
Allora potrebbe essere obsoleto, estratto in modo errato o non preparato per le strutture attuali delle risorse FiveM. Controlla la fonte e la documentazione prima di installarlo in produzione.
Dovrei testare gli script gratuiti direttamente sul server live?
Meglio di no. Testa prima le nuove risorse separatamente, salva file e database e controlla la console. Soprattutto sui server roleplay, script difettosi possono influenzare inventario, job o progressi dei giocatori.
Quanti script può usare un server FiveM?
Non esiste un numero generale sensato. Contano qualità degli script, dipendenze, carico del database, comportamento dei tick e numero di giocatori. Pianifica le risorse con attenzione e rimuovi con coerenza gli script inutilizzati.