Questa guida spiega come installare risorse (script) sul tuo server FiveM, configurare un database MySQL per framework come ESX o QBCore, e comprendere l'ordine di caricamento delle risorse. Se non hai ancora completato la configurazione iniziale del server, inizia prima con la Guida alla Configurazione del Server FiveM.

Installazione di Risorse e Script

I server FiveM vengono estesi con risorse (chiamate anche script). Le risorse aggiungono funzionalità come concessionari auto, lavori, elementi HUD, framework e altro.

Come Installare una Risorsa

1. Scarica la risorsa dalla sua fonte (GitHub, forum Cfx.re, Tebex, ecc.).
2. Estrai la cartella della risorsa dall'archivio ZIP se necessario.
3. Carica la cartella della risorsa nella directory resources/ del tuo server usando la scheda Files di GPanel o tramite SFTP.
4. Apri server.cfg e aggiungi una riga ensure per la risorsa:

# Add your custom resources
ensure my-new-resource

5. Riavvia il server da GPanel o TXAdmin per caricare la risorsa.

Manifesti delle Risorse

Ogni risorsa valida deve contenere un file manifesto. Le risorse moderne usano fxmanifest.lua, mentre quelle più vecchie usano __resource.lua. Se una cartella di risorsa scaricata non contiene nessuno di questi file, la risorsa non verrà caricata. Alcuni download annidano la cartella effettiva della risorsa all'interno di una cartella esterna — assicurati che la cartella che inserisci in resources/ sia quella che contiene il manifesto.

Ordine di Caricamento delle Risorse

Le risorse vengono caricate nell'ordine in cui appaiono in server.cfg. Se una risorsa dipende da un'altra (ad esempio, uno script di lavoro che dipende da un framework come ESX o QBCore), assicurati che la dipendenza sia elencata prima della risorsa che ne ha bisogno:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Organizzare le Risorse con Cartelle di Categoria

Puoi organizzare le risorse in sottocartelle all'interno della directory resources/. Usa la notazione con parentesi quadre in server.cfg per caricare un'intera cartella di categoria:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Questo carica ogni risorsa all'interno della sottocartella specificata. È un modo comodo per raggruppare script correlati senza elencarli uno per uno.

Caricamento a Caldo delle Risorse tramite TXAdmin

Non è sempre necessario un riavvio completo del server per caricare una nuova risorsa. TXAdmin può avviare, fermare e riavviare singole risorse dalla sua pagina Resources. Dopo aver caricato una nuova risorsa e aggiunto la sua riga ensure, puoi eseguire il seguente comando nella console live di TXAdmin:

refresh
ensure my-new-resource

Il comando refresh indica al server di riscansionare la directory resources/ alla ricerca di nuove voci.

Configurazione del Database (MySQL / MariaDB)

Molti framework e risorse FiveM (come ESX, QBCore o vRP) richiedono un database MySQL o MariaDB. Legion Hosting fornisce le credenziali del database con il tuo server.

Trovare le Credenziali del Database

1. In GPanel, vai alla scheda Databases.
2. Se non esiste ancora un database, clicca New Database per crearne uno.
3. Annota i seguenti dettagli:
   • Database Host (indirizzo e porta)
   • Database Name
   • Username
   • Password (clicca l'icona dell'occhio per visualizzarla)

Configurazione della Connessione al Database

I dettagli di connessione al database vengono impostati in server.cfg usando una stringa di connessione. Il formato esatto dipende dalla risorsa MySQL che stai utilizzando, ma il formato più comune è:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Sostituisci i segnaposto con le tue credenziali reali dalla scheda Databases. Per esempio:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Scegliere una Risorsa MySQL

Qualunque risorsa MySQL utilizzi, deve essere caricata in server.cfg prima di qualsiasi risorsa che ne dipende:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Nozioni di Base sui Framework

Un framework fornisce i sistemi di gameplay principali su cui si basano le altre risorse — cose come identità del giocatore, denaro, inventario, lavori e veicoli. I due framework FiveM più popolari sono:

La maggior parte dei framework viene installata tramite il sistema di recipe di TXAdmin durante la configurazione iniziale. Se hai scelto una recipe come "QBCore" o "ESX" durante la configurazione di TXAdmin, il framework e le sue dipendenze principali sono già installati. Se devi installare un framework manualmente, segui la sua documentazione ufficiale:

• Documentazione ESX
• Documentazione QBCore

Ottenere Aiuto

Se hai bisogno di assistenza con l'installazione delle risorse o la configurazione del database:

1. Controlla la documentazione della risorsa o la sua pagina GitHub per le istruzioni di installazione e i problemi noti.
2. Rivedi la console di GPanel o i log di TXAdmin per messaggi di errore.
3. Apri un ticket di supporto su https://legionhosting.net/submitticket.php con i tuoi messaggi di errore e il nome della risorsa che stai cercando di installare.

Articoli Correlati

• Guida alla Configurazione del Server FiveM
• Risoluzione dei Problemi di FiveM
• Come Caricare File tramite SFTP
• Come Trovare l'IP e la Porta del Tuo Server