Installazione e configurazione del modello del server FiveM

Benvenuto! Hai appena acquisito uno dei nostri modelli di server FiveM premium – una scelta fantastica per dare il via alla tua community con un'esperienza preconfigurata e ricca di funzionalità. Che tu sia un utente esperto di server o alle prime armi, questa guida completa ti guiderà passo dopo passo in ogni fase del download, dell'installazione e del lancio efficace del tuo modello di server.

If you’ve purchased a complete server package from us and are wondering “What next?”, you’re in the exact right place. We’ll turn that downloaded .zip file into a living, breathing Il server FiveM è pronto per i giocatori.

Perché scegliere un modello di server completo da FiveMX.com?

Before we dive in, let’s quickly recap why starting with a FiveMX template accelerates your journey:

• Risparmio di tempo: Costruire un server FiveM stabile da zero richiede innumerevoli ore di installazione di risorse, configurazione di script, debug di conflitti e impostazione di database. I nostri modelli raggruppano tutto questo lavoro, facendoti risparmiare potenzialmente settimane o addirittura mesi.

• Elementi essenziali preconfigurati: Includiamo e configuriamo framework essenziali (come ESX o QBCore, a seconda del modello), script essenziali (lavori, inventari, veicoli, basi anti-cheat), mappe ottimizzate e impostazioni principali.

• Stabilità testata: Ci impegniamo a garantire che le risorse incluse funzionino bene insieme, riducendo i problemi più comuni dovuti a conflitti di script e problemi di prestazioni riscontrabili nei server assemblati in modo casuale.

• Fondazione per la crescita: Pur essendo già pronti all'uso, i nostri modelli sono completamente personalizzabili. Ottieni una solida base su cui puoi facilmente aggiungere funzionalità, veicoli o script unici, specifici per la visione della tua comunità.

• Supporto dedicato: Non sei solo. FiveMX fornisce aggiornamenti costanti per i modelli acquistati e accesso ai nostri canali di supporto (come Discord) per la risoluzione dei problemi e per ricevere consigli.

Prima di iniziare: elenco dei prerequisiti

Assicurati di avere pronto quanto segue:

1. Il tuo modello di server FiveMX: Scaricato dal tuo account FiveMX.com.

2. Hosting server (vedi il nostro confronto): Un luogo in cui gestire il tuo server. Può essere:

   • VPS (Virtual Private Server) o Server Dedicato: Consigliato per server pubblici. Provider come Zap-Hosting (spesso partner di FiveM), OVH, Hetzner o Contabo sono scelte popolari. Assicuratevi che soddisfi le specifiche consigliate da FiveM (consultate la documentazione di Cfx.re per le raccomandazioni aggiornate).

   • PC Windows (host locale): Adatto per prove o per giocare con gli amici in zona, ma solitamente non è abbastanza potente o affidabile per una grande comunità pubblica.

3. Artefatti del server FiveM: Il nucleo File del server FiveM (per Windows). – Se acceso Linux, clicca qui

4. Software di database: MySQL o MariaDB (MariaDB è generalmente consigliato come sostituto di MySQL).

5. Strumento di gestione del database: HeidiSQL (gratuito, consigliato), phpMyAdmin (basato sul Web) o MySQL Workbench.

6. Editor di testo: Un buon editor di testo come Codice di Visual Studio (Free, Recommended), Notepad++, or Sublime Text. Avoid Windows Notepad as it can mess up file encodings.

7. Chiave di licenza FiveM: Ottenibile dal Keymaster FiveM

8. (Finestre) Visual C++ ridistribuibile: L'ultima versione è fondamentale. Scaricalo dal sito ufficiale di Microsoft.

Passaggio 1: download del modello del server

Questa è la parte più semplice!

1. Accedi a FiveMX.com: Accedi al tuo account sul nostro sito web.

2. Vai alla sezione Download: Trova la sezione “Il mio account” o “Download”.

3. Scarica il tuo acquisto: Locate the server template you bought and click the download button. It will arrive as a .zip archive. Save it somewhere easily accessible, like your Desktop or a dedicated “FiveM Server” folder.

