SFTP (SSH File Transfer Protocol) è un protocollo di rete crittografato per il trasferimento di file tramite una connessione SSH. Ti consente di scambiare file in modo sicuro tra il tuo PC e il tuo server di gioco. Con SFTP puoi accedere ai file del server e gestirli, sia che tu voglia caricarli o scaricarli, sia che tu voglia modificarli direttamente.
I server di gioco ZapX consentono l'accesso esclusivamente tramite SFTP. Il classico FTP non crittografato non è supportato.
Per accedere tramite SFTP, ti serve un client SFTP compatibile. Esistono molti client, ma due dei più conosciuti e consolidati sono FileZilla e WinSCP.
| Client SFTP | Download |
|---|---|
| FileZilla | Sito ufficiale |
| WinSCP | Sito ufficiale |
Con FiveM usi SFTP soprattutto per le tue risorse, il server.cfg e i dati di txAdmin. Connessione e credenziali funzionano esattamente come descritto sopra. Anche se spesso si parla di "FiveM FTP": con ZapX ti connetti sempre via SFTP.
Dopo l'accesso, i file di FiveM si trovano nella cartella fivem e, al suo interno, nella cartella della tua variante, ad esempio fivem/standard. Lì trovi:
| Cartella / file | Contenuto |
|---|---|
<Nome>_<Codice>.base (es. Qbox_E99E54.base) | La cartella del server che txAdmin crea durante la configurazione con una ricetta (recipe). Contiene il server.cfg e la cartella resources. |
default | Il profilo di txAdmin con le impostazioni (config.json), i dati e i log |
admins.json | Gli account amministratore di txAdmin |
server-data | Un'altra cartella del server con un proprio server.cfg e una propria cartella resources |
artifacts | I file del server FiveM (FXServer). Qui non devi modificare nulla. |
Su ZapX non esiste una cartella txData separata. I dati di txAdmin si trovano direttamente in questa cartella della variante.
Per vedere quale cartella del server è attiva, apri txAdmin e vai su Settings → FXServer, campo Server Data Folder. Le modifiche a un server.cfg in un'altra cartella non hanno alcun effetto.
- Estrai la risorsa scaricata sul tuo PC. Il file
fxmanifest.lua(__resource.luaper le risorse più vecchie) deve trovarsi direttamente nella cartella della risorsa. - Arresta il server.
- Carica la cartella via SFTP nella cartella
resourcesdella tua cartella del server attiva. - Aggiungi la risorsa al
server.cfgconstart <nomecartella>e avvia il server.
Trovi maggiori dettagli nella guida FiveM: Installazione delle Risorse.
- Arresta il server prima di modificare il
server.cfg, i file nella cartelladefaulto il fileadmins.json. Il server e txAdmin scrivono in questi file, quindi le modifiche fatte a server avviato possono essere sovrascritte. - Scarica prima una copia del file, così puoi tornare allo stato precedente in caso di errore.
- Le modifiche più piccole al
server.cfgpuoi farle anche direttamente nel CFG Editor di txAdmin.
Con FiveM la cartella che cresce di più è cache nella cartella del server (<Nome>_<Codice>.base/cache). Puoi eliminarla a server arrestato, FiveM la ricrea all'avvio successivo. Puoi rimuovere anche i vecchi file di log in default/logs. Lascia invariati la cartella artifacts e gli altri file di txAdmin.
Controlla che il nome della cartella corrisponda esattamente a quello del comando start (maiuscole e minuscole contano) e che il fxmanifest.lua si trovi direttamente nella cartella e non in una sottocartella. Trovi altri problemi in FiveM: problemi comuni.
