Come installare qbCore su un server FiveM

Come installare qbCore su un server FiveM

Quando sei pronto a dare vita al tuo server di gioco di ruolo FiveM, scegliere il framework giusto è essenziale. qbCore è diventato uno dei preferiti dalla community perché semplifica la configurazione, viene costantemente aggiornato e offre una ricca libreria di script gratuiti per aumentare l'immersione. In questa guida troverai un percorso chiaro e dettagliato per un'installazione fluida di qbCore.

Panoramica di qbCore

qbCore è un framework open source semplificato, creato appositamente per FiveM. Estende le funzionalità di base del server con script RP facili da implementare, un'architettura modulare e solidi strumenti di amministrazione. Che tu sia un operatore alle prime armi o esperto, qbCore riduce i problemi di configurazione e ti consente di concentrarti sul gameplay.

Installazione di qbcore: guida passo passo

1. Prerequisiti

Prima di iniziare, assicurati di avere:
– Un server FiveM funzionale – se ne manca uno, usa il nostro tutorial di avvio rapido.
– Conoscenza di base dell'amministrazione del server – possibilità di modificare i file di configurazione e riavviare i servizi.
– Accesso alla cartella `resources/` del tuo server – solitamente situato nella directory principale del server.
– Un editor di testo normale come Notepad++ per modificare i file Lua.

Queste sono le uniche condizioni di cui hai bisogno; qbCore in sé non richiede alcun software speciale.

2. Scarica qbCore

Vai al repository ufficiale su GitHub: `https://github.com/qbcore-framework`.
Clic Codice → Scarica ZIP per acquistare l'ultima versione.
Una volta completato il download, decomprimi la cartella in una posizione temporanea sul tuo computer.
Non è necessario un account GitHub, ma effettuare l'accesso può aiutarti a rimanere aggiornato sulle nuove versioni.

3. Trasferisci qbCore in Risorse

Apri la cartella delle risorse FiveM.
Trascina la cartella `qb-core` estratta in questa directory e lasciala intatta: non aprirai mai più lo ZIP compresso.

4. Configurare qbCore

Vai a `qb-core/qb-core/config.lua`.
Fai clic con il tasto destro del mouse e aprilo con il tuo editor preferito.
Qui potrai:
– Imposta il database: incolla la stringa di connessione in `Config.Database`.
– Regola l'identità del server: modifica i valori `Config.ServerName` e `Config.Webhook` in modo che corrispondano al tuo marchio.
– Scegli i moduli: attiva/disattiva le sezioni per abilitare o disabilitare funzionalità come i sistemi di lavoro o le officine.
Per orientamento, prendere nota dei commenti nel file.
Dopo aver terminato, salva e chiudi il file.

5. Abilita qbCore nella configurazione del server

Aprire `server.cfg` situato accanto a `resources/`.
Aggiungere la seguente riga in fondo:
“`
garantire qb-core
“`
Questo indica a FiveM di caricare la risorsa qb-core durante l'avvio.
Salvare e chiudere il file.

6. Riavviare il server

Riavvia correttamente il tuo servizio FiveM, dal pannello di controllo dell'hosting o eseguendo `exit` nel prompt dei comandi.
Un riavvio pulito chiude le connessioni aperte, cancella la memoria e garantisce che la risorsa qb-core appena aggiunta sia completamente inizializzata.

7. Verificare l'installazione

Connettiti a il tuo server con il cliente FiveM.
Aprire la console (F8) e digitare i comandi `qb_`; l'elenco dei comandi visualizzato dimostra che qbCore è attivo.
Dovresti anche vedere un messaggio "qbCore boot" nel registro del server.

Se tutto viene caricato senza errori, l'installazione di qbcore è stata completata correttamente.

Aggiungere altri script

La natura modulare di qbCore significa che puoi trascinare cartelle di script aggiuntive in `resources/` e semplicemente `ensure` in `server.cfg`.
Le scelte più comuni includono:

– lavori – script di lavoro predefiniti per carriere nella polizia, nei servizi di emergenza medica o nella criminalità.
– negozi – negozi cittadini di armi, automobili e cosmetici.
– veicoli – elenchi di veicoli personalizzati e sistemi di garage.
Tutto scripts are freely available from the qbCore GitHub or community forums.

Esempio: aggiunta di un lavoro semplice

Scarica uno script di lavoro in formato zip, decomprimilo e sposta la cartella in `resources/`.
Aggiungere `ensure myjob` a `server.cfg`.
Riavvia, quindi usa `setplayerjob myjob` per testare.

Domande frequenti

D: Qbcore è migliore di ESX?
R: Entrambi i framework vantano community solide. qbCore si distingue per il suo moderno stile di programmazione Lua e un utilizzo più leggero delle risorse, mentre ESX offre una base stabile con decenni di esperienza. La decisione dipende solitamente dalle preferenze personali e dalle funzionalità richieste.

D: Dove posso trovare script qbcore gratuiti?
R: Visita portali popolari come Cfx.re, HiFiveM e Tebex. Cerca "qbcore" per trovare componenti aggiuntivi compatibili.

D: qbCore è gratuito?
R: Assolutamente sì. L'intero framework è open source con licenza MIT, quindi è possibile modificarlo e ospitarlo gratuitamente.

Considerazioni finali: il tuo percorso di installazione di qbcore

Completare un'installazione di qbcore apre le porte a infinite possibilità di gioco di ruolo. La configurazione intuitiva del framework, unita al supporto attivo della community, consente di concentrarsi sulla creazione di esperienze uniche piuttosto che lottare con codice server di basso livello.

Seguendo questi passaggi, avrai creato una solida base che si evolverà insieme al tuo server. Con l'arrivo di nuovi script e aggiornamenti, ti sarà facile ampliare il tuo ambiente, coinvolgere i giocatori e gestire la tua community in modo efficace.

Ora è il momento di immergersi, esplorare le funzionalità di qbCore e dare forma a un server FiveM che dia vita alla tua visione. Buona fortuna e goditi ogni momento del processo creativo.