Importante: i file del server che hai acquistato ti verranno inviati anche via email (link)!

Fase 2: Preparazione dell'ambiente del server

Questo passaggio è fondamentale per un'installazione senza intoppi. Non saltarlo!

1. Configura il tuo server FiveM base:

   • Download Artifacts: Go to the official FiveM documentation (docs.cfx.re) and find the link for the latest recommended server artifacts for your operating system (Windows or Linux). Download these.

   • Crea directory del server: Create a main folder for your server (e.g., C:FXServer or /home/user/FXServer).

   • Estrarre artefatti: Estrarre gli artefatti del server scaricati direttamente in questa cartella.

   • Create server-data Directory: Inside your main server directory, create a sub-folder named server-data. This is where your resources and configuration will live, keeping things organized and separate from the core server files. Our template files will go inside this server-data folder.

2. Installa il software del database (MySQL/MariaDB):

   • Perché? Server FiveM, in particolare server di gioco di ruolo che utilizzano framework come ESX o QBCore, si affidano in larga misura ai database per archiviare dati persistenti: account dei giocatori, informazioni sui personaggi, inventario, proprietà dei veicoli, stati aziendali, registri, ecc. Senza un database, nessuna di queste informazioni può essere salvata tra una sessione e l'altra.

   • Come?

     • Finestre: Download the MySQL Community Server installer or MariaDB installer from their official websites. Follow the installation wizard. During installation, securely note down the root password you set.

     • Linux (Debian/Ubuntu): Use the package manager: sudo apt update && sudo apt install mariadb-server. Run sudo mysql_secure_installation afterwards to set the root password and secure the installation.

     • Linux (CentOS/RHEL): Use the package manager: sudo yum update && sudo yum install mariadb-server. Start the service sudo systemctl start mariadb and enable it on boot sudo systemctl enable mariadb. Run sudo mysql_secure_installation.

   • Verifica: Ensure the database service is running (services.msc on Windows, sudo systemctl status mariadb on Linux).

3. Install Database Management Tool (HeidiSQL Recommended):

   • Perché? While you can manage MySQL/MariaDB via the command line, a graphical tool makes creating databases, importing data, and browsing tables much easier.

   • Come? Scarica HeidiSQL dal sito ufficiale e installalo. È leggero e intuitivo.

4. (Solo Windows) Installa Visual C++ Redistributable:

   • Perché? Many FiveM resources, and FiveM itself, rely on Microsoft’s Visual C++ libraries. Missing these is a very common cause of server startup failures or script errors.

   • Come? Scarica l'ultima versione x64 direttamente da Microsoft ed esegui il programma di installazione. Riavvia il computer se richiesto.

Passaggio 3: installazione del modello del server

Ora uniamo il modello scaricato con l'ambiente server preparato.

1. Estrarre i file modello:

   • Open the .zip file you downloaded from FiveMX.com.

   • Extract its entire contents directly into the server-data folder you created in Step 2.

   • Cruciale: Ensure the file structure is correct. You should see folders like resources and potentially files like server.cfg directly inside server-data, not nested within an extra folder named after the template (e.g., NOT server-data/MyTemplateName/resources, but server-data/resources).

2. Impostare il database:

   • Individuare il file SQL: Inside the extracted template files (likely within the main server-data directory or a dedicated _INSTALL folder), find the database file. It usually ends with .sql (e.g., database.sql, install.sql, esx_legacy.sql).

   • Apri HeidiSQL (o il tuo strumento): Avvia il tuo strumento di gestione del database.

   • Connetti al database: Crea una nuova sessione di connessione.

     • Hostname/IP: 127.0.0.1 (or localhost) if the database is on the same machine as HeidiSQL. If your database is hosted elsewhere, use its IP address.

     • User: root (or the specific user you created, though root is fine for local setups).

     • Password: la password impostata durante l'installazione di MySQL/MariaDB.

     • Port: Usually 3306.

     • Fare clic su "Apri" o "Connetti".

   • Creare il database:

     • Fare clic con il pulsante destro del mouse nel riquadro di sinistra (dove sono elencate le connessioni al server) oppure andare alla scheda "Query".

     • Execute the command: CREATE DATABASE IF NOT EXISTS your_database_name; (Replace your_database_name with a name you choose, e.g., fivemx_server. Ricordatevi questo nome!). Usa un nome descrittivo. Premi F9 o clicca sul pulsante "Esegui".

     • Aggiorna l'elenco dei database (F5). Dovresti vedere il tuo nuovo database vuoto.

   • Importa il file SQL:

     • Seleziona il database appena creato nel riquadro di sinistra per renderlo attivo.

     • Go to File -> Run SQL file….

     • Navigate to and select the .sql file from your template.

     • Fai clic su "Apri". HeidiSQL eseguirà tutti i comandi presenti nel file, creando le tabelle necessarie e potenzialmente inserendo i dati predefiniti richiesti dagli script del template. Questa operazione potrebbe richiedere da pochi secondi a un minuto, a seconda della complessità del template. Controlla l'output del log in basso per eventuali errori.

