Come installare un server QBCore: ricetta txAdmin e passaggi manuali

Vuoi un server QBCore e stai scegliendo tra la ricetta e un'installazione manuale. Questa guida copre entrambi, il server.cfg di cui hai bisogno, cosa controllare al tuo primo avvio, e gli errori che si mostrano su quasi ogni primo server QBCore.

#Opzione 1: la ricetta txAdmin

La ricetta è il modo consigliato. Nella configurazione di txAdmin, scegli il modello QBCore dalle ricette popolari, come descritto in txAdmin setup and recipes. Inserisci la tua chiave di licenza e i dettagli del database, txAdmin scarica tutto, crea il database e scrive server.cfg. Rivedi quel file, avvia il server, e passa ai controlli iniziali di seguito.

#Opzione 2: installazione manuale

Usa questo se hai già un server e vuoi aggiungere QBCore. Hai bisogno di FXServer, un database MySQL o MariaDB e una chiave di licenza.

#1. Ottieni le risorse

QBCore non è una singola risorsa. Hai bisogno:

• qb-core, il framework stesso.
• Le risorse qb intorno: inventario, multicharacter, selettore di spawn, lavori, telefono e così via. Di solito sono raggruppate in una cartella come [qb].
• oxmysql per il database e ox_lib, di cui molte risorse attuali dipendono.
• Risorse standalone come una risorsa vocale (vedi pma-voice not working) e qualsiasi pack di mappe o veicoli.

Copiale nella cartella resources, ad esempio resources/[qb] e resources/[standalone].

#2. Crea il database e importa l'SQL

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Importa il file SQL che viene con l'installazione QBCore (il repository delle ricette fornisce uno con le tabelle di base) e poi l'SQL di ogni risorsa che ha il suo file. Se uno script in seguito dice che una tabella è mancante, vedi SQL table doesn't exist.

#3. Modifica server.cfg

set mysql_connection_string "mysql://user:password@localhost/qbcore?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]

add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.god

Sostituisci YOUR_LICENSE_HERE con il tuo identificatore di licenza FiveM. Lo trovi nell'elenco dei giocatori di txAdmin o nella console del server quando ti unisci. Le righe ACE sono coperte in ACE permissions.

Consiglio: ensure [qb] avvia ogni risorsa dentro quella cartella. Mantieni qb-core stesso al di fuori, come nell'esempio, o viene ensured due volte. Vedi server.cfg ensure order.

#Controlli iniziali

Avvia il server e leggi la console prima di unirti:

1. oxmysql si connette al database senza un errore.
2. qb-core si avvia. Se non lo fa, ogni altra risorsa qb fallisce dopo.
3. Nessun errore rosso dalle risorse in [qb]. Alcuni avvisi sono normali; errori ripetuti no.
4. Puoi unirti, ottieni la selezione dei personaggi, crea un personaggio e fai spawn.
5. Una riga viene creata nella tabella players per il tuo personaggio.

Se non puoi unirti o rimani sulla schermata di caricamento, leggi players stuck on the loading screen.

#Errori comuni del primo

QBCore è nil. Uno script che usa un vecchio metodo per ottenere l'oggetto core fallisce con:

attempt to index a nil value (global 'QBCore')

Usa local QBCore = exports['qb-core']:GetCoreObject() in cima a ogni file. La spiegazione completa è in QBCore nil: the GetCoreObject fix.

qb-core non si è avviato. Altre risorse quindi segnalano:

No such export GetCoreObject in resource qb-core

Guarda in cima alla console per il primo errore di qb-core stesso, che di solito è il database. Vedi oxmysql connection error.

La risorsa non si avvia. Problemi di dipendenza mancante o nome di cartella: could not find dependency, couldn't start resource.

Non sei admin. Il tuo identificatore in server.cfg non corrisponde al tuo, o non hai riavviato dopo averlo modificato.

#Passaggi successivi

Quando la base è stabile, i soliti primi compiti sono aggiungere lavori e articoli. Vedi QBCore add job e qb-inventory add items. Se prevedi di eseguire lo stack più recente in seguito, leggi prima install QBox, perché lo stack differisce.

#Elenco di controllo