Setup e ricette di txAdmin: distribuisci un server FiveM passo dopo passo

Hai scaricato i server artifacts di FiveM, li hai avviati, e ora txAdmin ti chiede un PIN, un account e un template. Questa guida ti guida attraverso il primo avvio, il collegamento del tuo account Cfx.re, la scelta di una ricetta e cosa accade durante il deploy.

#Primo avvio e il PIN

Su Windows, esegui FXServer.exe. Su Linux, avvia run.sh dai artifacts. Il primo avvio stampa un URL di txAdmin e un PIN monouso nella console. Apri l'URL nel tuo browser e inserisci il PIN. Solo la persona che può leggere la console del server può farlo, che è il punto.

Il PIN funziona una sola volta. Se lo perdi, ferma il server e riavvialo per ottenerne uno nuovo, finché non hai terminato la configurazione dell'account. Se l'hai già fatto e hai dimenticato il tuo login, vedi txAdmin password dimenticata.

#Collega il tuo account Cfx.re

txAdmin ti chiede di creare un account master. Lo colleghi al tuo account Cfx.re, che è lo stesso account che usi nel forum FiveM e nel Portale Cfx.re. Accedi con Cfx.re quando chiesto, quindi scegli una password di backup per l'account in modo che tu possa ancora accedere se il login Cfx.re è inattivo.

Mantieni quella password da qualche parte al sicuro. Aggiungerai altri admin più tardi dalla pagina di amministrazione di txAdmin, ognuno con i suoi permessi.

#Nome del server e tipo di deploy

La procedura guidata di configurazione chiede un nome di server, quindi il tipo di deploy. La formulazione cambia tra le versioni di txAdmin, ma vedrai scelte lungo queste linee:

• Ricette popolari: template già pronti, inclusi ESX Legacy, QBCore e QBox.
• Template URL remoto: una ricetta che incolla da un link, ad esempio una dal proprio repository del framework.
• Template locale o ricetta personalizzata: il tuo file di ricetta.
• Dati del server esistente: hai già una cartella di dati del server con un server.cfg e vuoi che txAdmin la esegua.

Se questo è un nuovo server, scegli una ricetta popolare. I framework aggiornano le loro ricette, quindi ottieni una configurazione attuale senza ricerca di link di download.

#Scelta di un template

Non sei sicuro? Leggi install ESX Legacy, install QBCore e install QBox prima di scegliere, perché spostare i framework in seguito significa convertire i tuoi dati.

#Cartella e parametri della ricetta

Dopo che hai scelto una ricetta, txAdmin mostra la cartella dei dati del server. È dove il deploy mette server.cfg e la cartella resources. Tienila fuori dalla cartella degli artifacts, in modo da poter aggiornare gli artifacts senza toccare i tuoi dati (vedi aggiorna gli server artifacts di FiveM).

Poi viene un modulo con i parametri della ricetta. Campi tipici:

• Chiave di licenza Cfx.re: la chiave di cui il tuo server ha bisogno per avviarsi. Generala nel Portale Cfx.re. Se ricevi un errore al riguardo, leggi l'errore della chiave di licenza del server.
• Impostazioni del database: host, utente, password e nome del database.
• Max giocatori, nome del server e altre opzioni che la ricetta offre.

Attenzione: la chiave di licenza è privata. Non postare server.cfg negli screenshot o nei messaggi Discord senza nasconderla.

#Credenziali del database durante il deploy

I framework mantengono giocatori, denaro, veicoli e altro in un database MySQL o MariaDB. La ricetta ha bisogno di accedere per creare le sue tabelle. Hai due soliti setup:

1. Un server di database che già esegui (un MariaDB locale, XAMPP, o uno dal tuo host). Inserisci il suo host, utente e password. L'utente ha bisogno del permesso di creare un database.
2. I valori di forma predefiniti di txAdmin, che si adattano a una configurazione locale in cui il database viene eseguito sulla stessa macchina.

Il deploy costruisce la stringa di connessione per te, quindi non hai bisogno di scriverla a mano. In server.cfg la troverai come:

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

Se il server dice successivamente che non può connettersi, la correzione è in errore di connessione oxmysql.

#Quello che la ricetta fa effettivamente

Una ricetta è una lista di compiti che txAdmin esegue in ordine. In termini semplici:

1. Scarica risorse: il framework, le sue risorse, oxmysql e altre dipendenze, di solito come file ZIP da GitHub.
2. Estrae e sposta nella cartella resources.
3. Crea il database e importa il file SQL del framework, usando le credenziali che hai inserito.
4. Scrive server.cfg: il nome del tuo server, la chiave di licenza, la stringa di connessione, le righe ensure e le permessi.

Quando il deploy termina, txAdmin ti mostra il server.cfg generato per la revisione. Questo è il momento giusto per leggerlo riga per riga: vedi server.cfg spiegato. Puoi modificarlo, quindi salvare e avviare il server.

#Dopo il deploy

Avvia il server dal dashboard di txAdmin e guarda la console. Un inizio salutare termina con le risorse elencate come avviate e nessun errore rosso. Quindi connettiti con FiveM e controlla che raggiungi la schermata dei personaggi o lo spawn.

Se una risorsa fallisce, couldn't start resource e lettura di un errore di script coprono cosa significano i messaggi. Per i tuoi diritti di amministratore nel gioco, vedi ACE permissions.

Suggerimento: fai una copia della cartella dei dati del server e un'esportazione del database subito dopo un deploy pulito. Se rompi qualcosa durante la sperimentazione, puoi tornare a uno stato noto e buono. La guida di backup mostra come.

#Checklist