3. Configurare la connessione al database nei file del server:

   • Perché? Il tuo server FiveM deve sapere come connettersi al database appena configurato. Il modello include script che richiedono queste credenziali.

   • Trova la configurazione: The exact location varies between templates and frameworks (ESX, QBCore). Common places include:

     • Directly in server-data/server.cfg.

     • In a specific resource’s config file, like server-data/resources/[esx]/es_extended/config.lua or server-data/resources/[qb]/qb-core/config.lua.

     • Sometimes in a dedicated database connection script like ghmattimysql or oxmysql. Check the template’s documentation or server.cfg for start or ensure lines related to mysql async/oxmysql.

   • Modifica le impostazioni: Apri i file pertinenti con il tuo editor di testo (VS Code, Notepad++). Cerca righe simili a questa (la sintassi potrebbe variare leggermente tra Lua/JS/JSON):

     -- Example for ESX/QBCore style Lua configs
     Config.MySQLConnection = "mysql://root:YourPassword@127.0.0.1/your_database_name?charset=utf8mb4"
     -- or separate fields:
     set mysql_connection_string "server=127.0.0.1;database=your_database_name;userid=root;password=YourPassword;" -- Often found directly in server.cfg for older setups or specific resources
     -- or in JSON format for some resources:
     // { "host": "127.0.0.1", "user": "root", "password": "YourPassword", "database": "your_database_name" }

      

   • Aggiorna valori: Replace “YourPassword” with your actual database root password and “your_database_name” with the exact database name you created in HeidiSQL. Ensure the host (127.0.0.1 or localhost) and user (root) are correct.

   • Salvare i file. Controlla di aver aggiornato tutte le stringhe di connessione necessarie, se ce ne sono più di una.

