Puoi usare le risorse per aggiungere nuove funzionalità al tuo server di gioco FiveM. Sono particolarmente utili se hai in programma progetti più ampi, come un server roleplay o simili. È difficile realizzare progetti del genere senza queste risorse aggiuntive.
FiveM e la sua community offrono una vasta selezione di risorse. Trovi una panoramica delle risorse più popolari nel forum Cfx.re: https://forum.cfx.re/c/development/releases/7
Il modo più rapido per installare una risorsa è usare FiveM Resource Installer, direttamente dal dashboard. Carica l'archivio ZIP e l'installer posiziona la risorsa nella cartella corretta, la aggiunge a server.cfg e, se vuoi, importa nel tuo database i file SQL inclusi. Più avanti trovi il metodo tradizionale tramite SFTP.
Resource Installer è disponibile per i server FiveM. Per FiveM Enhanced e RedM, usa il metodo tramite SFTP.
Apri il dashboard del tuo server FiveM, vai alla scheda Strumenti e seleziona FiveM Resource Installer. Non è necessario arrestare il server.
Per poter usare l'installer, devi prima aver configurato un modello server (Recipe) in txAdmin. Solo in questo modo saranno disponibili server.cfg e la cartella resources in cui l'installer può inserire i file.
Carica la risorsa come archivio ZIP. Puoi usare direttamente un download da GitHub tramite Code → Download ZIP oppure un file ZIP di una release.
- Sono consentiti file ZIP fino a 100 MB (massimo 400 MB e 5.000 file una volta estratti).
- Prima, ricomprimi gli archivi RAR e 7z in formato ZIP.
- L'installer rimuove le cartelle intermedie superflue (ad es.
meine-resource-main) e toglie dal nome le indicazioni della versione e il suffisso-main. - Se un archivio contiene più risorse, l'installer le mostra singolarmente e le ordina in base alle rispettive dipendenze.
- I file eseguibili come
.exe,.bato.shnon vengono mai caricati sul tuo server.
Prima dell'installazione, l'installer ti mostra il contenuto dell'archivio:
- Nome e cartella di destinazione: il nome può contenere lettere, numeri e i caratteri
_,.e-(massimo 64 caratteri). In Cartella in resources/ scegli la cartella di categoria, ad esempio[standalone]. Se l'archivio non ne contiene una, viene selezionata[local]per impostazione predefinita. Con Direttamente in resources/ (senza cartella), la risorsa viene inserita senza una cartella di categoria. - Dipendenze: per ogni dipendenza (ad es. ESX, QBCore, Qbox, ox_lib, oxmysql), puoi vedere se è inclusa nell'archivio, se è già presente sul server o se manca. Le dipendenze rilevate solo nel codice e non dichiarate in
fxmanifest.luavengono contrassegnate come presunte. - Controllo di sicurezza: l'installer controlla tutti i file
.luae.jsper individuare schemi di codice dannoso noti. Se ne trova uno, ti avvisa. Puoi comunque procedere con l'installazione, ma al successivo avvio del server il controllo di sicurezza disattiverà la risorsa. Se pensi che si tratti di un falso positivo, contatta il nostro supporto. - File SQL: vengono mostrati i file
.sqlinclusi, con un'indicazione delle tabelle che creano, modificano o riempiono.
Se la risorsa è già presente sul tuo server, l'installer si interrompe per impostazione predefinita. Se vuoi sostituirla (ad es. per installare un aggiornamento), seleziona Sovrascrivi la resource esistente. L'intera cartella verrà sostituita, comprese le tue impostazioni come config.lua. Prima, la vecchia cartella viene salvata come archivio in backups/resource-installer/.
Lascia selezionata l'opzione Aggiungi alla server.cfg per avviarla automaticamente. L'installer aggiunge quindi ensure <Name> a server.cfg nella cartella attiva del server, dopo le dipendenze della risorsa, e prima salva una copia della vecchia configurazione come server.cfg.bak-….
Fai clic su Installa sul server. Puoi seguire i progressi (backup, estrazione, posizionamento dei file, aggiunta a server.cfg, verifica del risultato). L'installazione prosegue anche se chiudi la pagina.
Nel risultato puoi vedere come viene avviata la risorsa:
- Riga ensure aggiunta alla server.cfg: è tutto pronto.
- già presente nella server.cfg: la riga era già presente.
- si avvia tramite la cartella della categoria:
ensure [Categoria]è già presente inserver.cfge avvia anche questa risorsa. - Riga ensure ancora mancante: aggiungi manualmente
ensure <Name>aserver.cfg(vedi Attivazione).
Per fare in modo che FiveM carichi la nuova risorsa, riavvia il server con Riavvia server. In alternativa, inserisci refresh nella console live e poi ensure <Name>.
Se la risorsa richiede un database, puoi importare il file SQL direttamente dall'installer. L'importazione non avviene automaticamente: per avviarla, fai clic su Importa nel database accanto al file desiderato.
- Seleziona il database del tuo server. Per impostazione predefinita, è selezionato il database principale. Se il tuo server non ha ancora un database, creane uno con Crea database nella scheda Database.
- Se il file contiene tabelle già esistenti, la finestra di dialogo te lo segnala. In tal caso, lascia selezionata l'opzione Salta le tabelle esistenti (consigliato), così le tabelle e i dati già presenti rimarranno invariati.
- Se hai un ZapX Pass attivo, prima dell'importazione viene creato automaticamente un backup del database. Senza Pass, conferma Importo senza backup.
- Fai clic su Importa ora.
Ogni file può contenere fino a 2 MB e 5.000 istruzioni SQL. Per importare file più grandi, segui le istruzioni in FiveM: importare un file SQL e usa phpMyAdmin.
L'importazione viene sempre eseguita nel database selezionato. Per questo motivo, non sono consentite righe come CREATE DATABASE … o USE …. Se il file contiene una di queste righe, non verrà importato. Rimuovi le righe, ricomprimi il file ZIP e caricalo di nuovo.
| Messaggio o problema | Soluzione |
|---|---|
| Gli archivi RAR e 7z non sono supportati | Estrai l'archivio e ricomprimi la cartella in formato ZIP. |
| Questo archivio non può essere installato | Controlla il nome e la cartella di destinazione. Se esiste una risorsa con lo stesso nome in un'altra cartella, rinomina quella nuova o rimuovi quella esistente. Se l'archivio non contiene fxmanifest.lua (o __resource.lua), non si tratta di una risorsa, ma ad esempio solo di una mappa o di un veicolo. |
| Manca una dipendenza sul server | Installa prima la risorsa mancante (ad es. ox_lib), usando anche in questo caso l'installer. Senza di essa, la risorsa di solito non si avvia. |
| Avviso di Recipe o modello server mancante | Configura prima un modello server in txAdmin, poi apri di nuovo l'installer. |
| Su questo server è già in corso un'installazione | Attendi il completamento dell'installazione in corso. Continuerà a essere mostrata nella pagina. |
| L'installazione è stata interrotta o non è riuscita | Controlla il server e avvia di nuovo l'installazione. Se hai sovrascritto una risorsa esistente, in caso di errore l'installer ripristina la vecchia cartella. |
| SQL: USE non è consentito o Non è consentito creare, modificare o eliminare database | Rimuovi le righe USE e CREATE DATABASE dal file SQL e carica di nuovo lo ZIP. |
| SQL: Errore alla riga … | Le istruzioni fino a quella riga sono già state eseguite. Correggi il file e avvia di nuovo l'importazione selezionando Salta le tabelle esistenti. |
| La risorsa non si avvia dopo il riavvio | Controlla il messaggio di errore nella console live, verifica che tutte le dipendenze siano avviate e che la riga ensure si trovi dopo le dipendenze. Per ricevere aiuto sui problemi più comuni, consulta FiveM: problemi comuni. |
Vuoi controllare un archivio senza installarlo? Il nostro strumento gratuito FiveM Resource Installer lo analizza direttamente nel browser, senza caricare nulla.
Fonte preferita su Google