4. Review and Configure server.cfg:

   • Open the server-data/server.cfg file with your text editor. This is the main configuration file for your FiveM server.

   • Impostazioni essenziali:

     • sv_licenseKey “your_license_key”: Replace “your_license_key” with the key you generated from the FiveM Keymaster. Questo è obbligatorio affinché il server sia elencato e funzioni correttamente.

     • sv_hostname “My Awesome FiveMX Server”: Change this to your desired server name as it will appear in the server list. Use colors and emojis if you like (using Codici di formattazione di FiveM).

     • sv_maxclients 48: Set the maximum player slots (ensure your license type supports this number – standard keys support up to 48, higher tiers via Patreon).

     • sv_projectDesc “A description of my server.”: Set a short description that appears in some server lists or details panels.

     • sets steam_webApiKey “YOUR_STEAM_API_KEY”: Richiesto per molti framework/script. Ottienine uno dal sito web di Steam Developer. Aggiungi questa riga se mancante e richiesta dal tuo framework.

     • ensure …: These lines load your resources. The FiveMX template should have these pre-configured. The order can sometimes matter, especially for frameworks (e.g., ensure es_extended before ESX addons). Don’t change the order unless you know what you’re doing or following specific instructions.

   • Controlla altre impostazioni: Look through the file for any other settings specific to the template (like locale, starting money, script-specific convars) and adjust as needed. Comments (# or — at the start of a line) often explain what settings do.

   • Save the server.cfg file.

Fatto per ora.

Passaggio 4: avvio del server

È il momento di metterlo online!

• Vai alla directory corretta: Open your server’s main directory (e.g., C:FXServer or /home/user/FXServer), the one containing the FXServer.exe or run.sh file, NON the server-data directory.

• Per gli utenti Windows:

  1. Find run.cmd or similar: Look for a batch file typically named run.cmd or sometimes start.bat. Often it will reference the server-data directory, like +exec server.cfg +set txAdminPort 40120.

  2. Doppio clic: Double-click the run.cmd (or equivalent) file.

  3. Finestra della console: Apparirà una finestra del prompt dei comandi (o più finestre, se si utilizza TxAdmin). Questa è la console del server. Osservatela attentamente!

• Per gli utenti Linux:

  1. Apri Terminale: Aprire una finestra del terminale nella directory principale del server.

  2. Rendi eseguibile (se necessario): Ensure the start script is executable: chmod +x run.sh.

  3. Esegui lo script: Execute the start script: ./run.sh +exec server.cfg. (The +exec server.cfg part might already be inside the run.sh script itself).

  4. Uscita console: L'output della console del server apparirà direttamente nel tuo terminale.

Verificare che il server sia in esecuzione:

• Guarda la console: Look for messages indicating resources are starting (often green text like Started resource MyResource).

• Controlla gli errori: Cercare criticamente ROSSO Messaggi di errore. Gli errori più comuni includono:

  • Authentication failure: Could not connect to database. (Check Step 3.3 – Database Credentials).

  • Could not find resource X. (Check if the resource folder exists in resources and the ensure X line in server.cfg matches the folder name exactly).

  • Script ERROR: … (Indicates a problem within a specific script’s code. May require debugging or checking for compatibility issues).

  • Errori relativi a dipendenze mancanti (come Visual C++ Redistributable su Windows).

• Messaggio di successo: Idealmente, dopo aver caricato tutte le risorse, dovresti visualizzare dei messaggi che indicano che il server è attivo, in ascolto su una porta e autenticato con i servizi FiveM.

• Connettiti nel gioco:

  1. Avvia FiveM sul tuo PC da gioco.

  2. Premere F8 per aprire la console client.

  3. Type connect 127.0.0.1:30120 (if running the server on the same machine you’re playing on) or connect YOUR_SERVER_IP:30120 (if the server is hosted elsewhere, use its public IP address). The default port is 30120 unless changed in your startup script or server.cfg.

  4. Se tutto è corretto, dovresti iniziare a connetterti al tuo server!

Passaggio 5: Personalizzazione di base (post-installazione)

Your server is running, but now you want to make it yours.

• Prima il backup! Before making major changes, stop the server and make a backup of your server-data folder and your database (use HeidiSQL’s export feature).

• Cambia loghi/schermate di caricamento: Look for resources related to visuals (e.g., loadingscreen, scoreboard) and check their html, css, js files or config.lua for customization options. Replace image files (like logo.png) with your own, keeping dimensions similar.

• Configura lavori/attività: Explore the configuration files (config.lua is common) within specific resource folders (e.g., resources/[jobs]/policejob/config.lua) to adjust job payouts, locations, required ranks, etc.

• Aggiungi/Rimuovi veicoli: To add custom vehicles, you typically place the vehicle resource folder into your resources directory and add ensure vehicle_resource_name to your server.cfg. Consult guides specific to adding vehicles. Removing is the reverse (delete folder, remove ensure line).

• Ottimizzazione dell'economia: Le configurazioni del framework (ESX/QBCore) spesso controllano il contante iniziale, gli intervalli di stipendio e i prezzi base degli articoli. Regolateli con attenzione.

Fase 6: Gestione e manutenzione del server

La gestione di un server è un processo continuo:

• Backup regolari: Seriously, automate this if possible. Back up your server-data folder (especially the resources subfolder and server.cfg) and your database (.sql dump) daily or at least several times a week. Store backups off-site if possible. Check out our dedicated backup tutorial [Link to your backup tutorial here]!

• Rimani aggiornato:

  • Artefatti FiveM: Periodically check the FiveM documentation for new recommended server builds and update your core server files (usually involves replacing the files outside server-data). Read changelogs first!

  • Aggiornamenti del modello FiveMX: Tieni d'occhio FiveMX.com per aggiornamenti al tuo modello specifico. Gli aggiornamenti potrebbero includere correzioni di bug, nuove funzionalità o miglioramenti della compatibilità. Segui attentamente le nostre istruzioni per l'aggiornamento.

  • Aggiornamenti sulle risorse: Individual script creators often update their resources on platforms like GitHub. Updating requires replacing the resource folder and checking for configuration changes. Be cautious, as updates can sometimes break things or conflict with other scripts.

• Prestazioni del monitor: Use server monitoring tools (like txAdmin included with FiveM, or resource monitors like htop on Linux / Task Manager on Windows) to check CPU/RAM usage. High usage might indicate poorly optimized scripts.

• Interagisci con la tua comunità: Ascolta il feedback dei giocatori per segnalazioni di bug e suggerimenti.

• Utilizza i canali di supporto: Se riscontri problemi relativi al modello FiveMX, non esitare a utilizzare il nostro Discord o i forum di supporto.

Risoluzione dei problemi comuni

I problemi capitano. Ecco come affrontarli:

1. Il server non si avvia / si blocca immediatamente:

   • Controlla la console: Scroll up in the server console window/log file. Look for the first error message. This often points to the root cause.

   • Check server.cfg: Errori di sintassi (virgolette mancanti, virgole), chiave di licenza errata.

   • Connessione al database: Controlla attentamente le credenziali nei file di configurazione (Passaggio 3.3). Assicurati che il servizio MySQL/MariaDB sia in esecuzione.

   • Dipendenze mancanti: (Windows) Reinstall Visual C++ Redistributable. Ensure all required base resources (like mysql-async or oxmysql, es_extended, qb-core) are present and started before dependent resources in server.cfg.

   • Conflitto portuale: Assicurati che nessun'altra applicazione stia utilizzando la porta 30120 (o qualsiasi altra porta da te configurata).

2. Impossibile connettersi / Connessione rifiutata:

   • Il server è in esecuzione? Controllare nuovamente la console per assicurarsi che il server si sia avviato senza errori critici.

   • Firewall: Ensure your server’s firewall (Windows Firewall, ufw on Linux, or your hosting provider’s firewall) allows incoming TCP and UDP traffic on port 30120 (and 30110 if using server list features, plus TxAdmin port if used e.g. 40120).

   • IP/porta corretti: Are you using the correct public IP address and port in the FiveM client? (Use 127.0.0.1 only if connecting from the same machine).

   • Blocco delle porte ISP: Alcuni ISP residenziali bloccano le porte comunemente utilizzate per l'hosting.

3. Risorse non caricate / Errori nel gioco:

   • Errori della console: Check the server console (F8 console in-game often shows client-side errors, but server console shows loading issues). Look for Could not find resource or Script ERROR related to specific resources.

   • ensure Name: Ensure the name in server.cfg (ensure resource_name) exactly matches the folder name in the resources directory (case-sensitive on Linux!).

   • Dipendenze: Did you forget to ensure a required resource before the one that’s erroring? (e.g., trying to use an ESX funzione prima di garantire es_extended).

   • Tabelle del database mancanti: If scripts complain about nil values or unknown tables, your database import might have failed, or the script expects tables that weren’t included. Check the script’s documentation.

• Hai bisogno di ulteriore aiuto? Consulta la nostra sezione dettagliata sulla risoluzione dei problemi.

Server installato: cosa succede adesso?

Congratulazioni! Hai installato e avviato con successo il tuo Server FiveM utilizzando un modello FiveMX. Le basi sono state gettate.

Ora inizia il vero divertimento: personalizzando i dettagli, invitando i giocatori, costruendo la tua community e creando esperienze uniche.

Ricorda che la proprietà del server è un processo di apprendimento. Non aver paura di sperimentare (con backup!), consultare la documentazione (di FiveM, specifica dello script e nostra) e interagire con le comunità più ampie di FiveM e FiveMX.